Gramps 5.2 Wiki Manual - Reports - part 5
Previous | Index | Next |
Languages: |
English • Deutsch • español • suomi • français • עברית • македонски • Nederlands • русский • shqip • slovenčina |
Back to Index of Reports.
This section describes the different Graphs (aka Graph Reports) available in Gramps.
Contents
Graphs
These reports are created using the GraphViz program. Therefore, it is important that the Graphviz program is installed on your computer. |
Reports and custom IDs After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on Edit --> Preferences on the ID Formats tab). If generated reports do not properly display data, then try Reorder Gramps IDs tool Tools-->Family Tree Processing-->Reorder Gramps IDs... |
All three graph reports: Family Lines, Hourglass, and Relationship Graphs share common options: Graphviz Layout, Graphviz Options, and Note.
Also they share common options with the other reports common options: Paper Options and Document Options.
Prerequisites for Graph Reports
Requires the installation of the GraphViz program and Ghostscript program that is used by Graphviz reports to help create PDF files.
- On Linux, use your package manager.
- On Microsoft Windows use the Gramps AIO as they are already part of the installer.
- On Apple macOS use the Gramps .dmg as they are already part of the installer.
Common Options
There are also several GraphViz specific options related to pagination, color, and details of the graph.
This plugin uses the Graphviz graph visualization and Ghostscript programs. Graphviz takes the generated .gv
files and creates the final files, such as .gif
, .png
, , .ps
, (Ghostscript creates .pdf
), etc.
Graphviz Layout
- Font family: Choose the font family. If international characters don't show, use FreeSans font. FreeSans is available from the NonGNU org.
- Default
- PostScript/ Helvetica
- True Type/ FreeSans
- Font size: (
14
default) The font size, in points. - Graph Direction: Whether the graph goes from top to bottom or left to right
- Vertical (top to bottom) (Default)
- Vertical (bottom to top)
- Horizontal (left to right)
- Horizontal (right to left)
- Number of Horizontal Pages: (
1
default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array horizontally. Only valid for dot and pdf via Ghostscript. - Number of Vertical Pages: (
1
default) Graphviz can create very large graphs by spreading the graph across a rectangular array of pages. This controls the number of pages in the array vertically. Only valid for dot and pdf via Ghostscript. - Paging Direction: (Bottom, left default) The order in which the graph pages are output. This option only applies if the horizontal pages or vertical pages are greater than 1.
- Connecting lines: - How the lines between objects will be drawn. Choose from:
- Straight
- Curved (Default)
- Orthogonal
Graphviz Options
- Aspect Ratio: Affects greatly how the graph is laid out on the page. Specifically node spacing and scaling of the graph( see Advice 1:).
- Compress to minimal minimal size
- Fill the given area (default)
- Expand uniformly
Advice 1:
If the graph is smaller than the print area:
- Compress to minimal minimal size will not change the node spacing.
- Fill the given area will increase the node spacing to fit the print area in both width and height.
- Expand uniformly will increase the node spacing uniformly to preserve the aspect ratio.
If the graph is larger than the print area:
- Compress to minimal minimal size will shrink the graph to achieve tight packing at the expense of symmetry.
- Fill the given area will shrink the graph to fit the print area after first increasing the node spacing.
- Expand uniformly will shrink the graph uniformly to fit the print area.
- DPI: (
72
default) dots-per-inch. When creating PostScript or PDF, use 72 DPI. Typically between 75 and 120 if generating .png or .gif files, but 300 or 600 if generating files to be printed. When creating images such as .gif or .png files for the web, try numbers such as 100 or 300 DPI. - Node Spacing: (
0.20
default) The minimum amount of free space, in inches, between individual nodes. For vertical graphs, this corresponds to spacing between columns. For horizontal graphs, this corresponds to spacing between rows. - Rank Spacing: (
0.20
default) The minimum amount of free space, in inches, between ranks. For vertical graphs, this corresponds to spacing between rows. For horizontal graphs, this corresponds to spacing between columns.
Note
- Note to add to the graph: (Empty by default) This text will be added to the graph
- Note location: - Whether the note will appear on top or bottom of the page.
- Top (default)
- Bottom
- Note size: (
32
default) The size of note text, in points.
Family Lines Graph
The Family Lines Graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants to generate the Family Lines Graph using the GraphViz generator.
A typical use of this report is to generate simplified graphs to be printed on large format printing plotters.
To create a Family Lines Graph from the menu select Reports ->Graphs -> Family Lines Graph... and then from the People of Interest tab click on the (add) icon and select at least one person from the Select Person selector dialog and the report will suggest if possible a second related person via the Select Person - Also include <Person Name> warning dialog select No or Yes depending on what you decide and then select OK to generate the report.
See also:
- common options - (GraphViz specific related to pagination, color, and details of the graph.)
Report Options
- Follow parents to determine "family lines" Parents and their ancestors will be considered when determining "family lines". (checkbox checked by default)
- Follow children to determine "family lines" Children will be considered when determining "family lines". (checkbox checked by default)
- Try to remove extra people and families People and families not directly related to people of interest will be removed when determining "family lines". (checkbox checked by default)
- Arrowhead direction: Choose the direction that the arrows point:
- Descendants <- Ancestors (default) - arrows point to the Descendants.
- Descendants -> Ancestors - arrows point to the Ancestors.
- Descendants <-> Ancestors - arrows point to both.
- Descendants - Ancestors - None (no arrows are shown)
- Graph colouring: - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
- B&W outline - Black and white outline
- Coloured outline
- Colour fill (default)
- Rounded corners: to differentiate between women and men.
- None (default)
- Female
- Male
- Both
- Gramps ID: Whether (and where) to include Gramps IDs
- Do not include (default)
- Share an existing line
- On a line of its own
Report Options (2)
- Name Format: - Select the format to display the names. This choice in normally taken from the default setting in Edit > Display tab for Name format:. Or to override that setting for the report choose from:
- Default - (in a new Family Tree this is normally Surname, Given Suffix )
- Surname, Given Suffix
- Given Surname Suffix
- Given
- Main Surnames, Given Patronymic Suffix
- SURNAME, Given (Common)
- Include data marked private (checkbox checked by default) - Whether to include private data.
- Living People: - How to handle (information about) living people
- Included, and all data (default)
- Full names, but data removed
- Given names replaced, and data removed
- Complete names replaced, and data removed
- Not included
- Years from death to consider living:
0
(default) - Whether to restrict data on recently dead people. - Translation: The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
- Date format: The format and language for dates, with examples
- Default - Choose this option to use the default set in Edit > Display tab for Date format: option.
- YYYY-MM-DD (ISO) (2024-11-15) (default for report)
- Numerical (15/11/2024)
- Month Day, Year (March 14, 2018)
- MON DAY, YEAR (Mar 14, 2018)
- Day Month Year (14 March 2018)
- DAY MON YEAR (14 Mar 2018)
- Use subgraphs (checkbox checked by default) - Subgraphs can help Grapviz position spouses together, but with non-trival graphs will result in longer lines and larger graphs.
People of Interest
The graph works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.
- People of interest: click on and to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
- Limit the number of ancestors (checkbox unchecked by default) Whether to limit the number of ancestors.
50
default. The maximum number of ancestors to include. The maximum is for the total number of people, not generations to be displayed on the chart.
- Limit the number of descendants (checkbox unchecked by default) Whether to limit the number of descendants.
50
default. The maximum number of descendants to include. The maximum is for the total number of people, not generations to be displayed on the chart.
Select Person - Also include <Person Name> warning dialog
Select Person - Also include <Person Name> warning dialog
This article's content is incomplete or a placeholder stub. |
Include
- Include dates: date of birth, date of death, and marriage dates will be included in the graph when this is selected. (checkbox checked by default)
- Limit dates to years only: from the above only show the years.(checkbox unchecked by default)
- Include places: place of birth, place of death, and place of marriage will be included in the graph when this is selected.(checkbox checked by default)
- Include the number of children: marriage text will include the total number of children when this is selected.(checkbox unchecked by default)
- Include thumbnail images of people (checkbox checked by default)
- Thumbnail location:
- Above the name (Default)
- Beside the name
- Thumbnail size:
- Normal (default)
- Large
Family Colours
- Family colors: Select the color to use for people with a specific surname. Two columns are available: Surname and Color. Click on or to add a surname from the Select surname window, select a surname and press OK. To edit the surname color double-click on a surname and from the Select color for [Surname Selected] window choose from the shown colors and then select Select.
Individuals
You can select a color for each of the following from the Pick a Color window and then select the Select button.
- Males: the colour to use to display men.
- Females: the colour to use to display women.
- Other: the colour to use to display people who neither men nor women.
- Unknown: the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
- Families: the colour to use to display families. (marriages).
Hourglass Graph
Generate an Hourglass Graph using the GraphViz generator. Go to Reports -> Graph -> Hourglass Graph....
The hourglass graph chart shows the Center Person:s ancestors above them and descendants below them. The hourglass graph does not show siblings of the ancestors but it does include all the descendants below them including any spouses.
See also:
- common options - (GraphViz specific related to pagination, color, and details of the graph.)
Report Options
- Center Person: the center person for the report, defaults to the current active person.
- Select a different person button. - Change the center person.
- Max Descendant Generations: default
10
- Max Ancestor Generations: default
10
- Arrowhead direction: Choose the direction that the arrows point:
- Centre -> Others (default) - arrows point to the Other.
- Centre <- Others - arrows point to the Centre.
- Centre <-> Others - arrows point to both.
- Centre - Others - None (no arrows are shown)
- Graph colouring: - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
- B&W outline - Black and white outline
- Coloured outline
- Colour fill (default)
- Use rounded corners to differentiate between women and men (checkbox unchecked by default)
- Gramps ID: whether to include Gramps IDs.
- Do not include (default)
- include
Report Options (2)
- Name format: - Select the format to display the names. This choice in normally taken from the default setting in Edit > Display tab for Name format:. Or to override that setting for the report choose from:
- Default - (in a new Family Tree this is normally Surname, Given Suffix )
- Surname, Given Suffix
- Given Surname Suffix
- Given
- Main Surnames, Given Patronymic Suffix
- SURNAME, Given (Common)
- Include data marked private (checkbox checked by default) - Whether to include private data.
- Living People: - How to handle (information about) living people
- Included, and all data (default)
- Full names, but data removed
- Given names replaced, and data removed
- Complete names replaced, and data removed
- Not included
- Years from death to consider living:
0
(default) - Whether to restrict data on recently dead people. - Translation: The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
- Date format: The format and language for dates, with examples
- Default - Choose this option to use the default set in Edit > Display tab for Date format: option.
- YYYY-MM-DD(ISO)(2018-03-14) (default for report)
- Numerical(14/3/2018)
- Month Day, Year(March 14, 2018)
- MON DAY, YEAR(Mar 14, 2018)
- Day Month Year(14 March 2018)
- DAY MON YEAR(14 Mar 2018)
Graph Style
You can select a color for each of the following from the Pick a Color window and then select the Select button.
- Males: the colour to use for males.
- Females: the colour to use for females.
- Other: the colour to use for Others.
- Unknown: the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
- Families: the colour to use for families (weddings).
Force Ahnentafel order
Ahnentafel number visible
Show symbols for events
Relationship Graph
The Relationship Graph creates a complex relationship graph using the GraphViz generator.
Via the menu: Reports-> Graphs- >Relationship Graph.... You will be presented with a Relationship Graph window where you can change all the settings.
See also:
- common options - (GraphViz specific related to pagination, color, and details of the graph.)
Report Options
- Filter: - Select the filter to be applied to the report. Choose from:
- Entire Database (Default) (Not recommended!)
- Descendants of active person
- Descendant families of active person
- Ancestors of active person
- People with common ancestor with active person
- Any custom made filter you have created will be listed below the other choices.
- Centre Person: The center person for the filter. Defaults to the Active Person. If you use a custom filter, no Person can be chosen.
- Select a different person button. - Change the Centre person.
- Arrowhead direction: Choose the direction that the arrows point:
- Descendants <- Ancestors(default) - arrows point to the to the Descendants.
- Descendants -> Ancestors - arrows point to the to the Ancestors.
- Descendants <-> Ancestors - arrows point to both.
- Descendants - Ancestors - None (no arrows are shown)
- Graph colouring: - Males will be shown with blue, females with red, unless otherwise set above for filled. If the sex of an individual is unknown it will be shown with gray.
- B&W outline - Black and white outline
- Coloured outline
- Colour fill (default)
- Use rounded corners Use rounded corners to differentiate between women and men (checkbox unchecked by default)
- Use hexagons (checkbox unchecked by default)
- Gramps ID: whether to include Gramps IDs.
- Do not include default
- include
Report Options (2)
- Name Format: - Select the format to display the names. This choice in normally taken from the default setting in Edit > Display tab for Name format:. Or to override that setting for the report choose from:
- Default - (in a new Family Tree this is normally Surname, Given Suffix )
- Surname, Given Suffix
- Given Surname Suffix
- Given
- Main Surnames, Given Patronymic Suffix
- SURNAME, Given (Common)
- Include data marked private (checkbox checked by default) - Whether to include private data.
- Living People: - How to handle (information about) living people
- Included, and all data (default)
- Full names, but data removed
- Given names replaced, and data removed
- Complete names replaced, and data removed
- Not included
- Years from death to consider living:
0
(default) - Whether to restrict data on recently dead people. - Translation: The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.
- Date format: The format and language for dates, with examples
- Default - Choose this option to use the default set in Edit > Display tab for Date format: option.
- YYYY-MM-DD(ISO)(2024-11-15) (default for report)
- Numerical(15/11/2014)
- Month Day, Year(November 15, 2024)
- MON DAY, YEAR(Nov 15, 2024)
- Day Month Year(15 November 2024)
- DAY MON YEAR(15 Nov 2024)
Include
- Dates and/or Places: - Whether to include dates and/or places
- Do not include any dates or places (default)
- Include (birth, marriage, death) dates, but no places
- Include (birth, marriage, death) dates, and place
- Include (birth, marriage, death) dates, and place if no dates
- Include (birth, marriage, death) years, but no places
- Include (birth, marriage, death) years, and places
- Include (birth, marriage, death) places, but no dates
- Include (birth, marriage, death) dates and places on same line
- Show all family nodes Show family nodes even if the output contains only one member of the family. (checkbox checked by default)
- Include URLs (checkbox unchecked by default)
- Include relationship to center person (checkbox unchecked by default)
- Include thumbnail images of people (checkbox unchecked by default)
- Thumbnail location: Where the thumbnail image should appear relative to the name
- Above the name (Default)
- Beside the name
- Include occupation: Whether to include the last occupation
- Do not include any occupation (default)
- Include description of most recent occupation
- Include date, description and place of all occupations
- Include relationship debugging numbers also Whether to include 'Ga' and 'Gb' also, to debug the relationship calculator (checkbox unchecked by default)
Graph Style
You can select a color for each of the following from the Pick a Color window and then select the Select button.
- Males: the colour to use for males.
- Females: the colour to use for females.
- Other: the colour to use for others.
- Unknown: the colour to used when gender is unknown (and for people whose surname doesn't match any of the names on the "Family Colours" tab.)
- Families: the colour to use for families (weddings).
- Indicate non-birth relationships with dotted lines (checkbox checked by default) - Shows adopted relationships.
- Show family nodes (checkbox checked by default)
- Parent grouping: Decides the location of the parents in the graph.
- Normal (default)
- Parents together
- Parents offset
Example relationship graph
Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.
- First check that this person is the active person. (You change this later but this is handier)
- Go via the menu Reports->Graphs->Relationship Graph...
- Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
- Report Options: filter: Descendant Families of..., Color fill, Use rounded corners
- Graph Style : Show Family Nodes
- Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
- Graphviz Options: Fill given area dpi 133
- Note : we add title on the top size: 18 pts
- Output Format: we want a JPEG file.
The results are similar to the image shown in Fig. 13.5.21.
See also:
- A detailed tutorial How to make a relationship chart
Back to Index of Reports.
Previous | Index | Next |
Languages: |
English • Deutsch • español • suomi • français • עברית • македонски • Nederlands • русский • shqip • slovenčina |
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. |