5,875
edits
Changes
m
This is a Howto on how to make a relationship chart (can be ancestors, descendants, ...) with GRAMPS 2.2.x. and the Relationship plugin.[[Image:RelationshipChartDescendants.png|right|thumb|300px|An example chart]]== Before you start ==
[[Category:Tutorials|Make a relationship chart]] == Before you start ==GRAMPS 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
'''{{man menu|Reports -> Graphical reports Graphs -> Relationship graphGraph...}} In the Bottom dialog:* '''Document Options''' set the '''Output Format''' to .png
In the dialog, set the format to .png and chose Chose the following in the tabs available:#'''Paper Options '''-> Size : Custom Size (Set width and height to ''10000 '' cm, or some other large value)#'''Report Options '''-> ''Filter: '' '''Descendants of Garnervon Zieliński, Lewis Andersson Anderson Sr''' #'''GraphViz Layout optons '''-> ''Graph Direction:'' '''Horizontal (<-)'''#'''GraphViz Options'''-> ''Aspect ratio: '' '''Compress to minimal size'''
(I sometimes experience problems setting the sizes in the Paper options dialog. A workaround is Select '''OK''' to use generate the example using graphviz code in example 3 belowchart.)
[[Image:RelationshipChartAncestors_small.png|left|thumb|350px|Fig. An ancestor chart. For the detailed image, [[Media:RelationshipChartAncestors.png| click here (853kb!)]]]] Download and open the example.gramps file as in Example 1 -A
[[Image:RelationshipChartAncestorsAndDescendants_small.png|right|thumb|450px|Fig. A large chart. For the detailed image, [[Media:RelationshipChartAncestorsAndDescendants.png| click here (363kb{{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 -->
Select in file formatIn the Bottom dialog: graphviz * '''Document Options''' set the '''Output Format''' to ''Graphviz file'', which defaults to the gv extension. This fileis then a dot file which can be processed by graphvizGraphviz.
...then the actual Gramps data are shown: I0585 [ shape="box" fillcolor="#e0e0ff" style="solid,filled" label="Kristensen, John Francis\"Chick\"\n(1889-10-10 - 1938-10-23)" ];
then the actual GRAMPS data are shown:
I3493 [ shape="box" fillcolor="pink" style="solid,filled" label="Blancke, Charlotte\n(1801)" ];
...
== Link to the manual ==[[Category:Tutorials|Make a relationship chart]]Also check out the [http[Category://wwwHow do I.gramps-project.org/wiki/index.php?title=Gramps_3.0_Wiki_Manual_-_Reports#Relationship_Graph Wiki Manual|R]].
→Before you start
{{languages|Howto: Make a relationship chart}}
How to make a relationship chart (for either ancestors, descendants, ...) with Gramps 5.x. and the [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship graph report]].[[File:RelationshipChartDescendants-example-41.png|right|thumb|300px|An example chart]]
The Relationship graph report is made with uses the graphviz GraphViz backend, so 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).
* 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.documentfoundationlibreoffice.org/download/ LibreOffice] or [http://www.openoffice.org/ OpenOffice] or [httphttps://www.kofficecalligra.org/ kofficeCalligra]: for viewing odt documents
== Filters: what persons to print ? ==
=== What are filters?===
In GRAMPS 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 ==
[[ImageFile:RelationshipChartDescendants-example-41.png|right|thumb|200px220px|A descendant chart, click for details]]Download Use the [[http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/example/gramps/data.gramps?view=markup&pathrev=10822 ]] that came with your install, or download [[example.gramps]], on this page use the {{man label|Download}} linksave to a file, create a new database in GRAMPS Gramps called example.grdb, and import the example.gramps data into it.
If not the case, set the active person to ''Garnervon Zieliński, Lewis AndersonSr''.
To make a descendant chart with the relationship report, choose the menu item
The result (using gramps 2.2.7) can be seen to the right. You can use print this on a dedicated printer (check dpi 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 case, you can use the trick explained in [[Make flash plugin from a png]], to make the resulting graph easier to navigate.
In the chart image you see , males in are blue, females in 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 '''Graphviz OptionsGraph Style''' tab the option ''Show family nodes''.
== Example 1-B: a chart with ancestors ==
Set ''Warner, Carl Thomas'' to be the active person.
Repeat the process in Example 1-aA, but choose the filter ''Ancestors of Warner, Carl Thomas'' this time. You can see the result to the left.
[[File:RelationshipChartAncestors small.png|right|thumb|300px|Example Relationship ancestor chart. (For the detailed image, [[Media:RelationshipChartAncestors.png| click here (1.49mb!))]]]]
You can see the result to the right.
This is already an extremely large graph.
It can only be readily viewed in a good image viewer.
For printing you need to resort to printing on several pages, or you need access to a large plotter.
{{-}}
== Example 2: A chart with ancestors, descendants and their families ==
Open the file example.gramps and select Cristiansen, Frances as the active person.
* ''Ancestors of <person>'' choose Christiansen, Frances and check <tt>inclusive</tt>.
* ''Descendants of <person>'' chose Christiansen, Frances
Make sure that "At least one rule must be fulfilled" is chosen, so that we get both ancestors and descendants!
Now we create the filter we will actually use for the report. It will be based on the previous filter: Create a new filter, called '''Frances2'''. This filter should contain the rules:
* ''Siblings of filter'' Frances1
* ''Spouses of filter'' Frances1
Now close the filter editor, and follow the instructions given in Examples 1a and 1b, but this time choosing the filter '''Frances2''' in the '''Report Options''' tab.
[[Image:RelationshipChartAncestorsAndDescendants_small.png|right|thumb|450px|Fig. A large chart. For the detailed image, [[Media:RelationshipChartAncestorsAndDescendants.png| click here (363kb!)]]]]
The result is visible to the right (363kb, large file !)
{{-}}
== Example 3, : Generating the graph by using the Graphviz command line tool ==
{{man tip|style="width:80%;margin-top:+.7em;margin-bottom:+.7em;background-color: #c0f0ff;border:1px solid #ccc; padding: 5px" align="center"Some tips about GraphViz|-|[[Image:Gnome-important.png]]|<center style="font-size:100%">'''Note:''' The current stable version of are [httphttps://graphvizweb.archive.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 [/web/20170625040922/http://wwwbernaerts.graphvizdyndns.org/bugslinux/b1078.html bug report 107874-ubuntu/287-ubuntu-graphviz-viewer-gnome-thumbnailer available]).</center>|}}
In the menu, select '''{{man menu|Reports -> Graphs -> Relationship Graph...'''}}.
Eg, to make from the gv file a ps file, Gramps uses:
=== Manual changes ===
The Graphviz '''.gv''' dot file is a text file with a well explained documented structure, for extra info(See: [httphttps://www.graphviz.org/Documentation.php www.documentation/ graphviz.org/documentation])
digraph GRAMPS_graph
bgcolor=white;
center="true";
charset="iso-8859-1utf8";
concentrate="false";
dpi="7572"; graph [fontsize=1214]; ....
You can optimize the layout by making changes in the file.
*For paper size: look for the "page" (paper size) and "size" (area of paper to use), and change these to '''some large values'''. This is important as otherwise the figure will be wrongly scaled giving bad and the picture quality will be poor (eg unreadable text).
*You can also change the font by adding a font family. Look for the lines
node [style=filled fontsize="12"];
dot -Tjpg -oreport.jpg report.dot -v
...
Activated plugin library: libgvplugin_pango.so.5
Using textlayout: textlayout:cairo
Using render: cairo:cairo
Using device: jpg:cairo:gd
...
== Printing large graphs ==
# 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 Exampe [[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 '''Layout GraphViz Options''', in ''Aspect ratio'': <tt>automatically use optimal number pagesFill 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 --> Identifiants ID'''Formats}}). If generated reports do not properly display data, then try [[Gramps_3.0_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_Tools#Reorder_GRAMPS_IDReorder_Gramps_ID|Reorder GRAMPS Gramps IDs tool]] ('''{{man menu|Tools-->Database Family Tree Processing-->Reorder GRAMPS Gramps IDs'''}}).}}
== Further cool Additional things to do 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 Offer a chart on your website as a by using SVG for Firefox and Chrome, see the [[Make flash plugin from a png Addon:DenominoViso|flash relationship graphDenominoViso]]addon. == Help improve the Graph reports ==If you examine the dot specifications, enabling zoomingyou will note that much more can be done with GraphViz output. If you have programming skills you can add some functionality:* Improved text in the boxes: what text and how to organize it?* Coloring. See the [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_5#Family_Lines_Graph|Family Lines Graph]]: for a color per family, movingfor specific relations, ... over your data or just use SVG for Firefox and Operathe central person, see [http://www.gramps-project.org/wiki/index.php?title=UnsupportedPlugins#DenominoViso_-_HTML_Ancestors_page DenominoViso]
== Want to help developing ? See also ==If you go through the dot specifications, you will note that more can be done with graphics. If you have programming skills you can add some functionality:* more/better text in the boxes: what text and how to organize it?* coloring. See the [[Familylines pluginGramps_{{man version}}_Wiki_Manual_-_Reports_-_part_5#Relationship_Graph|Relationship Graph - User Manual]]: a color per family, for specific relations, for the central person, ...