Open main menu

Gramps β

Changes

Addon:Consanguinity Gramplet

3,137 bytes added, 07:59, 21 November 2025
m
See also: ?
{{Languages|Addon:Consanguinity_Gramplet}}
{{Third-party pluginaddon}}{{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].}}[Gramps_Glossary[File:ConsanguinityGramplet-SinglePane-mode-default-example-60.png|thumb|right|450px|Fig. {{#vardefineecho:figure|{{#expr:{{#grampletvar:figure}}+1}}}} Detached Consanguinity Gramps - [[File:RadioButton_Selected.png|Gramplet21px]] '''Single pane''' ''(default)'' mode]] to show 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 ==
[[File:ConsanguinityNotebook.png|thumb|right|267px|Fig. The {{#vardefineecho:figureman label|{{#expr:{{#var:figureConsanguinity Gramplet}}+1}}}} Detached Consanguinity Gramps - Notebook modedisplays information about the [[Gramps_Glossary#active_person|Active Person]]and any spouses.
The Consanguinity gramplet Gramplet is an add-on for updated whenever the People views of GrampsActive Person focus shifts. (When installed, this gramplet will be an option for the following views: {{icon|peop}}People, {{icon|rela}}Relationships, {{icon|ance}}Charts, and {{icon|geog}}Geography.
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_{{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 labelmenu|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 after ]]. Accessible by pressing the {{man button|&or;}} (''Down Arrowhead'' button) in the view's sidebar or bottombar. === Controls ===
<!--
◉ selected &#128280; deselected
-->
*[[File:RadioButton_Selected.png|21px]] '''Single pane ''' ''(default)''; a combined line of Active Person with spouse(s). *[[File:RadioButton_Deselected.png|21px]] ''Notebook''; a tabbed view with each person separated. ''Shown in Figure 1.''
*{{man button|Copy}} - copies the text of the window to the OS clipboard.
*{{man button|Display pedigrees}} - opens a tabbed window with ahnenlist numbered Ancestors. There will be a tab for each spouse
== 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 sample 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.
Switch to the {{man warnicon|1=Importing can create a mess!|2=Be careful that you do NOT import example data into your own Family treepeop}}People View via the navigator bar. Find ''<code>Piatt D. Cleaning out Warner</code>'' (ID: <code>I0031</code> ) and make him the contamination would be troublesomeActive Person. Always double-check which tree is already loaded before importing a file(By selecting that row.}})
Switch to the {{icon|peoprela}}People Relationships View via the navigator bar. Find Add the {{man label|Consanguinity Gramplet}} to the view''Piatt Ds sidebar as described in the [[#Usage|Usage]] section above. Warner'' and make him Resize the width the sidebar so that the Active Personcontents fit comfortably. <!--Detach (By selecting that rowundock) 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.) -->
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.
<!--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:ConsanguinityPedigreeConsanguinityGramplet-DisplayPedigrees-window-example-60.png|thumb|right|258px450px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Consanguinity pedigree Gramplet" - "Pedigree" window (click the {{man button|Display pedigrees}} button)]]
=== Explore the common ancestry ===
Since ''<code>Piatt D. Warner</code>'' is the Active Person, the contents of the {{man label|Consanguinity gramplet Gramplet}} will be in the '''Single Pane''' mode (Figure 1 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>
Warner, Piatt D. (*9 Apr 1821, +11 Oct 1889)
The hotlinks on the names of People will navigate the focus of Active Person selection to that person.
{{-}}=== The Relationship diagram diagrams ===[[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.
In the example ''shown in Figure 12'', 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 23)'' of their common ancestors and Piatt's relationship through them.
=== The Pedigree list ===
Clicking the {{man button|Display pedigrees}} button opens a tabbed window with ahnenlist numbered list format of an ahnentafel numbering system pedigree. The other tab contains the ahnenlist 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 {{man button|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 34. 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.
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 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.
{{-}}
 
== 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 ==
* [https://github.com/hgboldt/consanguinuity consanguinity Consanguinity source code] in Hans Boldt's GitHub repositoryfor Gramps 5.1 Date: 2021-10-01 * [[Addon:RelatedRelativesGramplet|Related Relatives Gramplet]] - Display all persons in the database family tree with a relation to a relative. A Gramplet by Heinz Brinker*[[Screenshots|Screenshots]]*[[Gramps_Glossary#gramplet|Gramplet]] Gramps Glossary definition
{{DEFAULTSORT:How do I...new category location|noreplace}}
[[Category:Plugins]]
[[Category:Gramplets]]