Difference between revisions of "Addon:Consanguinity Gramplet"

From Gramps
(Controls)
m (See also: ?)
 
(11 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
{{Unreleased addon}}
 
{{Unreleased addon}}
 
{{man warn|You may install the [https://github.com/hgboldt/consanguinity addon manually if you are interested in helping to test and report issues].}}
 
{{man warn|You may install the [https://github.com/hgboldt/consanguinity addon manually if you are interested in helping to test and report issues].}}
[[File:ConsanguinityNotebook-51.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Consanguinity Gramps - Notebook mode]]
+
[[File:ConsanguinityGramplet-SinglePane-mode-default-example-60.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Consanguinity Gramps - [[File:RadioButton_Selected.png|21px]] '''Single pane''' ''(default)'' mode]]
 
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]].
 
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]].
  
Line 14: Line 14:
  
 
=== Adding the Consanguinity Gramplet ===
 
=== 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.)   
+
The {{man label|Consanguinity Gramplet}} is designed to be added to the sidebar {{icon|rela}}[[Gramps_{{man version}}_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 menu|Consanguinity}} menu option from the {{man menu|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.
 
Select the {{man menu|Consanguinity}} menu option from the {{man menu|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.
Line 32: Line 32:
  
 
== Example ==
 
== Example ==
 +
{{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.}}
 +
 +
[[File:ConsanguinityGramplet-Notebook-mode-example-60.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached "Consanguinity Gramplet" - "Notebook" mode]]
 +
 
The example 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 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 ''<code>Piatt D. Warner</code>'' (ID: <code>I0031</code> ) 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 {{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.
 
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.
Line 44: Line 46:
  
  
[[File:ConsanguinityPedigree-51.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity pedigree window (click the {{man button|Display pedigrees}} button)]]
+
[[File:ConsanguinityGramplet-DisplayPedigrees-window-example-60.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Consanguinity Gramplet" - "Pedigree" window (click the {{man button|Display pedigrees}} button)]]
 
=== Explore the common ancestry ===
 
=== Explore the common ancestry ===
  
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.
+
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 2 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 77: Line 79:
 
{{-}}
 
{{-}}
 
=== The Relationship diagrams ===
 
=== The Relationship diagrams ===
[[File:ConsanguinityDiagram-51.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity diagram window (click a Relationship hotlink)]]
+
[[File:ConsanguinityGramplet-DisplayDescendants-window-example-60.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Consanguinity Gramplet" - display "Descendants" window - cousins diagram (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.  
  
In the example ''shown in Figure 1'', Piatt Warner's great grandparents (Edward Warner and Mary Molly Anderson have the {{man label|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.
+
In the example ''shown in Figure 2'', Piatt Warner's great grandparents (Edward Warner and Mary Molly Anderson have the {{man label|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 3)'' of their common ancestors and Piatt's relationship through them.
  
 
=== The Pedigree list ===
 
=== The Pedigree list ===
Line 89: Line 91:
 
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 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 4. 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 4 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.   
 
{{-}}
 
{{-}}
  
Line 106: Line 108:
 
* [https://github.com/hgboldt/consanguinity Consanguinity source code] in Hans Boldt's GitHub repository for Gramps 5.1 Date: 2021-10-01  
 
* [https://github.com/hgboldt/consanguinity Consanguinity source code] in Hans Boldt's GitHub repository for Gramps 5.1 Date: 2021-10-01  
 
* [[Addon:RelatedRelativesGramplet|Related Relatives Gramplet]] - Display all persons in the family tree with a relation to a relative. A Gramplet by Heinz Brinker
 
* [[Addon:RelatedRelativesGramplet|Related Relatives Gramplet]] - Display all persons in the family tree with a relation to a relative. A Gramplet by Heinz Brinker
*[[Gramps_Glossary#gramplet|Gramplet]] Gramps Glossary definition
+
 
  
 
{{DEFAULTSORT:How do I...new category location|noreplace}}
 
{{DEFAULTSORT:How do I...new category location|noreplace}}
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Gramplets]]
 
[[Category:Gramplets]]

Latest revision as of 07:59, 21 November 2025

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

Gnome-important.png
Unreleased addon

Please note that at this time the addon has not been released. This may be due to many factors including it being no longer developed or abandoned or currently in the testing phase.

Gnome-important.png
Fig. 1 Detached Consanguinity Gramps - RadioButton Selected.png Single pane (default) mode

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

Usage

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

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.

Fig. 2 Detached "Consanguinity Gramplet" - "Notebook" mode

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.

Switch to the PeoplePeople View via the navigator bar. Find Piatt D. Warner (ID: I0031 ) 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. 3 "Consanguinity Gramplet" - "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 2 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 diagrams

Fig. 4 "Consanguinity Gramplet" - display "Descendants" window - cousins diagram (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 2, 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 3) 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 4. 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 4 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