Addon:Display relations and distances with the home person

This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager. Please use carefully on data that is backed up, and help make it better by reporting any 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.

You can only manually install this tool. See Addon:Display_relations_and_distances_with_the_home_person#Issues

Relation identifiant - calculated relation - name of the person - generation up - generation down - common relation identifiant - rank - period

The Display relations and distances with the home person addon tool is a simple interface for Gramps Relationship Calculator.

It just sets a relation ID for mapping relations according to your locale and data (deep search).

An additional period entry (if exists) is linked to individuals as information.

Sorting function is available on all columns, as well as resizing (column, window).

Usage

Select Tools > Analysis and Exploration > Display relations and distances with the home person... from the menu.

Filter on related persons

A progress meter will display the number of persons after a application of the 'Related' filter rule on the all people registered into the Family Tree.

On the attached screenshot :

• The pass is checking 1615 on 1844 persons related to the central person (standard filter rule)
• Estimated time process is 5 secondes and remaining time is 0
• 20 persons are matching for a total of 2157 persons into the Family Tree
• Checking one person needs ~0,003 secondes ; 0,025 sec./individual might be a too long process

If it becomes too long or if the estimation sounds too large, we can safety close the progress meter and window, as this tool reads the database in a read only state.

Save and export

Select the Save button at the bottom of dialog to export the content after calculations via file generation to OpenDocument Spreadsheet (.ods) format.

CLI

Run via CLI and debug statements:

$ gramps -O 'example' -a tool -p name=relationtab

$ python3 Gramps.py -O 'example' -a tool -p name=relationtab -d "relation_tab"

Design

• relationships_identifiers are set on number.py module
• ancestors numbering is based on sosa/kekule model
• descendants numbering is based on matrilineality kinship
• most recent ancestors are most recent mothers

Issues

RelID is an experimental analysis and exploration tool. Need some cleanup and a global orientation, feel free to modify it.

This addon is not available on Gramps builtin addons listing and can be installed manually from:

• https://github.com/gramps-project/addons-source/tree/maintenance/gramps60/RelID

Performances

• On this addon, iteration with sqlite 3.8.2 database backend seems at least 30 % slower than iteration with bsddb 6.0.1.
• Simple counters are displayed when iteration is passing more than 100 items (useful for debug and if user wants to cancel a too large process)

Deep generations Try to limit deep search (generations set on Preferences) for large table of people.

Test

1. Import testdb120000.gramps with 124 032 individuals, into a new Family Tree.
2. Need to set a default person; According to limits set on Preferences, the maximum for deep generations is 20 (max level)
3. Set Nielsen, Martha as the default person : Bad choice... Not related people!
4. Set Oavenport, Simeon C. as the default person:

• Find 112 persons in 3.376831329000197 seconds
• total process time is around 9 seconds

=> 2/3 for filtering and calculations ; 1/3 for iteration and display

If max_level for deep generations is set to 5:

• Find 104 persons in less than 3 secondes
• total process time is around 7 secondes!

=> ~1/2 for filtering and calculations ; 1/2 for iteration and display

To check

• step descendants may have a mistake on most recent mother number if they are direct descendants of the father.

To do

• fix modal window
• Use gramps.plugins.lib.librecurse module or advanced lib like pypedal

Genesis and history

• 4169: To generate numbering class
• 7955: Show Kekule numbering in different views

See also

• How to find the relationship between people
• The Not Related report (reports Persons not directly or indirectly connected to the Tree branch of the Active Person)
• Genealogical Numbering Systems supported in Gramps
• The Relationship Calculator
• The Relationship to home person Display Preferences option for the Status bar
• Relation to Home Person quick view.
• The Deep Connections gramplet: If this third party addon is installed, it will list the intervening generations through the sibling offspring of a common ancestor. (But it does not list the common ancestor or whether both persons are connected through the same spouse.) The Gramplet also details the indirect relationships.
• Network Chart Web report: If this third party addon is installed, and you use the Highlight preferences tab show only path(s) set to "Direct" option to show a direct path between the two individuals selected and display only that path if available.
• Relationship path filters
• Kinship report