Difference between revisions of "Addon:Consanguinity Gramplet"

From Gramps
m
m
Line 5: Line 5:
  
 
== Usage ==
 
== Usage ==
 +
[[File:ConsanguinityNotebook.png|thumb|right|265px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Consanguinity Gramps - Notebook mode]]
 +
 +
[[File:ConsanguinityDiagram.png|thumb|right|283px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity diagram window (click a Relationship hotlink)]]
 +
 +
[[File:ConsanguinityPedigree.png|thumb|right|301px|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. 
  
[[File:ConsanguinityNotebook.png|thumb|right|265px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Consanguinity Gramps - Notebook mode]]
+
Select the {{man label|Consanguinity}} menu option from the Gramplet selection menus after pressing the {{man button|∨}} (''Down Arrowhead'' button) in the view's sidebar or bottombar.
 +
<!--
 +
◉ selected &#128280; deselected
 +
-->
 +
*[[File:RadioButton_Selected.png|21px]] Single pane; a combined line of Active Person with spouse(s)
 +
*[[File:RadioButton_Deselected.png|21px]] Notebook; a tabbed view with each person separated
 +
*{{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 
 +
 
 +
When detached (undocked), the floating dialog also has:  
 +
*{{man button|Help}} - which links to this webpage 
 +
*{{man button|Close}} - which closes the floating dialog by returning it to its dock
  
 +
== Example ==
 +
The sample tree included with Gramps does not have any Pedigree Collapse.  So to do this diagram, import the [[Example.gramps|example.gramps]] file to a new tree. 
  
[[File:ConsanguinityDiagram.png|thumb|right|283px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity diagram window (click a cousin relations link)]]
+
=== How to add new Family with a known spouse ===
 +
In the example.gramps tree, we want to add a cousin as a spouse to Barry Joseph Garner. To match these illustrations, we will use his 3rd cousin once removed, April Lynn Vázquez.
  
 +
# Switch to the {{icon|peop}}People View via the navigator bar
 +
# find the known person (in this example, April Lynn Vázquez)
 +
# select the row
 +
# copy (which brings up the Gramps Clipboard copies the selected object to it)
 +
# find the other spouse (in this example, Barry Joseph Garner
 +
# select the row
 +
# Switch to the {{icon|rela}}Relationships View via the navigator bar
 +
# click Add a new family toolbar button
 +
# drag April from the Clipboard to the Mother/partner2 spot
 +
# click the {{man button|OK}} button to finalize the new family in the tree
  
[[File:ConsanguinityPedigree.png|thumb|right|301px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Consanguinity pedigree window]]
+
=== Explore the common ancestry ===
 +
Add the Consanguinity gramplet to the Relationships view sidebar as described in the [[#Usage|Usage]] section above. 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 wont interfere with seeing the view's data.
  
{{-}}
+
Since Barry Joseph Garner is the Active Person, the contents of the Gramps will look something like the following section. (Although it 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>
 
Garner, Barry Joseph (*14 Dec 1948)
 
Garner, Barry Joseph (*14 Dec 1948)
Line 32: Line 64:
 
Partner: Vázquez, April Lynn (*17 Sep 1963)
 
Partner: Vázquez, April Lynn (*17 Sep 1963)
 
No common ancestors found.</pre>
 
No common ancestors found.</pre>
 +
 +
The hotlinks on the names of People will navigate the Active Person selection to that person.
 +
Clicking the Relationship (in this example, "third cousins once removed (down)") will open a block diagram of the nearest common ancestry connection.
 +
 +
{{-}}
 
== See also ==
 
== See also ==
 
* [https://github.com/hgboldt/consanguinuity Consanguinity source code] in Hans Boldt's GitHub repository
 
* [https://github.com/hgboldt/consanguinuity Consanguinity source code] in Hans Boldt's GitHub repository
Line 166: Line 203:
 
*{{checkbox|1|Checked}} - [[Template:Checkbox|Selected Checkbox]] &#x2611; template
 
*{{checkbox|1|Checked}} - [[Template:Checkbox|Selected Checkbox]] &#x2611; template
 
*{{checkbox|0|Unchecked}} - Checkbox that is &#x274f; unselected
 
*{{checkbox|0|Unchecked}} - Checkbox that is &#x274f; unselected
 +
*[[File:RadioButton_Selected.png|21px]] - Radio button that is ◉ selected
 +
*[[File:RadioButton_Deselected.png|21px]] - Radio button that is &#128280; deselected
  
 
== Boxed annotations ==
 
== Boxed annotations ==

Revision as of 20:15, 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
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)

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; a combined line of Active Person with spouse(s)
  • RadioButton Deselected.png Notebook; a tabbed view with each person separated
  • 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 does not have any Pedigree Collapse. So to do this diagram, import the example.gramps file to a new tree.

How to add new Family with a known spouse

In the example.gramps tree, we want to add a cousin as a spouse to Barry Joseph Garner. To match these illustrations, we will use his 3rd cousin once removed, April Lynn Vázquez.

  1. Switch to the PeoplePeople View via the navigator bar
  2. find the known person (in this example, April Lynn Vázquez)
  3. select the row
  4. copy (which brings up the Gramps Clipboard copies the selected object to it)
  5. find the other spouse (in this example, Barry Joseph Garner
  6. select the row
  7. Switch to the RelationshipsRelationships View via the navigator bar
  8. click Add a new family toolbar button
  9. drag April from the Clipboard to the Mother/partner2 spot
  10. click the OK button to finalize the new family in the tree

Explore the common ancestry

Add the Consanguinity gramplet to the Relationships view sidebar as described in the Usage section above. 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 wont interfere with seeing the view's data.

Since Barry Joseph Garner is the Active Person, the contents of the Gramps will look something like the following section. (Although it will have hotlinked People and Relationship. The text below was created by clicking the Copy button and pasting it into this article.)

Garner, Barry Joseph (*14 Dec 1948)

Pedigree collapse for active person

Pedigree collapse at parents:
	Garner, Howard Lane (*9 Jul 1928)
	Marín, Mary Anne (*13 Jan 1927)
	Relationship: third cousins once removed (down)
	Common ancestors:
		Howell, John
		Yates, Sarah

Relationships between active person and partners

Partner: Vázquez, April Lynn (*17 Sep 1963)
	No common ancestors found.

The hotlinks on the names of People will navigate the Active Person selection to that person. Clicking the Relationship (in this example, "third cousins once removed (down)") will open a block diagram of the nearest common ancestry connection.


See also