Difference between revisions of "Addon:Graph View"

From Gramps
Jump to: navigation, search
m (Fix image)
(Prerequisites)
(33 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Image:Graph_view.jpg]]
+
{{Third-party plugin}}
  
== What is GraphView ==
+
[[File:Graph-View-plugin-addon-example-42.png|500px|thumb|right|Graph View - plugin addon - In action]]
  
GraphView is a new view plugin that presents a navigable descendant tree using the current active person as a starting point. Clicking another person in the tree will make that person the active person and will redraw the tree based on them.
+
== What is Graph View ==
 +
 
 +
'''Graph View''' is a {{icon|ance}} {{man label|Charts}} category view addon that presents a navigable descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.
  
 
== Features ==
 
== Features ==
  
* Interactive
+
* Interactive.
* The active person is highlighted
+
* The active person is highlighted.
* Clicking a person will redraw the tree based on that person
+
* Clicking a person will redraw the family tree based on that person.
* Clicking the active person will show the parent family of the active person, thereby allowing previous generations to be shown
+
* Clicking the active person will show the parent family of the active person, thereby allowing previous generations to be shown.
* The view can be panned by using mouse click and drag. Select the background of the tree and drag the mouse to pan the view
+
* The view can be panned by using mouse click and drag. Select the background of the tree and drag the mouse to pan the view.
* The view can be zoomed using a slider
+
* The view can be zoomed using the slider.
 +
* A right mouse click on a person or family node shows the person or family editor as appropriate.
 +
* Right click a family to add or delete a spouse or child.
 +
* The view redraws in response to changes made to a person or family.
 +
 
 +
== Configure Options ==
 +
You can change the following:
 +
 
 +
*Layout
 +
**{{checkbox|1}}{{man label|Show images}} (checkbox selected by default)
 +
**{{checkbox|1}}{{man label|Highlight the home person}} (checkbox selected by default)
 +
**{{checkbox|0}}{{man label|Show full dates}} (checkbox unselected by default)
 +
**{{checkbox|0}}{{man label|Show places}} (checkbox unselected by default)
  
== Installation ==
+
*Colors
 +
**{{man label|Home person color:}} '''<code>#bbe68a</code>'''(default)
  
The GraphView plugin can be installed by downloading [https://gramps-addons.svn.sourceforge.net/svnroot/gramps-addons/download/GraphView.addon.tgz GraphView.addon.tgz] and extracting the contents of the file to your Gramps .plugins directory.
+
== Prerequisites ==
Graphview also requires the following to be installed:
+
Before '''Graph View''' can be used you will need the following installed:
* Graphviz. If you can run the Gramps Graph reports then you already have this installed.
+
* Graphviz. If you can run the Gramps [[Gramps_4.2_Wiki_Manual_-_Reports_-_part_5|Graph reports]] then you already have this installed.
* [http://live.gnome.org/PyGoocanvas PyGoocanvas]
+
* [http://live.gnome.org/PyGoocanvas PyGoocanvas] (Gramps3) or [https://wiki.gnome.org/Projects/GObjectIntrospection Goocanvas2 or gir1.2-goocanvas] (Gramps4)
 
* [http://live.gnome.org/GooCanvas Goocanvas]
 
* [http://live.gnome.org/GooCanvas Goocanvas]
 +
 +
All of these should be available in common Linux distributions.
 +
 +
For example, Debian packages Goocanvas/PyGoocanvas as libgoocanvas3 and python-pygoocanvas.
 +
 +
=== Note ===
 +
 +
;Linux Mint Debian Edition (LMDE)
 +
These packages are not available for Linux Mint Debian Edition (LMDE). You can download these as .deb files from [https://launchpad.net/ubuntu/+source/goocanvas-2.0/2.0.2-0ubuntu2 launchpad] and install them in the usual manner. You need the Binary packages shown at the bottom of that pages, except for the development libraries.
 +
 +
Please make sure to download these for the proper architecture, like amd64 for 64-bit PCs (Intel included).
 +
 +
;Opensuse
 +
You may need to install <i>typelib-1_0-GooCanvas-2_0</i> as mentioned in issue {{bug|8076}}.
 +
 +
== Issues ==
 +
* See work around in {{bug|8506}} to enable saving of GraphView charts.
 +
* The larger the number of people in the Family Tree the longer the chart will take to appear eg: about 7000 people takes 10 minutes.
 +
 +
[[Category:Plugins]]
 +
[[Category:Developers/General]]
 +
[[Category:Views]]

Revision as of 06:31, 13 August 2015

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.


Graph View - plugin addon - In action

What is Graph View

Graph View is a Charts Charts category view addon that presents a navigable descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.

Features

  • Interactive.
  • The active person is highlighted.
  • Clicking a person will redraw the family tree based on that person.
  • Clicking the active person will show the parent family of the active person, thereby allowing previous generations to be shown.
  • The view can be panned by using mouse click and drag. Select the background of the tree and drag the mouse to pan the view.
  • The view can be zoomed using the slider.
  • A right mouse click on a person or family node shows the person or family editor as appropriate.
  • Right click a family to add or delete a spouse or child.
  • The view redraws in response to changes made to a person or family.

Configure Options

You can change the following:

  • Layout
    • Show images (checkbox selected by default)
    • Highlight the home person (checkbox selected by default)
    • Show full dates (checkbox unselected by default)
    • Show places (checkbox unselected by default)
  • Colors
    • Home person color: #bbe68a(default)

Prerequisites

Before Graph View can be used you will need the following installed:

All of these should be available in common Linux distributions.

For example, Debian packages Goocanvas/PyGoocanvas as libgoocanvas3 and python-pygoocanvas.

Note

Linux Mint Debian Edition (LMDE)

These packages are not available for Linux Mint Debian Edition (LMDE). You can download these as .deb files from launchpad and install them in the usual manner. You need the Binary packages shown at the bottom of that pages, except for the development libraries.

Please make sure to download these for the proper architecture, like amd64 for 64-bit PCs (Intel included).

Opensuse

You may need to install typelib-1_0-GooCanvas-2_0 as mentioned in issue 8076.

Issues

  • See work around in 8506 to enable saving of GraphView charts.
  • The larger the number of people in the Family Tree the longer the chart will take to appear eg: about 7000 people takes 10 minutes.