Addon:Graphical Reports
This is a Third-party Addon. 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 |
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:
Contents
Usage
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:
- Able to print empty boxes where missing ancestors are
- can print spouses of the center person
- two separate displays (for fathers and mothers), and a display for marriage information (in a separate box).
- You can choose the display that Fathers, Mothers, the Center person and his/her spouses use
Personal Descendant Report
This report is an extension to the current Descendant Report that is available. The updates are:
- Able to start with the selected persons parents first
- This will also show all siblings of the selected person
- 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
- able to compress the tree
- two separate displays (one for direct descendants and the other for spouses), and a display for marriage information (in a separate box).
- able to bold direct descendants
- 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
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.
Options
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
- Generations
- 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.
Secondary [display] tab
The Secondary [display] tab shows secondary display that can/will be used
This is spousal (secondary) display that will be used within the report.
- Use separate display format for spouses
- For the Descendant reports.
- Indent spouses
- For the Descendant reports. When showing more than one level of spouses (option on the 'Tree Options' tab), indenting the spouses really helps visually group people so the report is easier to understand.
- Spousal Display Format
- For the Descendant reports. This will be used for spouses only. This does not include the parents of the center person or the parents of the father and mother of the center family.
- Secondary Display Format
- For the Ancestoral report. Spouses of the center person, (grand)-fathers, (grand)-mothers) can choose to use this display format
- Include Marriage Information
- whether to include a separate box holding marriage information.
- in the Ancestoral report, anyone can display this information too. I would personally suggest that (grand)-fathers display this.
- in the Descendant reports, anyone can display this information too. I would personally suggest that spouses display this.
- Marriage Display Format
- How you wish to display this information.
Print Tab
The same print features
- Scale report to fit
- Do not scale report. This option works great with the 'One Page Report' option.
- Scale report to fit page width only.
- Scale report to fit the size of the page.
- One page report
- Scale up or down the size of the page (whether verticaly or both vertically and horizontally) to fit the natural size of the report. Note that this WILL most likely make irregular page sizes. Great for Emailing to relatives and Kinkos can size to print too.
- Include Report Title
- Will display the names of the uppermost parents.
- Grandparents will be displayed if known/shown. Otherwise the parents will be printed.
- Print a border
- Prints a border around the report if wanted.
- Print Page Numbers
- Page numbers will be printed on the lower right hand corner of the report.
- Include Blank Pages
- on multiple page reports, if nothing is on a page, specify to print the page anyway.
The 'Scale Report to fit' and 'One Page Report' options can be done in a couple of neat ways.
Scale Report to fit | One Page Report | Result |
---|---|---|
Do not scale report | Unchecked | this is the default options, The report will print on as many pages (both horizontally and vertically) as needed. |
Do not scale report | Checked | This will make the page size the size that the report wants to be. Using zero page margins makes gif/jpeg pictures. |
Scale report to fit page width only | Unchecked | this option is most useful when printing landscape. It is easier to tape together pages vertically only. |
Scale report to fit page width only | Checked | My Kinkos has a 36 inch wide printer. The paper is on a roll, so I use this option to make my LONG wall reports. |
Scale report to fit the size of the page | both checked and unchecked | This will scale the report to fit on the page specified in 'Paper Options' |
Display formatting
- Better display formatting/Graphical_Substitution
- '{' and '}' now encapsulate areas that can be removed if all variables within are unknown
- '-' at the start of a line will remove the line if all variables on the line are unknown
- a better Display_formatting/Graphical_Substitution is very close to complete (documentation only now).
- Missing (unknown) information can now either display nothing or '_____'
- The option to include a personalized Note to the report.
- You can print the date by using '$T' in the note.
Many of the graphical reports allow you to customize the information on the display. Variable substitutions are used to substitute personal or marriage information for a particular symbol.
The Substitution Keys
$n | Displays the person's name in the form of FirstName LastName |
$N | Displays the person's name in the form of LastName, FirstName |
$i | Displays the GRAMPS ID associated with the person. |
$b | Displays the person's date of birth |
$B | Displays the person's place of birth |
$d | Displays the person's date of death |
$D | Displays the person's place of death |
$s | Displays the name of the person's spouse in the form of FirstName LastName |
$S | Displays the name of the person's spouse in the form of LastName, FirstName. |
$m | Displays the marriage date of the person and the spouse. |
$M | Displays the place associated with the marriage of the person and the spouse. |
$v | Displays the marriage divorce date of the person and the spouse. |
$V | Displays the place associated with the divorce of the person and the spouse. |
\$ | $ |
\} | } |
\{ | { |
\\ | \ |
{ | Starts a conditional printing section. |
} | Ends a conditional printing section. |
{ | (only at the start of a line)
This is a line that is NOT to print if all variables are unknown |
Conditional printing
'{' and '}' have been added to help define what prints on a line and '{' at the start of a line defines if the line prints at all. These two are based on these rules:
no variables within closing | prints everything. |
variables inside and none have information in the database.
ie. '{d. $d $D}' when the person is alive |
prints Nothing |
variables inside and at least one has information in the database.
ie. '{b. $b $B}' and the date is known |
prints everything |
Other Notes:
- The end of a line is the same as a closing '}'
- 'd. $d{ $D} is the same as 'd. $d{ $D'
- Brackets are read from left to right
Examples
$i $n Born on $b{ at $B} {d. $d $D {($v)
- The first and second lines always prints.
- The second line always prints 'Born on '
- The second line may or may not print ' at ' and the place depending on whether the place is known.
- The third line will not be displayed if the person is alive or if BOTH the date and place of death is not known.
{Born{ on $b}{ at $B
If either the date or place (or both) of birth is known 'Born ' will print with what information is known. If neither is known a blank line will print. You can replace the first '{' with a '-' to remove the line all together from what displays (for this person)
Replace missing places/dates with:
All reports come with this option to either:
- print nothing at all. ie
- print '_____' (A space to fill in information)
when a place or a date is not known.
ie. The first example may display 'Born on _____' if both the date and place are unknown.
See also
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.