Difference between revisions of "Addon:NetworkChart"

From Gramps
(NetworkChart)
(Usage)
Line 26: Line 26:
 
==Usage==
 
==Usage==
  
 +
===Main===
 
The main menu...
 
The main menu...
  
 
[[File:Network_chart_menu_Main.png|thumb|caption]]
 
[[File:Network_chart_menu_Main.png|thumb|caption]]
 +
 +
===Trim===
 +
====Center Person====
 +
This is an option in selecting the portion of the database to display.  Selecting a center person and radius for the graph will isolate the graph to just that selected person and anyone within the radius.  The radius is the maximum allowable steps or edges between the center person and anyone else in the graph.  All others outside of the maximum steps or edges will not be shown.  Any connection via parent, child, or marriage counts as a step or edge.
 +
 +
====Trim Groups====
 +
sometext= "This option will trim smaller groups/trees that are disconnected. "\
 +
    "You must enter the minimum number of individuals in a group/tree to display.  "\
 +
    "For databases with more than 1500 individuals this option is required and the "\
 +
    "minimum number is set to 2.  This will force all disconnected single individuals "\
 +
    "to be removed from the graph.  Selecting a number greater than the largest group/tree "\
 +
    "will return only the largest tree or those trees that are equal in size."
 +
wraptext = textwrap.wrap(sometext,width=40)

Revision as of 05:05, 6 March 2017

NetworkChart

NetworkChart is a website plugin for Gramps. The objectives of NetworkChart are:

Menu
  • Generate a single graph showing connectivity between individuals
  • Clickable nodes (individuals) that contain a hyperlink for a visual index
  • Display connectivity paths and highlight them

The default output is a Scalable Vector Graphics (SVG) file that can be viewed in a browser. NetworkChart uses the python networkx module to assist in selecting what to display. To access the NetworkChart plugin use the following menu option Reports > Webpages > NetworkChart...

Prerequistes

Requires the following to be installed:

 pip install networkx

To get "libcgraph" for pygraphviz you first need to install the development package of graphviz eg:

 apt install graphviz-dev
            or
 dnf install graphviz-devel

then run:

 pip install pygraphviz

Usage

Main

The main menu...

caption

Trim

Center Person

This is an option in selecting the portion of the database to display. Selecting a center person and radius for the graph will isolate the graph to just that selected person and anyone within the radius. The radius is the maximum allowable steps or edges between the center person and anyone else in the graph. All others outside of the maximum steps or edges will not be shown. Any connection via parent, child, or marriage counts as a step or edge.

Trim Groups

sometext= "This option will trim smaller groups/trees that are disconnected. "\

   "You must enter the minimum number of individuals in a group/tree to display.  "\
   "For databases with more than 1500 individuals this option is required and the "\
   "minimum number is set to 2.  This will force all disconnected single individuals "\
   "to be removed from the graph.  Selecting a number greater than the largest group/tree "\
   "will return only the largest tree or those trees that are equal in size."

wraptext = textwrap.wrap(sometext,width=40)