Gramps 5.0 Wiki Manual - Reports - part 5

From Gramps
Jump to: navigation, search
Previous Index Next


Back to Index of Reports.



Fig. 11.5.1 Reports >Graphs>... Menu overview

This section describes the different Graphs available in Gramps.

Graphs

These reports are created using the Graphviz program. Therefore it is important that the Graphviz program is installed on your computer. On Linux you can use your package manager. (As of 2017-01-21 the latest Graphviz version is 2.40.1 / Released 25 December 2016).

Gnome-important.png
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.

Common Options

There are also several Graphviz specific options related to pagination, color, and details of the graph.

This plugin uses Graphviz. Graphviz takes the generated .gv files and creates the final files, such as .gif, .png, .pdf, .ps, etc.

Graphviz Layout

Fig. 11.5.2 Family Lines Graph - Graphs - Graphviz Layout - tab default options
  • 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

Fig. 11.5.3 Family Lines Graph - Graphs - Graphviz Options - tab default 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.
    • Use subgraphs (checkbox checked by default) Subgraphs can help Graphviz position spouses together, but with non-trivial graphs will result in longer lines and larger graphs.

Note

Fig. 11.5.4 Family Lines Graph - Graphs - Note - tab default options
  • 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

Gramps-notes.png
That Family Lines Graph does not display all of the people in the Family Tree.

Instead, this Graph report generates smaller family trees, with many options to try and restrict the number of people included.

Fig. 11.5.5 Family Lines Graph - Graphs - example output overview

Generate an 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 select Reports ->Graphs -> Family Lines Graph... from the menu and from the People of Interest tab 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

Report Options

Fig. 11.5.6 Family Lines Graph - Graphs - Report Options - tab default options
Gramps-notes.png

Please update or expand this section.



Report Options (2)

Fig. 11.5.7 Family Lines Graph - Graphs - Report Options (2) - tab default options
Gramps-notes.png

Please update or expand this section.



People of Interest

Fig. 11.5.8 Family Lines Graph - Graphs - People of Interest - tab default options

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 STOCK_ADD and STOCK_REMOVE to add/remove people of interest. When in doubt, try adding your grandparents as a starting point.
  • Limit the number of ancestors
    • 50 default. The maximum number of ancestors to include.
  • Limit the number of descendants
    • 50 default. The maximum number of ancestors to include.


Include

Fig. 11.5.9 Family Lines Graph - Graphs - Include - tab default options
  • Include Gramps ID: Whether (and where) to include Gramps IDs.
    • Do not include (default)
    • Share an existing line
    • On a line its own
  • Include dates: date of birth, date of death, and marriage dates will be included in the graph when this is selected.
  • Limit dates to years only: from the above only show the years.
  • Include places: place of birth, place of death, and place of marriage will be included in the graph when this is selected.
  • Include the number of children: marriage text will include the total number of children when this is selected.
  • Include thumbnail images of people (checkbox checked by default)
  • Thumbnail location:
    • Above the name (Default)
    • Beside the name


Family Colours

Fig. 11.5.10 Family Lines Graph - Graphs - Family Colours - tab default options
  • Family colors: Select the color to use for people with a specific surname. Two columns are available: Surname and Color. Click on STOCK_ADD or STOCK_REMOVE 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

Fig. 11.5.11 Family Lines Graph - Graphs - Individuals - tab default options

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.
  • 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).


Hourglass Graph

Fig. 11.5.12 Hourglass Graph - Graphs - example output overview

Generate an hourglass graph using the Graphviz generator. Go to Reports -> Graph -> Hourglass Graph....
See also common options

Report Options

Fig. 11.5.13 Hourglass Graph - Graphs - Report Options - tab default options
  • Center Person: the person for the middle of the graph.
  • Name format:
    • Surname, Given Suffix (default)
  • Max Descendant Generations: default 10
  • Max Ancestor Generations: default 10
  • Include Gramps ID:
    • Do not include (default)
  • Translation:
    • Default


Report Options (2)

Fig. 11.5.14 Hourglass Graph - Graphs - Report Options (2) - tab default options
Gramps-notes.png

Please update or expand this section.



Graph Style

Fig. 11.5.15 Hourglass Graph - Graphs - Graph Style - tab default options
  • Graph coloring: Males will be shown with blue, females with red. If the sex of an individual is unknown it will be shown with gray. Options are:
    • B&W outline
    • Colored outline
    • Colour fill (default)
  • Use rounded corners: Use rounded corners to differentiate between women and men on a black and white version. (checkbox unchecked by default)


Relationship Graph

Fig. 11.5.16 Relationship Graph - Graphs - example output overview

The Relationship Graph creates a complex relationship graph in Graphviz format.

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

Report Options

Fig. 11.5.17 Relationship Graph - Graphs - Report Options - tab default options

Some important options here:

  • Filter: Standard options here are the entire database (not recommended!), Descendants of, Descendant families of, Ancestors of, People with common ancestor with, or a custom made filter.
  • Filter Person: If you use a custom filter, no Person can be chosen. Otherwise choose the correct person here. There are several tick boxes here:
    • Include Birth, Marriage and Death dates
    • Limit dates to years only
    • Use place when no date
    • Include URLs
    • Include IDs
    • Include thumbnail images of people: checking this box gives you another input field Thumbnail Location
  • Thumbnail Location: only active when last check box was checked: above or beside the name are the possibilities
Gramps-notes.png

Please update or expand this section.



Report Options (2)

Fig. 11.5.18 Relationship Graph - Graphs - Report Options (2) - tab default options
Gramps-notes.png

Please update or expand this section.



Include

Fig. 11.5.19 Relationship Graph - Graphs - Include - tab default options
  • Dates and /or Places:
    • Include (birth, marriage, death) dates, and place (default)
  • Include URLs (checkbox unchecked by default)
  • Include Gramps ID:
    • Do not include (default)
  • Include relationship to center person (checkbox unchecked by default)
  • Include thumbnail images of people (checkbox unchecked by default)
  • Thumbnail Location:
    • Above the name (default)


Graph Style

Fig. 11.5.20 Relationship Graph - Graphs - Graph Style - tab default options
  • Graph coloring: Males will be shown in blue, females with red. If the sex of an individual is unknown it will be shown with gray. Options are:
    • Color fill(default)
    • Colored outline
    • B&W outline
  • 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)
  • Use rounded corners: Use rounded corners to differentiate between women and men (checkbox unchecked by default)
  • Indicate non-birth relationships with dotted lines: Non-birth relationships will show up as dotted lines in the graph. (checkbox checked by default)
  • Show family nodes: Families will show up as ellipses, linked to parents and children. (checkbox checked by default)

You can find a detailed explanation in a tutorial How to make a relationship chart

Example

Fig. 11.5.21 Relationship Graph - Graphs - example output overview

Let us make a simple example. We want a relationship graph with the Descendant Families of a certain person.

  1. First check that this person is the active person. (You change this later but this is handier)
  2. Go via the menu Reports->Graphs->Relationship Graph...
  3. Papersize : A4 metric landscape: we know there will be not too many people on the graph, so this is ok
  4. Report Options: filter: Descendant Families of... check include dates, limited to years and we want ID's as well
  5. Graph Style : Color fill, rounded corners and show Family Nodes
  6. Graphviz Layout: Font size: 15 pts FreeSans Direction: top to bottom
  7. Graphviz Options: Fill given area dpi 133
  8. Note : we add title on the top size: 18 pts
  9. Output Format: we want a JPEG file and after making of the graph to open a Image Viewer.

The result is shown here.



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: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known conventions