14
edits
Changes
From Gramps
Creating help info page for this addon.
{{languages|Addon:DNAMatches}}
{{Third-party plugin}}
{{man label|DNA Matches}} presents the users with a table of people whose DNA has a match with the currently selected person.
==Usage==
The purpose of this gramplet is to present users with a table of all people whose DNA has a match with the currently selected person. Each person with shared segments is a separate Association. The Notes in the Association contain the shared segment info as calculated by the vendor.
===Creating a DNA Association===
The process of creating a DNA association for use with DNA Matches is the same as for the [[Addon:DNASegmentMapGramplet#Create_a_DNA_Association|DNA Segment Map Gramplet]]. Please refer to the instructions on that addon's wiki article for information on how to do this.
====Ancestry====
Ancestry does not have a chromosome browser and its data thus lacks some of the information that other vendors provide. An alternative format is therefore used for Ancestry DNA matches. This takes the form of a note with a single line specifying shared DNA, shared segments and the largest segment, in that order, separated by tabs or commas, like so: <code>168,5,68</code>
===Navigation===
Clicking on a person in the table will make them the active person. Right-clicking on a person in the table will open the DNA association between that person and the currently selected person.
===Configuration===
The config file (DNAMatches.ini) for this gramplet has the following options. Remove the comment (double semi-colon) and edit as needed. Changes are not reflected until the next time gramps is started.
<pre>
[hide-columns]
;;id=0
;;largest-segment=0
;;person=0
;;relationship=0
;;shared-dna=0
;;shared-segments=0
;;sources=0
[short-names]
;;largest-segment=0
;;person=0
;;relationship=0
;;shared-dna=0
;;shared-segments=0
;;sources=0
[widths]
;;id=50
;;largest-segment=150
;;person=150
;;relationship=125
;;shared-dna=125
;;shared-segments=155
;;sources=200
</pre>
====Hide Columns====
Changing a value under this heading to 1 will hide that specific column from the table. For example, <code>relationship=1</code> will hide the relationship column.
====Short Names====
Changing a value under this heading to 1 will shorten the name of that specific column. For example, <code>relationship=1</code> will shorten "Relationships" to "Rel."
====Widths====
Changing a value under this heading will change the width of that specific column to the specified value. Users can use this to adjust each column's width to their liking.
== See also ==
* [[Addon:DNASegmentMapGramplet|DNA Segment Map Gramplet]]
* [[Addon:SyncAssociation|Sync Association]] addon tool
* [https://gramps.discourse.group/t/new-gramplet-dna-matches/4313/2 Forum thread for the gramplet]
* [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Associations|Introduction to Associations in Gramps]]
* [[Roles, Relationships & Associations]]
* [[Genetics]]
[[Category:Plugins]]
[[Category:Addons]]
{{Third-party plugin}}
{{man label|DNA Matches}} presents the users with a table of people whose DNA has a match with the currently selected person.
==Usage==
The purpose of this gramplet is to present users with a table of all people whose DNA has a match with the currently selected person. Each person with shared segments is a separate Association. The Notes in the Association contain the shared segment info as calculated by the vendor.
===Creating a DNA Association===
The process of creating a DNA association for use with DNA Matches is the same as for the [[Addon:DNASegmentMapGramplet#Create_a_DNA_Association|DNA Segment Map Gramplet]]. Please refer to the instructions on that addon's wiki article for information on how to do this.
====Ancestry====
Ancestry does not have a chromosome browser and its data thus lacks some of the information that other vendors provide. An alternative format is therefore used for Ancestry DNA matches. This takes the form of a note with a single line specifying shared DNA, shared segments and the largest segment, in that order, separated by tabs or commas, like so: <code>168,5,68</code>
===Navigation===
Clicking on a person in the table will make them the active person. Right-clicking on a person in the table will open the DNA association between that person and the currently selected person.
===Configuration===
The config file (DNAMatches.ini) for this gramplet has the following options. Remove the comment (double semi-colon) and edit as needed. Changes are not reflected until the next time gramps is started.
<pre>
[hide-columns]
;;id=0
;;largest-segment=0
;;person=0
;;relationship=0
;;shared-dna=0
;;shared-segments=0
;;sources=0
[short-names]
;;largest-segment=0
;;person=0
;;relationship=0
;;shared-dna=0
;;shared-segments=0
;;sources=0
[widths]
;;id=50
;;largest-segment=150
;;person=150
;;relationship=125
;;shared-dna=125
;;shared-segments=155
;;sources=200
</pre>
====Hide Columns====
Changing a value under this heading to 1 will hide that specific column from the table. For example, <code>relationship=1</code> will hide the relationship column.
====Short Names====
Changing a value under this heading to 1 will shorten the name of that specific column. For example, <code>relationship=1</code> will shorten "Relationships" to "Rel."
====Widths====
Changing a value under this heading will change the width of that specific column to the specified value. Users can use this to adjust each column's width to their liking.
== See also ==
* [[Addon:DNASegmentMapGramplet|DNA Segment Map Gramplet]]
* [[Addon:SyncAssociation|Sync Association]] addon tool
* [https://gramps.discourse.group/t/new-gramplet-dna-matches/4313/2 Forum thread for the gramplet]
* [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Associations|Introduction to Associations in Gramps]]
* [[Roles, Relationships & Associations]]
* [[Genetics]]
[[Category:Plugins]]
[[Category:Addons]]
