Gramps 4.1 Wiki Manual - Reports - part 4

From Gramps - Free Genealogy Software
Jump to: navigation, search
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: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions


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

Paper Options

Fig. 11.4.1 Calendar Report's - Paper Options - example

With the Paper Options you can change

  • Paper format (Size and Orientation)
  • Margins (Left, Right, Top and Bottom)

and whether to use metric values or not.


Document Options

Fig. 11.4.2 Calendar Report's - Document Options - example

Output Format choose the output format:

  • Open Document Text (if you want to edit the report with Openoffice or Libreoffice)
  • PDF document
  • PostScript
  • Print...
  • SVG (Scalable Vector Graphics) for display with a web browser or editing with a suitable graphics editor.

Open with default viewer will open the created report using whatever program is defined on your system for handling the format selected.

Filename 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 selects the named style set which controls the styles of text used in the report. Default is default style. Style Editor... allows you to define new style sets.


Ancestor Tree

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

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


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

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

Fig. 11.4.8 Graphical Reports - Calendar - sample PDF output


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 Graphical Reports - Calendar - Report Options
  • Year of report: fill in the year. Defaults to current Year.
  • 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 Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Country for holidays: Select the country to see associated holidays.
  • First day of week: Select the first day of the week for the report. Default: Monday
  • 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)
  • Checkboxes:
    • Include only living people: include or not living persons in the calendar
    • Include birthdays: include or not birthdays in the calendar
    • Include anniversaries: include or not anniversaries in the calendar
  • Translation: The translation to be used for the report. Language selector


Text Options

Fig. 11.4.10 Graphical Reports - Calendar - Text Options

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

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


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.

Fig. 11.4.11 Descendant Tree Report, Example 1. Allan Davies had three spouses.


See also common options

Tree Options

Fig. 11.4.12 Graphical Reports - Descendants Tree - Tree Options - tab

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.

Fig. 11.4.13 Descendant Tree Report, Example 2.


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.14 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.15 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.16 Graphical Reports - Descendants Tree - Size - tab


Include

Fig. 11.4.17 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 poeple 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.

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.

Fig. 11.4.18 Example of Output from Family Descendant Tree Report



See also common options

Tree Options

Fig. 11.4.19 Graphical Reports - Family Descendants Tree - Tree Options - tab

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 cente 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.20 Graphical Reports - Family Descendants Tree - Display - tab


Replace

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


Size

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


Include

Fig. 11.4.23 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

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.

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


See also common options

Report Options

Fig. 11.4.25 Graphical Reports - Fan chart - Report Options
  • Center Person: The center person for the report.
  • Generations: The number of generations to include in the report. Default: 5
  • 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
  • Check Box: Draw empty boxes
Draw the background although there is no information
  • Check Box: Use one font style for all generations
You can customize font and color for each generation in the style editor
  • Translation: The translation to be used for the report. Language selector


Statistics Chart

This report can collect and display a wealth of statistical data about your database. 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.26 Graphical Reports - Statistics chart - Birth Month - sample PDF output
Fig. 11.4.27 Graphical Reports - Statistics chart - Number of Children - sample PDF output
Fig. 11.4.28 Graphical Reports - Statistics chart - Gender - sample PDF output


See also common options

Report Options

Fig. 11.4.29 Graphical Reports - Statistics chart - 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.
  • Sort chart items by: Select how the statistical data is sorted:
    • Item count
    • Item name
  • Check box: sort in reverse order
  • People born after: Birth year from which to include people: fill in a year to start from (Default: 1700)
  • People born before: Birth year until which to include people: fill in a year (Default: Current year)
  • Check box: Whether to include people without known birth years
  • Genders included: Select which genders are included into statistics.
    • Both(Default)
    • Men
    • Women
  • Max. items for a pie: With fewer items pie chart and legend will be used instead of a bar chart. Default: 8 or enter a number.
  • Translation: The translation to be used for the report. Language selector


Charts 1

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

  • Age
  • Age at death
  • Age at marriage
  • Age when first child born
  • Age when last child born
  • Birth month (Default)
  • Birth place
  • Birth year
  • Death month
  • Death place

Charts 2

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

  • Death year
  • Event type
  • Forename
  • Gender(Default)
  • Marriage place
  • Number of children(Default)
  • Number of relationships
  • Surname
  • Title

Timeline Chart

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

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


See also common options

Report Options

Fig. 11.4.31 Graphical Reports - Timeline chart - 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 Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • 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