Difference between revisions of "Addon:Display relations and distances with the home person"

From Gramps
Jump to: navigation, search
m (Design)
m (add-on > addon ( stick with one spelling ))
 
(32 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
[[File:RelID.png|thumb|450px|right|Relations identifiants]]
+
{{man note|You can only manually install this tool.<br>See [[Addon:Display_relations_and_distances_with_the_home_person#Issues]] }}
 +
[[File:RelID.png|thumb|450px|right|Relation identifiant - calculated relation - name of the person - generation up - generation down - common relation identifiant - rank - period]]
  
 +
The {{man label|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 ==
 
== Usage ==
 
Select {{man menu|Tools > Analysis and Exploration > Display relations and distances with the home person...}} from the menu.
 
Select {{man menu|Tools > Analysis and Exploration > Display relations and distances with the home person...}} from the menu.
 +
 +
===Save and export===
 +
 +
Select the {{man key press|Save}} button at the bottom of dialog to export the content '''after''' calculations via file generation to OpenDocument Spreadsheet (.ods) format.
  
 
===CLI===
 
===CLI===
Line 13: Line 25:
 
==Design==
 
==Design==
  
*relationships_identifiers are set on number.py module
+
*relationships_identifiers are set on ''number.py'' module
*ancestors numbering is based on sosa/kekule model
+
*ancestors numbering is based on '''sosa/kekule''' model
*descendants numbering is based on matrilineality kinship
+
*descendants numbering is based on '''matrilineality''' kinship
*'most recent ancestors' are 'most recent mothers'
+
*''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.
  
===Save and export===
+
This addon is not available on Gramps builtin addons listing and can be installed manually from:
  
The tool can export the content '''after''' calculations via file generation to OpenDocument Spreadsheet (.ods) format.
+
* https://github.com/gramps-project/addons-source/tree/maintenance/gramps51/RelID
  
==Issues==
 
  
 
===Performances===
 
===Performances===
  
* On this addon, iteration with sqlite 3.8.2 database backend seems at least 30 % slower than iteration wih bsddb 6.0.1.
+
* On this addon, iteration with sqlite 3.8.2 database backend '''seems''' at least 30 % slower than iteration with bsddb 6.0.1.
 
* Average of maximum O.O1 second per person for 5 levels (generations) on modern CPUs.
 
* Average of maximum O.O1 second per person for 5 levels (generations) on modern CPUs.
 +
* Simple counters are displayed when iteration is passing more than 100 items (''useful for [[#CLI|debug]] and if user wants to cancel a too large process'')
  
{{man tip|Deep generations|Try to limit deep search (generations set on Preferences) for large table of people.}}
+
{{man tip|Deep generations|Try to limit deep search (generations set on '''Preferences''') for large table of people.}}
  
 
===To check===
 
===To check===
Line 38: Line 54:
  
 
* fix modal window
 
* fix modal window
* Use gramps.plugins.lib.librecurse module or advanced lib like pypedal.
+
* Use gramps.plugins.lib.librecurse module or advanced lib like pypedal
  
 
==Genesis and history==
 
==Genesis and history==
Line 44: Line 60:
 
*{{bug|4169}}: To generate numbering class
 
*{{bug|4169}}: To generate numbering class
 
*{{bug|7955}}: Show Kekule numbering in different views
 
*{{bug|7955}}: Show Kekule numbering in different views
 +
 +
==See also==
 +
* [[How to find the relationship between people]]
 +
* The [[Gramps_{{Version manual}}_Wiki_Manual_-_Tools#Not_Related|Not Related]] report (reports Persons not directly or indirectly connected to the Tree branch of the Active Person)
 +
* [[Genealogical_Numbering_Systems|Genealogical Numbering Systems]] supported in Gramps
 +
* The '''[[Gramps_{{Version manual}}_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]'''
 +
* The '''Relationship to home person''' [[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar
 +
* '''Relation to Home Person''' [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
 +
* The '''[[Addon:Deep_Connections_Gramplet|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.
 +
* [[Addon:NetworkChart|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.
 +
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Relationship_filters|Relationship path filters]]
 +
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_6#Kinship_Report|Kinship report]]
  
  

Latest revision as of 00:23, 29 March 2022

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.

Gramps-notes.png
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.

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:

$ 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:


Performances

  • On this addon, iteration with sqlite 3.8.2 database backend seems at least 30 % slower than iteration with bsddb 6.0.1.
  • Average of maximum O.O1 second per person for 5 levels (generations) on modern CPUs.
  • 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)
Tango-Dialog-information.png
Deep generations

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


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