276
edits
Changes
no edit summary
{{languages|Addon:DNAgrampletDNASegmentMapgramplet}}
{{Third-party plugin}}
[[File:Addon-DNA-SegmentMap-with-Tooltip.jpg|thumb|450px|right|Example {{man label|DNA Segment Map Gramplet}}]]
=Usage=
You can install the {{man label|DNA Segment Map Gramplet}} on the bottombar of one of the people or relationship category list views.
==Create a DNA Association==
To specify shared DNA segments between 2 people,
* Create an Association for one person (Person A) with another Person (Person B) of the type DNA.
* Create a Note in the Association of Type: "or attached to a Citation in the Association Note" with the shared DNA segment data.** The format of the Note is a comma separated list or a tab separated list in the order: <code>Chromosome Number, Start Segment, End Segment, shared length in cMs, SNP (optional)</code>.
** eg: <code>3,56950055,64247327,10.9,1404</code> Which means; Chromosome Number: 3, Start Segment: 56950055, End Segment: 64247327, shared length in cMs: 10.9, matching SNPs: 1404</code>
** Valid entries for each are:
{{-}}
===Getting the chromosome data ===
Sites like [https://www.gedmatch.com/login1.php GEDmatch] make this shared chromosome data available. Direct copy from the GEDmatch results page (with header and tab separators) will work. There can be additional Associations between Person A and Person C et cetera as known.
===Legend===
* Hovering the cursor over a painted chromosome segment will show a tooltip with the name of the associated person, ID, length in cMs (centiMorgans) of the shared segment, and matching SNPs of the segment if provided.
* The color code for each associated person in the DNA segment map is consistent but not user-specified. The first Association will always be the same color.
===Navigation===
* The Legend on the right side lists each associated person who has a mapped segment. Hovering over the legend items will show a tooltip for possible action. Primary button click will change the active person. Secondary button click will open the Person Editor for the associated person.
===DNA Example data===
21,14670124,18743733,10.8,201
[[File:Addon-DNA-GEDmatch.png|thumb|600px|right]]
Sample GEDmatch output that can be cut and paste into the Note
{{-}}
=== Example ===
[[File:Addon-DNA-Note-Example.png|thumb|600px|right]]
* To create a segment map for Person A, you need to add associations to Person A. There is no reciprocal relationship for Person B - that is, there is no segment map for Person B, only for Person A. You can execute the [[Addon:SyncAssociation]] addon to create any missing reciprocal relationships.
* Color code for each associated person in the map is consistent but not user-specified. The first Association will always be the same color.
* Help link goes to https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Gramplets#DNAthis page
* If there are overlapping segments within a maternal/paternal view of a chromosome, only the front (last drawn) will be pickable. If it is completely obscured, you will not be able to see the details of the hidden segment. Changing the order of Associations (using the up-arrow and down-arrow) to have the closer relatives before further relatives will fix this.