Difference between revisions of "Addon:Consanguinity Gramplet"

From Gramps
Jump to: navigation, search
m (Usage)
m (Example: reposition the diagram to where it is described)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{Languages|Addon:Consanguinity_Gramplet}}
 
{{Languages|Addon:Consanguinity_Gramplet}}
 
{{Third-party plugin}}
 
{{Third-party plugin}}
[[Gramps_Glossary#gramplet|Gramplet]] to show [https://wikipedia.org/wiki/Pedigree_collapse pedigree collapse] and spousal [[Genealogy_Glossary#consanguinity|consanguinity]] for the [[Gramps_Glossary#active_person|Active Person]].
+
{{man warn|Unreleased addon|You may install the [https://github.com/hgboldt/consanguinity addon manually if you are interested in helping to test and report issues].}}
 +
The {{man label|Consanguinity Gramplet}} shows [https://wikipedia.org/wiki/Pedigree_collapse pedigree collapse] and spousal [[Genealogy_Glossary#consanguinity|consanguinity]] for the [[Gramps_Glossary#active_person|Active Person]].
  
 
== Usage ==
 
== Usage ==
 
[[File:ConsanguinityNotebook.png|thumb|right|267px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Consanguinity Gramps - Notebook mode]]
 
[[File:ConsanguinityNotebook.png|thumb|right|267px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Consanguinity Gramps - Notebook mode]]
 +
The {{man label|Consanguinity Gramplet}} displays information about the [[Gramps_Glossary#active_person|Active Person]] and any spouses.
  
The Consanguinity gramplet is an add-on for the People views of Gramps. (When installed, this gramplet will be a [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#The_split-screen_Sidebar_.26_Bottombar|sidebar/bottombar option]] for the following views: {{icon|peop}}People, {{icon|rela}}Relationships, {{icon|ance}}Charts, and {{icon|geog}}Geography.) 
+
The Gramplet is updated whenever the Active Person focus shifts.  
  
Select the {{man label|Consanguinity}} menu option from the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|Gramplet selection menus]] after pressing the {{man button|∨}} (''Down Arrowhead'' button) in the view's sidebar or bottombar.
+
However, any open Pedigree and pedigree collapse diagram windows remain unchanged. This allows them to be used for navigating the Active Person focus and for direct comparison to windows opened on other persons.
 +
 
 +
=== Adding the Consanguinity Gramplet ===
 +
The {{man label|Consanguinity Gramplet}} is designed to be added to the sidebar {{icon|rela}}[[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Relationships_Category|Relationships Category]] (''Grouped'' or ''List'') view modes of Gramps. (After [[{{man version}}_Addons#Manually_installed_Addons|manually installing]]<!--[[Third-party_Addons#Installing_Addons_in_Gramps|installation]]-->, this gramplet will be available for addition in all these locations: the [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#The_split-screen_Sidebar_.26_Bottombar|sidebar/bottombar option]] for the following views: {{icon|peop}}People, {{icon|rela}}Relationships, {{icon|ance}}Charts, and {{icon|geog}}Geography.) 
 +
 
 +
Select the {{man label|Consanguinity}} menu option from the {{man label|Add a gramplet}} submenu of the [[Gramps_{{man version}}_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|Gramplet selection menus]]. Accessible by pressing the {{man button|&or;}} (''Down Arrowhead'' button) in the view's sidebar or bottombar.
 +
 
 +
=== Controls ===
 
<!--
 
<!--
 
◉ selected &#128280; deselected
 
◉ selected &#128280; deselected
Line 22: Line 31:
  
 
== Example ==
 
== Example ==
The sample tree included with Gramps includes a few instances of Pedigree Collapse.   
+
The example tree included with Gramps includes a few instances of Pedigree Collapse.   
  
 
So to reproduce this diagram, import the [[Example.gramps|example.gramps]] file to a new tree.  
 
So to reproduce this diagram, import the [[Example.gramps|example.gramps]] file to a new tree.  
  
{{man warn|1=Importing can create a mess!|2=Be careful that you do NOT import example data into your own Family tree. Cleaning out the contamination would be troublesome. Always double-check which tree is already loaded before importing a file.}}
+
{{man warn|1=Importing can create a mess!|2=Be careful that you do NOT import the [[Example.gramps|example.gramps]] data into your own Family tree. Cleaning out the contamination of records related to thousands of fictitious people would be troublesome. Always double-check which tree is already loaded before importing a file.}}
  
Switch to the {{icon|peop}}People View via the navigator bar. Find ''Piatt D. Warner'' and make him the Active Person. (By selecting that row.)  
+
Switch to the {{icon|peop}}People View via the navigator bar. Find ''<code>Piatt D. Warner</code>'' and make him the Active Person. (By selecting that row.)  
  
Switch to the {{icon|rela}}Relationships View via the navigator bar. Add the Consanguinity gramplet to the view's sidebar as described in the [[#Usage|Usage]] section above. Resize the width the sidebar so that the contents fit comfortably.
+
Switch to the {{icon|rela}}Relationships View via the navigator bar. Add the {{man label|Consanguinity Gramplet}} to the view's sidebar as described in the [[#Usage|Usage]] section above. Resize the width the sidebar so that the contents fit comfortably.
 
<!--Detach (undock) the gramplet by dragging its titlebar off the sidebar to the main window of Gramps.  Then arrange the undocked gramplet dialog where it won't interfere with seeing the view's data.-->
 
<!--Detach (undock) the gramplet by dragging its titlebar off the sidebar to the main window of Gramps.  Then arrange the undocked gramplet dialog where it won't interfere with seeing the view's data.-->
{{-}}
+
 
[[File:ConsanguinityDiagram.png|thumb|right|270px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity diagram window (click a Relationship hotlink)]]
 
  
 
[[File:ConsanguinityPedigree.png|thumb|right|258px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity pedigree window (click the {{man button|Display pedigrees}} button)]]
 
[[File:ConsanguinityPedigree.png|thumb|right|258px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity pedigree window (click the {{man button|Display pedigrees}} button)]]
 
=== Explore the common ancestry ===
 
=== Explore the common ancestry ===
  
Since ''Piatt D. Warner'' is the Active Person, the contents of the Consanguinity gramplet will be in the '''Single Pane''' mode (Figure 1 shows the Notebook mode where spouses are on separate pages) and look something like the following section. (Although the gramplet will have hotlinked People and Relationship.) The text below was created by clicking the {{man button|Copy}} button and pasting it into this article.
+
Since ''<code>Piatt D. Warner</code>'' is the Active Person, the contents of the {{man label|Consanguinity Gramplet}} will be in the '''Single Pane''' mode (Figure 1 shows the '''Notebook''' mode where spouses are on separate pages) and look something like the following section. (Although the gramplet will have hotlinked People and Relationship.) The text below was created by clicking the {{man button|Copy}} button and pasting it into this article.
 
<pre>
 
<pre>
 
Warner, Piatt D. (*9 Apr 1821, +11 Oct 1889)
 
Warner, Piatt D. (*9 Apr 1821, +11 Oct 1889)
Line 66: Line 74:
  
 
The hotlinks on the names of People will navigate the focus of Active Person selection to that person.
 
The hotlinks on the names of People will navigate the focus of Active Person selection to that person.
 
+
{{-}}
 
=== The Relationship diagram ===
 
=== The Relationship diagram ===
 +
[[File:ConsanguinityDiagram.png|thumb|right|270px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity diagram window (click a Relationship hotlink)]]
 
Clicking the described {{man label|Relationship}} will open a block diagram of that instance of pedigree collapse and how it relates to the Active Person.  
 
Clicking the described {{man label|Relationship}} will open a block diagram of that instance of pedigree collapse and how it relates to the Active Person.  
  
Line 79: Line 88:
 
A text list is more actionable when sharing with family and other genealogists than a diagram. A diagram makes understanding the relationship easier. But a list can be transcribed into a form or another program more easily.  
 
A text list is more actionable when sharing with family and other genealogists than a diagram. A diagram makes understanding the relationship easier. But a list can be transcribed into a form or another program more easily.  
  
An example of Piatt's pedigree is shown in Figure 3. You will notice that the the lines for ancestors 152 and 153 are marked as being the same as ancestors 68 and 69 (Edward Christiansen and Elizabeth Thomas). This is where there is pedigree collapse for Piatt.  The rest of the list will crop out the ancestors of 152 and 153 because they too are duplicated.   
+
An example of Piatt's pedigree is shown in Figure 3. You will notice that the lines for ancestors 152 and 153 are marked as being the same as ancestors 68 and 69 (Edward Christiansen and Elizabeth Thomas). This is where there is pedigree collapse for Piatt.  The rest of the list will crop out the ancestors of 152 and 153 because they too are duplicated.   
  
 
But which children were the siblings?  Just divide the ancestor number by 2 to get the number of their child. Half of 152 is 76 (Nathanial Christiansen) and half of 68 is 34 (off-screen in Figure 3 but this is Joseph Christiansen).  You can use this method in any Ahnentafel Numbering System. You can also use [https://wikipedia.org/wiki/Ahnentafel#Deductive_reckoning "deductive reckoning"] determine their exact relationship to the #1 person by their number.   
 
But which children were the siblings?  Just divide the ancestor number by 2 to get the number of their child. Half of 152 is 76 (Nathanial Christiansen) and half of 68 is 34 (off-screen in Figure 3 but this is Joseph Christiansen).  You can use this method in any Ahnentafel Numbering System. You can also use [https://wikipedia.org/wiki/Ahnentafel#Deductive_reckoning "deductive reckoning"] determine their exact relationship to the #1 person by their number.   
 
{{-}}
 
{{-}}
 +
 +
== Trickery to Diagram Cousin connections ==
 +
The Consanguinity Gramplet is designed to help determine the various degrees of consanguineous relationships between the Active Person and their spouse(s). It does so in a more comprehensive way than can be found in any other combination of tools in Gramps.
 +
 +
But what if the people you want to compare and contrast are just distant cousins? The Gramplet is not designed to help with that... but you can trick it into helping. Create a temporary family and add the two cousins to be compared. The Edit Family must be closed with the OK button to commit it to the Tree.
 +
 +
When you have explored sufficient, Edit the temporary Family again to remove both people. When the Family Editor window is closed with the OK, the now-empty temporary family will be deleted.
 +
 +
Because the Consanguinity Gramplet was not designed for this purpose, it doesn't handle some relationship situations well.  (As an example: creating a temporary relationship between Ancestor and their Descendant confuses it badly.)
  
 
== See also ==
 
== See also ==
* [https://github.com/hgboldt/consanguinuity Consanguinity source code] in Hans Boldt's GitHub repository
+
* [https://github.com/hgboldt/consanguinity Consanguinity source code] in Hans Boldt's GitHub repository
 
* [[Addon:RelatedRelativesGramplet|Related Relatives Gramplet]] - Display all persons in the database with a relation to a relative. A Gramplet by Heinz Brinker
 
* [[Addon:RelatedRelativesGramplet|Related Relatives Gramplet]] - Display all persons in the database with a relation to a relative. A Gramplet by Heinz Brinker
 
*[[Screenshots|Screenshots]]
 
*[[Screenshots|Screenshots]]

Latest revision as of 16:12, 4 September 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.

Gnome-important.png
Unreleased addon

You may install the addon manually if you are interested in helping to test and report issues.

The Consanguinity Gramplet shows pedigree collapse and spousal consanguinity for the Active Person.

Usage

Fig. 1 Detached Consanguinity Gramps - Notebook mode

The Consanguinity Gramplet displays information about the Active Person and any spouses.

The Gramplet is updated whenever the Active Person focus shifts.

However, any open Pedigree and pedigree collapse diagram windows remain unchanged. This allows them to be used for navigating the Active Person focus and for direct comparison to windows opened on other persons.

Adding the Consanguinity Gramplet

The Consanguinity Gramplet is designed to be added to the sidebar RelationshipsRelationships Category (Grouped or List) view modes of Gramps. (After manually installing, this gramplet will be available for addition in all these locations: the sidebar/bottombar option for the following views: PeoplePeople, RelationshipsRelationships, ChartsCharts, and GeographyGeography.)

Select the Consanguinity menu option from the Add a gramplet submenu of the Gramplet selection menus. Accessible by pressing the (Down Arrowhead button) in the view's sidebar or bottombar.

Controls

  • RadioButton Selected.png Single pane (default); a combined line of Active Person with spouse(s).
  • RadioButton Deselected.png Notebook; a tabbed view with each person separated. Shown in Figure 1.
  • Copy - copies the text of the window to the OS clipboard.
  • Display pedigrees - opens a tabbed window with ahnenlist numbered Ancestors. There will be a tab for each spouse

When detached (undocked), the floating dialog also has:

  • Help - which links to this webpage
  • Close - which closes the floating dialog by returning it to its dock

Example

The example tree included with Gramps includes a few instances of Pedigree Collapse.

So to reproduce this diagram, import the example.gramps file to a new tree.

Gnome-important.png
Importing can create a mess!

Be careful that you do NOT import the example.gramps data into your own Family tree. Cleaning out the contamination of records related to thousands of fictitious people would be troublesome. Always double-check which tree is already loaded before importing a file.

Switch to the PeoplePeople View via the navigator bar. Find Piatt D. Warner and make him the Active Person. (By selecting that row.)

Switch to the RelationshipsRelationships View via the navigator bar. Add the Consanguinity Gramplet to the view's sidebar as described in the Usage section above. Resize the width the sidebar so that the contents fit comfortably.


Fig. 2 Consanguinity pedigree window (click the Display pedigrees button)

Explore the common ancestry

Since Piatt D. Warner is the Active Person, the contents of the Consanguinity Gramplet will be in the Single Pane mode (Figure 1 shows the Notebook mode where spouses are on separate pages) and look something like the following section. (Although the gramplet will have hotlinked People and Relationship.) The text below was created by clicking the Copy button and pasting it into this article.

Warner, Piatt D. (*9 Apr 1821, +11 Oct 1889)

Pedigree collapse for active person

Pedigree collapse at great grandparents:
	Warner, Edward (*6 Jan 1713, +27 Sep 1776)
	Anderson, Mary Molly (*1719, +20 Apr 1795)
	Relationship: second cousins once removed (down)
	Common ancestors:
		Christiansen, Edward (*1607, +1684)
		Thomas, Elizabeth (*1620, +1713)

Relationships between active person and partners

Partner: Fox, Julia Colville (*25 Dec 1823, +12 Feb 1904)
	Relationship: fifth cousins once removed (down)
	Common ancestors:
		Christiansen, Edward (*1607, +1684)
		Thomas, Elizabeth (*1620, +1713)
	Relationship: fifth cousins
	Common ancestors:
		Christiansen, Nathaniel (*15 May 1642, +21 Nov 1713)
		Grenier, Mary (*about 1638, +12 Jul 1703)

The hotlinks on the names of People will navigate the focus of Active Person selection to that person.

The Relationship diagram

Fig. 3 Consanguinity diagram window (click a Relationship hotlink)

Clicking the described Relationship will open a block diagram of that instance of pedigree collapse and how it relates to the Active Person.

In the example shown in Figure 1, Piatt Warner's great grandparents (Edward Warner and Mary Molly Anderson have the Relationship: second cousins once removed (down) who are descended from the common ancestors, Edward Christiansen and Elizabeth Thomas. Clicking that relationship description opens a basic chart (shown in Figure 2) of their common ancestors and Piatt's relationship through them.

The Pedigree list

Clicking the Display pedigrees button opens a tabbed window with list format of an ahnentafel numbering system pedigree. The other tab contains the similarly numbered pedigree of the Active Person's spouse(s) but starting with the spouse in the #1 spot for their list. These numbers Each list will only show a person once, regardless of how much pedigree collapse exists for the Person in the #1 spot on that pedigree.

Clicking the Copy button copies the text to the OS clipboard.

A text list is more actionable when sharing with family and other genealogists than a diagram. A diagram makes understanding the relationship easier. But a list can be transcribed into a form or another program more easily.

An example of Piatt's pedigree is shown in Figure 3. You will notice that the lines for ancestors 152 and 153 are marked as being the same as ancestors 68 and 69 (Edward Christiansen and Elizabeth Thomas). This is where there is pedigree collapse for Piatt. The rest of the list will crop out the ancestors of 152 and 153 because they too are duplicated.

But which children were the siblings? Just divide the ancestor number by 2 to get the number of their child. Half of 152 is 76 (Nathanial Christiansen) and half of 68 is 34 (off-screen in Figure 3 but this is Joseph Christiansen). You can use this method in any Ahnentafel Numbering System. You can also use "deductive reckoning" determine their exact relationship to the #1 person by their number.

Trickery to Diagram Cousin connections

The Consanguinity Gramplet is designed to help determine the various degrees of consanguineous relationships between the Active Person and their spouse(s). It does so in a more comprehensive way than can be found in any other combination of tools in Gramps.

But what if the people you want to compare and contrast are just distant cousins? The Gramplet is not designed to help with that... but you can trick it into helping. Create a temporary family and add the two cousins to be compared. The Edit Family must be closed with the OK button to commit it to the Tree.

When you have explored sufficient, Edit the temporary Family again to remove both people. When the Family Editor window is closed with the OK, the now-empty temporary family will be deleted.

Because the Consanguinity Gramplet was not designed for this purpose, it doesn't handle some relationship situations well. (As an example: creating a temporary relationship between Ancestor and their Descendant confuses it badly.)

See also