Changes

{{man index|Gramps 3.3 Wiki Manual - Reports - part 4|Gramps 3.3 Wiki Manual - Reports - part 6|3.3}}

{{grampsmanualcopyright}}

{{languages|Gramps_3.3_Wiki_Manual_-_Reports - part 5}}

Back to [[Gramps_3.3_Wiki_Manual_-_Reports|Index of Reports]].

{{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 '''Edit --> Preferences --> Identifiants ID'''). If generated reports do not properly display data, then try [[Gramps_3.3_Wiki_Manual_-_Tools#Reorder_GRAMPS_ID|Reorder GRAMPS IDs tool]] ('''Tools-->Database Processing-->Reorder GRAMPS IDs''').}}

[[Image:Familylines.gif|thumb|left|450px|Fig. 8.16 Example of a graph generated using FamilyLines.py, without thumbnail images.]]

[[Image:Familylines with thumbnails.gif|thumb|right|450px|Fig. 8.17 Example of a graph generated using FamilyLines.py, with thumbnail images.]]

{{-}}

The FamilyLines.py plugin was created to generate easy-to-follow graphs. Note that FamilyLines does not display all of the people in the database -- instead, this plugin generates smaller family trees, with many options to try and restrict the number of people included.

A typical use of this plugin is to generate simplified graphs printed on large plotters.

===Options GraphViz===

This plugin uses [http://www.graphviz.org/ GraphViz]. GraphViz takes the .gv files and creates the final files, such as .gif, .png, .pdf, .ps, etc.

This first tab allows several GraphViz options to be set:

* ''Width'': the width, in inches, of the final image. Set to a large number if generating .png or .gif files.

* ''Graph direction'': whether the tree grows from left-to-right, or right-to-left.

* ''Ratio'': GraphViz uses this to determine how to position items. Only trial-and-error will help you determine the best option to use. (When in doubt, '''compress''' tends to work well.)

{{-}}

===People of Interest===

The FamilyLines.py plugin works by starting with a list of "people of interest". This initial list of people is then used to find both ancestors and descendants.

* ''Follow children to determine family lines'': when selected, this causes FamilyLines.py to follow the children of the people of interest.

* ''Try to remove extra people and families'': when selected, this option causes FamilyLines.py to aggressively attempt to remove extra ancestors and families from the family tree.

{{-}}

===Family Colours===

[[Image:Familylines_family.png|thumb|right|350px|Fig. 8.20 Family Colors]]

Select the colour to use for people with a specific surname. Click on "+" or "-" to add a surname. Double-click on a surname to edit the colour.

{{-}}

===Individuals===

* ''Males'', ''Females'', ''Unknown'': the colour to use for people whose surname doesn't match any of the names on the "Family Colours" tab.

* ''Limit the number of parents'': if selected, then the number of ancestors will be limited by the amount shown. This can only be selected if "Follow parents" has also been selected on the "People of Interest" tab.

* ''Limit the number of children'': if selected, then the number of children will be limited by the amount shown. This can only be selected if "Follow children" has also been selected on the "People of Interest" tab.

{{-}}

* ''Include researcher and date'': a label will be placed at the bottom of the graph when this is selected.

* ''Include private records'': people and events marked as private will be included in the graph when this is selected.

{{-}}

===Generating graphs===

Once FamilyLines.py produces the .gv output file (defaults to ''./familylines.gv''), the GraphViz package will be necessary to create the final output file. If GraphViz isn't already installed, you can download it from [http://www.graphviz.org/ http://www.graphviz.org/].

User can set maximum Descendant Generations and maximum Ancestor Generations

==<u>Relationship Graph</u>==

The Relationship Graph creates a complex relationship graph in GraphViz format and then converts into graphical output running it through the GraphViz ''dot'' tool behind the scene. Specific options for this report include filter, options for dates and places for the events, and whether to include URLs and IDs for individuals and families. There are also several GraphViz-specific options related to pagination, color, and details of the graph.

This plugin uses [http://www.graphviz.org/ GraphViz]. GraphViz takes the .gv files and creates the final files, such as .gif, .png, .pdf, .ps, etc.

===Graph Options===

Via the menu: {{man label|Reports->Graphs->RelationshipGraph...}}. You will be presented a {{man label|Relationship Graph}} window where you can change all the settings.

The window is divided into two parts. One part provides for all the different tabs available, the other part has the {{man label|Document Options}}.

===Paper Options===

[[Image:Relgraf1.png|right|250px|thumb|Fig. 8.24 paper Options]]

===Report Options===

[[Image:Relgraf2.png|right|thumb|250px|Fig. 8.25 Report 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 custum made filter.

===Graph Style===

[[Image:Relgraf3.png|right|thumb|250px|Fig. 8.26 Graph Style]]

*''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:

** Colored outline

===GraphViz Layout===

[[Image:Relgraf4.png|right|thumb|250px|Fig. 8.27 GraphViz Layout]]

*''Font family'': Choose the font family. If international characters don't show, use '''FreeSans''' font. FreeSans is available from [http://www.nongnu.org/freefont/ the NonGNU org].

** Default

===GraphViz Options===

* ''Aspect Ratio'': '''Affects greatly''' how the graph is layed out on the page.

** Minimal Size

===Note===

* Note to add to the graph: This text will be added to the graph

* Note Location : Whether the note will appear on top or bottom of the page

* Note size: The size of note text, in points

===Document Options===

===''.gv'' files===

If you use {{man label|.gv}} files you must realize that those files are meant to be processed by other programs. By themselves, the files will not provide meaningful information; the files must first be processed by another program.

So make sure you have '''Graphviz''' installed. Use your package manager on Linux.

On Ubuntu Karmic the actual version is '''2.20.3'''. The file is only 1.2 MB and provides a lot of commands like: ''dot'', ''gvcolor'', ''dijkstra'' ....

Ubuntu Gutsy users can get the deb package via Synaptic or the command line (actual version GraphViz 2.20)

# First check that this person is the ''active person''. (You change this later but this is handier)

# Report Options: filter: Descendant Families of... check include dates, limited to years and we want ID's as well

# GraphViz Layout: Font size: 15 pts FreeSans Direction: top to bottom

# GraphViz Options: Fill given area dpi 133

# Output Format: we want a JPEG file and after making of the graph to open a Image Viewer.

Back to [[Gramps_3.3_Wiki_Manual_-_Reports|Index of Reports]].

[[Category:Documentation]]