Gramps 5.0 Wiki Manual - Reports - part 4

From Gramps
Jump to: navigation, search
Previous Index Next


This section describes the different Graphical Reports available in Gramps.

Back to Index of Reports.

Graphical Reports

Graphical reports represent information in forms of charts and graphs. Most of the options are common among graphical reports, therefore they will be described only once, at the end of this section. The few options which are specific to a given report will be described directly in that report's entry. See also substitution values.

The following graphical reports are currently available in Gramps:

Common options

Common options for text reports are the filename of the output, the format of the output, selected style, page size and orientation. For HTML reports, there is no page information. Instead, HTML options include the choice of the HTML template, either available in Gramps or a custom template defined by you. Optionally, the reports can be immediately opened with the default application.

Gnome-important.png
Tip

The options used in reports are persistent: eg: each report remembers the options previously used.


The options which are specific to a given report will be described directly in that report's entry and on Command line references.

For each report there is a screen with on the top part tabs (like Paper Options...) and on the bottom part the Document Options. The number of tabs varies with the report.

Paper Options

Fig. 11.4.1 Paper Options

With the Paper Options tab you can change:

  • Paper format
    • Size Letter(default)
    • Width (8.50 in. default)
    • Height (11.00 in. default)
    • Orientation Portrait(default)
  • Margins
    • Left(1.00 in. default)
    • Right(1.00 in. default)
    • Top(1.00 in. default)
    • Bottom(1.00 in. default)
  • Metric : whether to use metric values or not (in. or cm.). (checkbox unchecked by default)


Document Options

Options below will change slightly depending on the output format selected.

Fig. 11.4.2 Document Options - SVG example output
  • Output Format choose the output format:
    • SVG Document : (Scalable Vector Graphics) for display with a web browser or editing with a suitable graphics editor.
    • PostScript
    • Open Document Text (if you want to edit the report with Openoffice or Libreoffice)
    • PDF document
    • Print...
  • Open with default viewer: you can indicate to open the made document your default viewer. will open the created report using whatever program is defined on your system for handling the format selected.(checkbox unchecked by default)
  • Filename: default value is /home/<username>/<Family Tree Name><Report Name>.txt. by default the filename is the same as the report type, and it will be placed in your home directory. (In Windows it defaults to one level up from "My documents".)
  • Style: (default is default). With the Style Editor... button you can add Document Styles.
  • SVG Background color: (transparent background default)


Ancestor Tree

Fig. 11.4.3 Graphical Reports - Ancestor Tree - sample PDF output

This report generates the chart of people who are ancestors of the Active Person.

You can choose the Ancestor Tree report with Reports ->Graphical Reports -> Ancestor Tree...

See also common options

Tree Options

Fig. 11.4.4 Graphical Reports - Ancestor Tree - Tree Options

The Center Person is chosen here. The Active person will be the default.

With the input field Generations you can change the number of generations considered.

Display unknown generations will allow you to select how many generations of empty boxes to display when the tree is not completely full.

Here is also the check box Compress tree.

Center person uses which format: allows you to specify if the center person uses the father display format or the mother display format found on the Display tab.

Display

Fig. 11.4.5 Graphical Reports - Ancestor Tree - Display tab

This tab allows you to determine the Father Display Format to be used for the report. All fathers, grandfathers, etc. will use this format.

The Mother Display Format to be used for all mothers, grandmothers, etc. will use this format.

The {} around the death information line states that the text 'd. ' will display ONLY when there is death information. See Substitution Values for more information, including how to include places and attributes, and format names and dates and places.

Include Marriage box specifies to display an extra box between a father and mother that contains marriage information. The Marriage Display Format (see Substitution Values) specifies what will print in this box.


Size

Fig. 11.4.6 Graphical Reports - Ancestor Tree - Size tab

Scale tree to fit will make the tree larger or smaller to fit the page as desired. The options are:

  • Do not Scale the tree
  • Scale tree to fit page width only
  • Scale tree to fit the size of the page

where Resize page to fit tree will make the page larger or smaller to fit the tree

If both are selected, the options happen in that order; scale the tree first, then the page.

These two options are better described in Size options with tips for making nicer reports.


Include

Fig. 11.4.7 Graphical Reports - Ancestor Tree - Include tab

This tab gives you the option to include other items on the report.

Report title allows you to choose a title for the report.

  • Do not print a title
  • Include Report Title

And this tab also includes check boxes for Include a border, Include page numbers, and Include blank pages.

This tab also allows you to Include a note to one of the corners of the report.

“$T” within the note will display the day that the report was made. Regular date formatting (see Substitution Values) applies.

Currently a note will be attached to a corner. If a person box writes over it, the note box will not move. Select another corner to see the note tab if this happens.


Calendar

Fig. 11.4.8 Graphical Reports - Calendar - sample PDF output

This report produces a calendar with birthdays and anniversaries on a page by month.

You can choose the Calendar report with Reports ->Graphical Reports -> Calendar...

You can print the same information but in text format by using the Birthday and Anniversary Report.

Calendar tools holidays explains how to add or change the holidays appearing on the output of this calendar.

See also common options

Report Options

Fig. 11.4.9 Report Options
  • Filter: choose between
    • Entire Database (Default)
    • Descendants of active person
    • Descendant families of active person
    • Ancestors of active person
    • People with common ancestor with active person
  • Center Person: The center person for the report.
  • Name Format: Select the format to display the names. Choose from Surname, Given Suffix(default) / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
    • Include data marked private (checkbox checked by default)
    • Include only living people (checkbox checked by default)
  • Translation: The translation to be used for the report. Language selector


Content Options

Fig. 11.4.10 Content Options
  • Year of report: fill in the year. Defaults to current Year.
  • Country for holidays: Select the country to see associated holidays.
  • First day of week: (Default: Monday) Select the first day of the week for the report.
  • Birthday surname: Select married women's displayed surname.
    • Wives use their own surname (Default)
    • Wives use husband's surname (from first family listed)
    • Wives use husband's surname (from last family listed)
  • Include birthdays : include or not birthdays in the calendar (checkbox checked by default)
  • Include anniversaries : include or not anniversaries in the calendar (checkbox checked by default)


Text Options

Fig. 11.4.11 Text Options

Here you can fill in three lines of text that will be put at the bottom of the page.

  • Text Area 1: (My Calendar default) First line of text at bottom of calendar.
  • Text Area 2: (Produced by Gramps default) Second line of text at bottom of calendar.
  • Text Area 3: (http://gramps-project.org/ default) Third line of text at bottom of calendar.


Descendant Tree

This report generates a chart of people who are descendants of the starting person. Alternatively it may generate a chart of descendants of the parents of the starting person.

You can choose the Descendant Tree report with Reports ->Graphical Reports -> Descendant Tree...

Fig. 11.4.12 Descendant Tree Report, Example 1. Allan Davies had three spouses.
Fig. 11.4.13 Descendant Tree Report, Example 2.


See also common options

Tree Options

Gramps-notes.png

Please update or expand this section.


Fig. 11.4.14 Tree Options

Report for: selects the starting person for the report. It defaults to the current active person.

Start with the parent(s) of the selected first will draw a descendancy chart from the parents of the starting person, if they are in the database. The example below is based on the same family as the first example and shows the result of starting with "Child 2 Davies" and ticking this box.


Example 1 was obtained by selecting Allan Davies as the starting person and then running the report without this box ticked, with all other options the same except Generations. The differences between the two examples are:

  • The format of the first generation is changed. Because the parents of the starting person must be adjacent, spouses in the first generation may be shown out of order.
  • For the purpose of the Level of spouses setting, both parents are considered direct descendants, rather than spouses. (Although the mother uses the Spousal display format on the Display tab.)

This means that other spouses (if any) of both of them will be shown to the number of levels specified by Level of spouses. In example 2, Mike Morris is shown even though Level of spouses is set to 1.

  • The title of the report (if selected on the Include tab) is changed to include both parents of the starting person. Only two people are shown in the title. In example 2, Mike Morris is not listed in the title even though his descendants are shown.

Generations The number of generations to show on the report (including the starting person). If Start with the parent(s) of the selected first is selected, the chart will include one more generation. (Example 1 was run with Generations=3, Example 2 with Generations=2.)

Level of spouses specifies how deep to display spouses.

For the example:

  • Abe is a direct descendant
    • Abe has/had married Barbra and had two children
    • Abe also married Bridget and had one child
      • Bridget has/had married Carl.
        • Carl and Denise had a child.

Given the above example, this is what will be displayed for the first three Level of spouses options.

  • 0 means that only direct descendants will be shown. Nothing on the Secondary tab will be shown (Spousal information or Marriage information). For the example above, only Abe will be shown with three children directly under him
  • 1 means that only spouses of the direct descendants will be shown. For the example above, Abe will be shown with two pieces of marriage information. Under the first will be two children and one child under the second.
  • 2 means that spouses of spouses are shown. Same as 1 but Bridget will also show her other marriage. If they had any children, they would be shown too.
  • 3 means that everyone in the example above will be displayed.

Any option above 1 is very hard to read on the report without the Indent Spouses option on the Display tab.

And last but not least is the Compress Tree option which tries to move everyone up as far as they can go (compress) and still have a readable report. If Start with the parent(s) of the selected first is ticked, Compress Tree does not have any affect on the first generation.

Display

Fig. 11.4.15 Graphical Reports - Descendants Tree - Display - tab

Descendant Display Format sets the display for all descendants in the tree. The default is:

$n
b. $b
{d. $d}

which displays the name, birth date and death date on consecutive lines in the formats set on the Display tab in Gramps preferences. The {} on the third line states that the text 'd. ' will display ONLY when $d has a value, i.e. there is something in the death date field of the database for this person. See Substitution Values for more information, including how to include places and attributes, and select different formats for names and dates and places.

The check box Bold direct descendants causes the names and other information about direct descendants to be in the bold font selected in the style editor.

Spousal Display format specifies what is displayed for each spouse. The default is the same as for descendants. If you do not wish to have a separate box for marriage information, it can be displayed in the spouse box, for example by adding a line with

m. $m 

Which displays the date of the marriage.

Indent spouses will indent the spouse and marriage boxes from the descendant boxes. In the Family Descendant Chart, it does not affect the starting family or the parents of the starting family, but it does affect any other spouses of those three couples.

Include marriage box will display a separate box on the tree for each marriage. The display format is set in Marriage Display format. The default is

m. $m

which displays the date of the marriage. If this box is not ticked, marriage information will not be displayed unless you specify it in the spousal display format as described above.


Replace

Fig. 11.4.16 Graphical Reports - Descendants Tree - Replace - tab

This allows you to put in pairs of strings separated by '/' that state what you want to replace and what you want to replace it with.


Example:

The United States of America/USA
United Kingdom of Great Britain and Northern Ireland/UK
Llanfair­pwllgwyn­gyllgo­gerychwyrn­drobwll­llanty­silio­gogogoch/Llanfairpwll

Every column width is defined by the widest box in the report. So if one box happens to be a lot wider than all of the others, a lot of space will be wasted. This option allows you to remove or abbreviate parts of the string that is not needed or can be cut down so the amount of space wasted is minimal.


Size

Fig. 11.4.17 Graphical Reports - Descendants Tree - Size - tab


Include

Fig. 11.4.18 Graphical Reports - Descendants Tree - Include - tab

Report title allows you to choose a title for the report.

  • Do not print a title
  • Descendant Chart for [selected person(s)]

If "Start with Parents of Selected" is ticked on the "Tree Options" tab, both parents of the selected person are shown. Only two people will be listed in the title. If "level of spouses" is two or more, descendants of "spouses of spouses" are included on the chart, but are not listed in the title.

And this tab also includes check boxes to Include a border, Include page numbers, and Include blank pages.

This tab also allows you to Include a note to one of the corners of the report.

“$T” within the report will display the day that the report was made. Regular date formatting (see Substitution Values) applies.

Gnome-important.png
Currently a note will be attached to a corner.

If a person box writes over it, the note box will not move. Select another corner to see the note tab if this happens.


Family Descendant Tree

Gramps-notes.png
Shared options with the Descendant Tree report

This report has the same options as the 'Descendant Tree' report, except that there are more options for the report title on the Include tab. Also, some of the options have a different effect. Options are only described here if they differ between the two reports.

You can choose the Family Descendant Tree report with Reports ->Graphical Reports -> Family Descendant Tree...

Fig. 11.4.19 Example of Output from Family Descendant Tree Report

See also common options

Tree Options

Gramps-notes.png

Please update or expand this section.


Fig. 11.4.20 Tree Options

Report for: will select the starting family (Father and Mother) for this report. It defaults to the currently active family.

Start with the parent(s) of the selected first If this box is ticked, the report shows both parents of the starting father and mother (if they are in the database), and all descendants of both sets of parents for the selected number of generations. The total number of generations in the chart is therefore 1 more than the number selected in the generations box. (The example chart above was made with generations=2.)

The starting father and mother have to be in the center of the chart. They will therefore not be shown in birth order with their siblings - instead they will be shown as the last and first child of their parents respectively. This is shown in the example chart above, where the children in both families have been named Child 1,2,3 in their birth order. Furthermore, if the starting father or mother have other spouses they will be shown twice. This also applies to the parents of the starting father or mother.

If this box is not ticked, the report is the same as the descendant tree report, except that the number of generations is increased by one, the format of the first generation is different, and you get extra options for the chart title.


Display

Fig. 11.4.21 Graphical Reports - Family Descendants Tree - Display - tab


Replace

Fig. 11.4.22 Graphical Reports - Family Descendants Tree - Replace - tab


Size

Fig. 11.4.23 Graphical Reports - Family Descendants Tree - Size - tab


Include

Fig. 11.4.24 Graphical Reports - Family Descendants Tree - Include - tab


The Report Title: has these additional options:

  1. Do not print a title
  2. Descendant Chart for [selected person(s)]
  3. Family Chart for [names of chosen family]
  4. Cousin Chart for [names of children] (Only available if Start with the parent(s) of the selected first is chosen)


Fan Chart

Fig. 11.4.25 Graphical Reports - Fan chart - default - sample PDF output

This report produces a chart resembling a fan, with Active person in the center, parents the semicircle next to it, grandparents in the next semicircle, and so on, for a total of five generations.

You can choose the Fan Chart report with Reports ->Graphical Reports -> Fan Chart...

See also common options

Report Options

Fig. 11.4.26 Report Options
  • Center Person: The center person for the report.
    • Include data marked private (checkbox checked by default)
  • Generations: (5 default ) The number of generations to include in the report.
  • Type of graph: The form of the graph.
    • full circle
    • half circle(Default)
    • quarter circle
  • Background color: Background color is either white or generation dependent(Default).
  • Orientation of radial texts: Print radial text upright(Default) or roundabout.
  • Draw empty boxes: Draw the background although there is no information (checkbox checked by default)
  • Use one font style for all generations : You can customize font and color for each generation in the style editor (checkbox checked by default)
  • Translation: The translation to be used for the report. Language selector


Statistics Charts

This report can collect and display a wealth of statistical data about your Family Tree.

You can choose the Statistics Charts report with Reports ->Graphical Reports -> Statistics Charts...

Specific options include filter, sorting methods, and additional birth- and gender-based limit for inclusion into statistics. You can also set the minimum number of items to qualify for the bar chart, so that the charts with fewer items will generate a pie chart instead. The Charts 1 and Charts 2 tabs allows you to select which charts you want to include in your report.

Fig. 11.4.27 Graphical Reports - Statistics chart - Birth Month - sample PDF output
Fig. 11.4.28 Graphical Reports - Statistics chart - Number of Children - sample PDF output
Fig. 11.4.29 Graphical Reports - Statistics chart - Gender - sample PDF output


See also common options

Report Options

Fig. 11.4.30 Report Options
  • Filter: choose between
    • Entire Database (Default)
    • Descendants of active person
    • Descendant families of active person
    • Ancestors of active person
    • People with common ancestor with active person
  • Filter Person: The center person for the report.
  • Name Format: Select the format to display the names. Choose from Surname, Given Suffix(default) / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
    • Include data marked private (checkbox checked by default)
  • Sort chart items by: Select how the statistical data is sorted:
    • Item count (default)
    • Item name
  • Sort in reverse order (checkbox unchecked by default)
  • People born after: (1700 default) Birth year from which to include people: fill in a year to start from
  • People born before: (Current year default) Birth year until which to include people: fill in a year
  • Include people without known birth years (checkbox unchecked by default)
  • Genders included: Select which genders are included into statistics.
    • Both(Default)
    • Men
    • Women
  • Max. items for a pie: (8 default) With fewer items pie chart and legend will be used instead of a bar chart.
  • Translation: The translation to be used for the report. Language selector


Charts 1

Fig. 11.4.31 Charts 1

Check the box to include the indicated data on a chart.

  • Age (checkbox unchecked by default)
  • Age at death (checkbox unchecked by default)
  • Age at marriage (checkbox unchecked by default)
  • Age when first child born (checkbox unchecked by default)
  • Age when last child born (checkbox unchecked by default)
  • Birth month (checkbox checked by default)
  • Birth place (checkbox unchecked by default)
  • Birth year (checkbox unchecked by default)
  • Death month (checkbox unchecked by default)
  • Death place (checkbox unchecked by default)


Charts 2

Fig. 11.4.32 Charts 2

Check the box to include the indicated data on a chart.

  • Death year (checkbox unchecked by default)
  • Event type (checkbox unchecked by default)
  • Forename (checkbox unchecked by default)
  • Gender (checkbox checked by default)
  • Marriage place (checkbox unchecked by default)
  • Number of children (checkbox checked by default)
  • Number of relationships (checkbox unchecked by default)
  • Surname (checkbox unchecked by default)
  • Title (checkbox unchecked by default)


Timeline Chart

Fig. 11.4.33 Graphical Reports - Timeline chart - sample PDF detail output

This report outputs the list of people with their lifetimes represented by intervals on a common chronological scale.

You can choose the Timeline Chart report with Reports ->Graphical Reports -> Timeline Chart...

See also common options

Report Options

Fig. 11.4.34 Report Options
  • Filter: choose between
    • Entire Database (Default)
    • Descendants of active person
    • Descendant families of active person
    • Ancestors of active person
    • People with common ancestor with active person
  • Filter Person: The center person for the report.
  • Name Format: Select the format to display the names. Choose from Surname, Given Suffix(default) / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
    • Include data marked private (checkbox checked by default)
  • Sort by: Sorting method to use.
    • Birth Date (Default)
    • Name
  • Translation: The translation to be used for the report. Language selector


Back to Index of Reports.


Previous Index Next


Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [http://www.gramps-project.org/...]), not via internal links.
Also, only use the known conventions