Difference between revisions of "Addon:Consanguinity Gramplet"

From Gramps
m (Example)
m
Line 5: Line 5:
  
 
== Usage ==
 
== Usage ==
[[File:ConsanguinityNotebook.png|thumb|right|267px|Fig. {{#var:chapter}}.{{#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]]
 
 
[[File:ConsanguinityDiagram.png|thumb|right|270px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity diagram window (click a Relationship hotlink)]]
 
 
 
[[File:ConsanguinityPedigree.png|thumb|right|258px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity pedigree window (click the {{man button|Display pedigrees}} button)]]
 
  
 
The Consanguinity gramplet is an add-on for the People views of Gramps. (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.   
 
The Consanguinity gramplet is an add-on for the People views of Gramps. (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.   
Line 17: Line 13:
 
◉ selected 🔘 deselected
 
◉ selected 🔘 deselected
 
-->
 
-->
*[[File:RadioButton_Selected.png|21px]] Single pane; a combined line of Active Person with spouse(s)  
+
*[[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  
+
*[[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|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   
 
*{{man button|Display pedigrees}} - opens a tabbed window with ahnenlist numbered Ancestors. There will be a tab for each spouse   
  
Line 29: Line 25:
 
The sample tree included with Gramps includes a few instances of Pedigree Collapse.   
 
The sample 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 {{icon|peop}}People View via the navigator bar. Find ''Piatt D. Warner'' and make him the Active Person. (By selecting that row.)
+
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.}}
  
Switch to the {{icon|rela}}Relationships View via the navigator bar. Add the Consanguinity gramplet to the sidebar.
+
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|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.-->
 +
{{-}}
 
<!--
 
<!--
 
=== How to add new Family with a known spouse ===
 
=== How to add new Family with a known spouse ===
Line 48: Line 49:
 
# click the {{man button|OK}} button to finalize the new family in the tree
 
# click the {{man button|OK}} button to finalize the new family in the tree
 
-->
 
-->
 +
[[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)]]
 
=== Explore the common ancestry ===
 
=== Explore the common ancestry ===
Add the Consanguinity gramplet to the Relationships view 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.-->
 
  
Since ''Piatt D. Warner'' is the Active Person, the contents of the Consanguinity gramplet will be in the '''Single Pane''' mode 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 ''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.
 
<pre>
 
<pre>
 
Warner, Piatt D. (*9 Apr 1821, +11 Oct 1889)
 
Warner, Piatt D. (*9 Apr 1821, +11 Oct 1889)
Line 81: Line 83:
 
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.
  
Clicking the Relationship (in this example, "second cousins once removed (down)") 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)''. Clicking that relationship description opens a basic chart ''(shown in Figure 2)'' of that relationship and Piatt's relationship to them.  
 
{{-}}
 
{{-}}
  

Revision as of 23:08, 30 September 2021

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
🚧 Work In Progress

This wikipage is an outline from a template being roughed in. Please don't edit just yet. Instead, contribute suggestions on the Discussion page.

This page is not planned be linked to a public page until about 2 weeks after 30 September 2021.

If this notice remains after that date, please feel welcome to remove this notice and consider the content 'fair game' for unlimited editing.

Gramplet to show pedigree collapse and spousal consanguinity for the Active Person.

Usage

File:ConsanguinityNotebook.png
Fig. 1 Detached Consanguinity Gramps - Notebook mode

The Consanguinity gramplet is an add-on for the People views of Gramps. (When installed, this gramplet will be an option for the following views: PeoplePeople, RelationshipsRelationships, ChartsCharts, and GeographyGeography.

Select the Consanguinity menu option from the Gramplet selection menus after pressing the (Down Arrowhead button) in the view's sidebar or bottombar.

  • 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 sample 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 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.

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.

File:ConsanguinityDiagram.png
Fig. 2 Consanguinity diagram window (click a Relationship hotlink)
File:ConsanguinityPedigree.png
Fig. 3 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.

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). Clicking that relationship description opens a basic chart (shown in Figure 2) of that relationship and Piatt's relationship to them.

See also