Addon:Graphical Reports

From Gramps
Revision as of 22:56, 19 March 2022 by CallMeDave (talk | contribs) (All reports: Merge all support option tab into one page and delete those pages - Seeing as addon was merged in to Gramps proper in the past)
Jump to: navigation, search

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager

All sample reports

that are shown are created using Gramps data.gramps file and I0024 Smith, Gustaf Sr. as the center person/family.

No longer available

Merged into Gramps 3.3+ as the Graphical Reports

The Graphical Reports addon creates charts for the active person. The following three similar reports are available:


Select the report you want to use from the menu option Reports -> Graphical Reports -> XXXXX...

Tree examples

Ancestoral Report

This report contains extensions to the builtin Ancestor Tree report that is available. The updates are:

  1. Able to print empty boxes where missing ancestors are
  2. can print spouses of the center person
  3. two separate displays (for fathers and mothers), and a display for marriage information (in a separate box).
  4. You can choose the display that Fathers, Mothers, the Center person and his/her spouses use

Personal Descendant Report

Sample Personal Descendant chart

This report is an extension to the current Descendant Report that is available. The updates are:

  1. Able to start with the selected persons parents first
    1. This will also show all siblings of the selected person
  2. level of spouses that you wish to see
    • 0 - Do not show spouses
    • 1 - Show spouses of the direct descendants
    • 2 - Show spouses of those spouses
    • 3 - etc
  3. able to compress the tree
  4. two separate displays (one for direct descendants and the other for spouses), and a display for marriage information (in a separate box).
  5. able to bold direct descendants
  6. and able to replace text within the report.

the Sample Personal Descendant chart that is shows was ran with the 'start with the selected persons parents first' option. Without this option the left column (Gustaf's parents) will not be there and Gustaf's two siblings (Magnes and Emil) on the next column will not print.

Familial Descendant Report

Sample Familiar Descendant chart

This report is an extension to the Personal Descendant Report in that it is ran off of a family. As such it can have two sets of grandparents.

In the example given (picture to the right), Mom (shown with the bottom arrow) does not have any parents in the database. If she did, they would be displayed to the left of her and all brothers and sisters would be below her.

The Sample Familial Descendant chart that is shows was ran with the 'start with the selected persons parents first' option. If Gustaf's wife had parents within the database, they would be shown to the right of her, and any siblings would be displayed below her.


These reports share most the following option tabs unless stated otherwise:

Tree Options tab

The Tree Options tab contains the main options on how many columns of people will be shown

This is always the starting place of any report.

The main item of interest is the Center Person/Family.
Both the Ancestoral and Personal Descendant reports ask for a center person.
The Familial Descendant report asks for a center family
How many generations (columns) will be shown on the report.
Level of Spouses
Only available in the Descendant reports. Whether to show:
0 - No spouses, only direct descendants
1 - Spouses of the direct descendants
2 - Spouses of those spouses
3 - etc
Print Entire tree
Only available in the Ancestoral report. Fills out the entire tree. If a grand-parent is unknown, print an empty box.
Compress tree
Tries to compress the tree to minimize printing space.
Show spouses of the center person
Only available in the Ancestoral report. Displays information about the spouses below the center person. Also allows you to select which display (main/secondary) to use.

Tree Display Tab

The Tree Display tab shows the main display that will be used

This is main (primary) display that will be used within the report.

Personal Display Format
For the Descendant reports. This will be used for all direct descendants and main parents of the selected person/family. Or to better describe it, all Non spouses.
Main Display Format
For the Ancestoral report. The center person will always use this display. Everyone else (spouses of the center person, (grand)-fathers, (grand)-mothers) can choose.

Compress Personal and Spousal Display formats
For the Descendant reports. If a line has variables on it (ie. 'b. $b $B') and ALL of the variables have nothing to print, then remove the entire line. This option can help 'compress tree' option on the 'Tree Options' tab.
Compress Main and Secondary Display formats
For the Ancestoral report. This is the exact same as above.

Use Main/Secondary Display Format for
For the Ancestoral report. This specifies whether (grand)-fathers and (grand)-mothers will use the Main Display only, or which half will use the Main while the other half will use the Secondary.
Bold Direct descendants
For the Descendant reports. Bold those people that are direct descendants of the center person/family. This will NOT bold half or step persons.

  1. The Secondary [display] tab shows secondary display that can/will be used

  1. The same print features

  1. Better Graphical_Substitution
    1. '{' and '}' now encapsulate areas that can be removed if all variables within are unknown
    2. '-' at the start of a line will remove the line if all variables on the line are unknown
    3. a better Graphical_Substitution is very close to complete (documentation only now).
  2. Missing (unknown) information can now either display nothing or '_____'
  3. The option to include a personalized Note to the report.
    1. You can print the date by using '$T' in the note.

The Replace tab

  • Note that this tab is only available in the Descendant reports.

Since all of the columns are the same width, the single longest line within the report dictates the entire width of the report. As such, I have added this feature to help replace long lines with something smaller. Examples of use are:

Heard Island and McDonald Islands/HMD
Democratic People's Republic of Korea/PRK
South Georgia and the South Sandwich Islands/SGS
The Democratic Republic of Congo/COD
United States of America/USA

This also works great on removing/abbreviating long town, county, or state names.

The Notes tab

This tab helps you to display a personalized note somewhere on the report. The options are whether to print a note, what to print, and where to print in (corners only at this time). The '$T' variable will now print the date.