5,875
edits
Changes
m
{{out of date}}How to make a relationship chart (for either ancestors, descendants, ...) with Gramps 45.x. and the [[Gramps_4.1_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship graph report]].[[ImageFile:RelationshipChartDescendants-example-41.png|right|thumb|300px|An example chart]]
→Before you start
{{languages|Howto: Make a relationship chart}}
== Before you start ==
The Relationship graph report uses the GraphViz backend, which should already be installed, if not you will need to install [http://graphviz.org graphviz[Output_formats#Graphviz|GraphViz]] (on linuxLinux, use your package manager).
Gramps can produce charts, but to view them, you need other programs. We recommend that you install the following:
* [http://graphviz.org [Output_formats#Graphviz|GraphViz]]: '''required''' for the creation of the relationship charts* [httphttps://www.inkscape.org/ Inkscape]: for viewing and editing svg charts, export to png* [httphttps://www.gnu.org/software/gv/ gv], [http://linuxappfinder.com/package/kghostview kghostview]: for viewing ps charts
* ps2pdf: for converting ps to pdf
* [httphttps://www.adobe.com/products/acrobat/readstep2.html adobe reader], [httphttps://linuxappfinderkpdf.com/packagekde.org/kpdf kpdf]: for viewing pdf charts* [httphttps://www.libreoffice.org/download LibreOffice] or [httphttps://www.openoffice.org/ OpenOffice] or [http://www.calligra-suite.org/ Calligra]: for viewing odt documents
== Filters: what persons to print ? ==
In Gramps you can define filters to make a selection of individuals, see [[Example_filters| Examples of filters]]. In the relationship chart all custom person filters you made will be available, as well as the standard descendants and ancestors filters. These last start from the active person.
{{man tip|Tip|You can add [[Step_relationships|stepchildren]] to a family stepchildren :|by setting the relationship of ''Relationship to Mother'' (or Father) for the child to ''stepchild'' in the mother [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Child_Reference_Editor|Child Reference Editor]]. The other parent's Relationship should remain set to ''step childBirth''. In doing so, these children will be become part of a descendant report without the need to create a custom filter to include them.}}
=== How many people ?===
== Example 1-A: a descendant chart ==
[[File:RelationshipChartDescendants-example-41.png|right|thumb|220px|A descendant chart, click for details]]Download Use the [[https://raw.githubusercontent.com/gramps-project/gramps/maintenance/gramps41/example/gramps/example.gramps ]] that came with your install, or download [[example.gramps]], save to a file, create a new database in Gramps called example, and import the example.gramps data into it.
If not the case, set the active person to ''Garner von Zieliński, Lewis Anderson Sr''.
Select '''OK''' to generate the chart.
The result can be seen to the right. You can use print this on a dedicated printer (If required change the '''GraphViz Options''' DPI of png file.), or if you use the default DPI of 72 you can use this image on a website to share. In the last example below, you can use the tip explained in [[Make flash plugin from a png]], to make the resulting graph easier to navigate.
In the chart image, males are blue, females are pink and the yellow balloons indicate a family node in which a marriage date is printed (if known). You can select not to see this family node by deselecting in the '''Graph Style''' tab the option ''Show family nodes''.
== Example 2: A chart with ancestors, descendants and their families ==
{{stub}}<!--example 2 & 3 and section below them still need a bit of an update-->{{man note|Note:|This example uses filters. |See [[Example filters| Examples of filters]] for an introductory example.}}
<!-- Can not find Cristiansen, Frances in example.gramps -->
Open the file example.gramps and select Cristiansen, Frances as the active person.
== Example 3: Generating the graph by using the Graphviz command line tool ==
{{man tip|Tips|Some tips around about GraphViz |are [https://web.archive.org/web/20170625040922/http://bernaerts.dyndns.org/linux/74-ubuntu/287-ubuntu-graphviz-viewer-gnome-thumbnailer available].}} {{man warn|Bugged version|[http://graphviz.org Graphviz] (v2.12) has a bug. In order to correctly display the family nodes (yellow balloons), all occurrences of the word ''ellipse'' should be changed to ''egg'' (see [http://www.graphviz.org/bugs/b1078.html bug report 1078]).}}
In the menu, select {{man menu|Reports -> Graphs -> Relationship Graph...}}.
=== Manual changes ===
The Graphviz '''.gv''' dot file is a text file with a well documented structure, (See: [httphttps://www.graphviz.org/Documentation.php documentation/ graphviz.org/Documentationdocumentation] )
digraph GRAMPS_graph
# In Document Options choose SVG as output format.
# Setup paper format to fit graph into one sheet (SVG cannot handle more than one sheet), so choose A0 or custom size.
# Use [httphttps://www.inkscape.org/ Inkscape] for opening SVG graph.
# Menu File/Document properties, use "Fit page to selection" function (fix size accordingly to graph size).
# Menu File/Save as, choose PDF format.
poster -iA0 -mA4 -pA0 posterA0.ps > posterA4.ps
* For Linux, Windows and Mac, you can also use the program [http://posterazor.sourceforge.net/ PosterRazor], which has an easy to use interface.
* For Windows, you can use [httphttps://www.noliturbare.com/pdf-tools/pdf-tiler pdftools.php Govert's PDF Tiler] (can maybe run on Linux too using [httphttps://www.mono-project.com/Main_Page Mono], needs .NET 1.1)
== Troubleshooting ==
*If you encounter bad fonts (missing characters) or wrong fontsizes, see [[Howto:_Make_a_relationship_chart#Example_3:_Generating_the_graph_by_using_the_Graphviz_command_line_tool|Example 3]] on how you can set the font yourself.
*If you have missing lines in Relationship (and other similar) Graph pdf output; then use a larger paper size (or use multiple pages).(See {{bug|10028}})
*If you have a bad resolution of png, eg unreadable text, this is probably because you have set a paper size which is to small. See [[Howto:_Make_a_relationship_chart#Example_1-A:_a_descendant_chart|Example 1-A]]: set the papersize of number of pages to a high number, but select in '''GraphViz Options''', in ''Aspect ratio'': <tt>Fill the given area</tt>, or use <tt>Compress to minimal size</tt>
{{man warn|Reports and custom IDs|After a GEDCOM import, your database can use some non-standard IDs (ie. 123I or 456U not set on {{man menu|Edit --> Preferences --> ID Formats}}). If generated reports do not properly display data, then try [[Gramps_4.1_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps IDs tool]] ({{man menu|Tools->Family Tree Processing->Reorder Gramps IDs}}).}}
== Additional things to try ==
* You can make descendant charts and add them to the media gallery of the person. Like that, the chart is available from the website.
* Offer a chart on your website as a [[Make flash plugin from a png |flash relationship graph]], enabling zooming, moving, ... over your data or just use by using SVG for Firefox and Chrome, see the [[Addon:DenominoViso|DenominoViso]]addon.
== Want to help developing ? Help improve the Graph reports ==If you go through examine the dot specifications, you will note that much more can be done with graphicsGraphViz output. If you have programming skills you can add some functionality:* More/better Improved text in the boxes: what text and how to organize it?* Coloring. See the [[Gramps_4.1_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines Graph]]: for a color per family, for specific relations, for the central person, ...
== Link to the manual See also ==* Also check out the [[Gramps_3.4_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_Reports_Reports_-_part_5#Relationship_Graph |Relationship Graph - User Manual]].
[[Category:Tutorials|Make a relationship chart]]
[[Category:How do I...|R]]