113
edits
Changes
→History
{{Third-party addon}}
[[File:DNA-SegmentMapGramplet-addon-RelationshipView-bottombar-example-60.png|thumb|450px|right|{{man label|DNA Segment Map Gramplet}} - addon - with DNA information - Relationship View - bottombar - example]]
The {{man label|DNA Segment Map Gramplet}} shows a graphic view of the DNA chromosome segment data for the active user and a set of associated users. <!-- A chromosome segment map is a visualization of how DNA segments are inherited from ancestors. -->
==Usage==
You can install the {{man label|DNA Segment Map Gramplet}} on the bottombar of one of the People or Relationship category list views.
Each person with shared segments will be a separate Association. The Notes in the Association should contain the shared segment info as calculated by the vendor.
===== GEDmatch =====
[[File:Addon-DNA-GEDmatch.png|thumb|600px|right]]
Sample GEDmatch output (see screenshot) that can be cut and paste into the Note. The fields are the same - Chromosome, Start, End, cM, and SNPs. This can be cut/paste from the GEDmatch output directly into the Note for the Association. The header line will be ignored.
GEDmatch provides a cut-paste option for data. The format is set for copy into this gramplet. The gramplet will accept either comma or period as the thousands separator.
{| class="wikitable"
=====Ancestry=====
Ancestry.com [https://support.ancestry.com/s/article/Chromosome-Browser?language=en_US 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 You can find this information by going to your DNA Matches comparison page and selecting the link to show the [https://support.ancestry.com/s/article/Understanding-Unweighted-Shared-DNA?language=en_US popup-page] that list the '''Shared DNA''', '''Unweighted shared DNA''' and the form '''Longest segment''' result: [[File:Ancestry.com-unweighted-dna-example2025.png|thumb|450px|right|An example of a DNA match where the individuals share 55cM or identical DNA from a recent common ancestor. They also share an additional 17cM of identical DNA not from a common ancestor. Copied from https://support.ancestry.com/s/article/Understanding-Unweighted-Shared-DNA ]] <pre>You and [Name of Match] Predicted: [predicted relationship] Shared DNA: XXXX cM across XX segments Unweighted shared DNA: XXXX cM Longest segment XXXX cM </pre> From this information you can create a note with a single line specifying shared '''Shared DNA''', '''Unweighted shared segments DNA''' and the largest '''Longest segment''', in that order, separated by tabs or commas, like sofor example screenshot the result would be: <code>16855,572,6821</code> {{-}}
====Legend====
[[File:Addon-DNA-SegmentMap-legend-51.png|thumb|338px450px|right|[ {{man label|Legend with rollover tooltip]]<!-- tooltip no longer shows in 6.0 -->
* For each Chromosome: the top portion is the Paternal side and the bottom portion is the Maternal side.
* The chromosome segment side (Paternal or Maternal) is determined from the [https://wikipedia.org/wiki/Most_recent_common_ancestor Most Recent Common Ancestor](MRCA). If there is no common ancestor, both sides are used.
====Configuration====
The following are capabilities that are currently disabled but can be enabled if user desire. These add complications to the user interface and are deemed not beneficial
The <code>[map]</code> section of the gramplets config file <code>DNASegmentMap.ini</code> has the following options. Remove the comment (double semi-colon) and edit as needed while Gramps is not started. Changes are not reflected until the next time the Gramps is started.
=====Single Chromosome View=====
[[File:AddonDNA-SegmentMapGramplet-addon-DNAdetached-SingleChromosomeView-SegmentMapexample-Single60.png|thumb|450px|right|"DNA Segment Map" Gramplet - addon - detached - "Single Chromosome View" with DNA information example]]To view just a single chromosome, click on the chromosome numbercolumn. This view has each association as a different row, helping to see overlapping areas. To return to the standard view, click on the background area.
{{-}}
=====Visual Phasing View=====
[[File:DNA-SegmentMapGramplet-addon-detached-VisualPhasingView-grandparent-view-2-example-60.png|thumb|450px|Visual Phasing View for Grandparent View 2]]
[https://isogg.org/wiki/Visual_phasing Visual phasing] is a methodology for assigning segments to specific grandparents. This technique can be employed when parents are not available for testing.
To view with coloring based on grandparent/great-grandparent, enable in the config and then click on the background outside of any drawn graphics or legend. The DNA segment will be painted one of 4/12 colors, depending on the grandparent/great-grandparent found in the path of the tree. The maternal side has 2 color options (maternal grandfather or maternal grandmother). The paternal side has 2 color options (paternal grandmother or paternal grandfather).
[[File:PhasingLegend.png|thumb|200px|Legend for Grandparent View]]<!-- to recreate a custom family tree with those labels have been used -->
For the great-grandparent view, there are an additional 8 colors
[[File:GreatPhasingLegend.png|thumb|200px|Legend for Great-Grandparent View]]<!-- to recreate a custom family tree with those labels have been used -->
First cousins or closer are not displayed. If there is no known path based on the tree, the segment is not displayed.
====DNA Example data====
To reproduce the illustration (for default view is of all of the chromosomes with all of the segments) with the [[Example.gramps]] dataset, . In the "Person Editor" for '''Luther Robinson (<code>I0656</code>)'' create two records in the ''Associations '' tab in the Person Editor for Luther Robinson:<hr>(1.) Record one is '''DNA''' type, adding an association with '''Robert F. Garner (I0656<code>I1123</code>)'''.
Chromosome,Start Location,End Location,Centimorgans,Matching SNPs,Name,Match Name
6,6179882,15400114,18.5,1994
<hr>
(2.) Record two is also '''DNA''' type, adding an association with Maude Garner (<code>I0651</code>).
The Note under this association contains the following text:
21,14670124,18743733,10.8,201
<hr>
{{man tip|DNA match row data must be in a specific CSV order|The data may include a header but the Gramplet does not require one. Headers are to make the rows more readable by humans. The rows do not need to be sequentially ordered by the chromosome identifier (1 to 22 and X).}}
{{-}}
==== Example ====
[[File:AddonDNA-SegmentMapGramplet-addon-Associations-Note-with-DNA-Notedata-example-Example60.png|thumb|600px|right]]Create an Association of type DNA as described in the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Associations|Association]] page to Person A. Add a Note with the DNA shared segment data. Set the Note private if you do not want the data printed in reports. (For this example use the [[#DNA_Example_data|DNA Example data]] above.)
{{-}}
[[File:AddonDNA-SegmentMapGramplet-addon-DNAPersonReferenceEditor-Associationexample-Example60.png|thumb|600px|right]]
Save the Association.
{{-}}
[[File:AddonDNA-DNASegmentMapGramplet-addon-PersonEdit-Associations-Exampleexample-60.png|thumb|600px|right]]
Add more associations as known. Each would be associated to a different person and have a different Note. Since the Associations are drawn in order, it is generally better to have them in order of closest relative to furthest relative to avoid obscuring a distant relative (smaller segment) by a close relative (larger segment). Use the up-arrow and down-arrow to change the order of the Association.
{{-}}
[[File:AddonDNA-SegmentMapGramplet-addon-RelationshipView-bottombar-DNAexample-SegmentMap260.png|thumb|600px|right]]Add the {{man label|DNA gramplet Segment Map Gramplet}} to the Person viewRelationship View's bottom bar. Select the {{man label|DNA Segment Map}} tab. The segment map will be color coded by associated person. For each Chromosome the top portion is the P (Paternal) side and the M (Maternal) side is the bottom portion. If the chromosome segment side (Paternal or Maternal) is unknown, the segment will cover both the top and bottom portions of the chromosome and be 50% transparent.
{{-}}
[[File:AddonDNA-SegmentMapGramplet-DNAaddon-SegmentMapdetached-with-Tooltip2tooltip-example-5160.png|thumb|600px|right]]
Hovering the cursor over a known segment will pop up the name of the associated person and the length (in cMs) of the shared segment.
{{-}}
[[File:AddonDNA-DNASegmentMapGramplet-addon-detached-SingleChromosomeView-SegmentMapexample-Single60.png|thumb|600px|right]]
Clicking on the Y-axis label for the 6th chromosome, a detailed single Chromosome View is shown. Click on the background to return to the complete view.
{{-}}
=== Reference Info ===
==== Centromere Areas ====
Machines have difficulties to read the area around the centromere. There are less SNPs to read, therefore there is higher probability of false positive matches. For example, if you have a match exactly around the centromere, then it is most probably a false positive match. If you want to visualize these areas, edit the config file as described above and set show-centromere to 1. The area of the centromere id dependent on the Build (36, 37, or 38). For example, the list for Build 37 (the most common) is
<pre>
</pre>
To view the and visualize these centromere areas for all chromosomes, edit the [[#Configuration|config]] file as described below and set show-centromere to change this option:1.
<pre>
show-centromere=1
</pre>
== Issues ==
* If there are overlapping segments within a maternal/paternal view of a chromosome, only the front (last drawn) will be pickable. The tooltip will still provide the details of the hidden segments. Changing the order of Associations (using the up-arrow and down-arrow) to have the closer relatives before further relatives will fix this. To see overlapping segments, select a single chromosome.
* When the user has no DNA data, have the gramplet still show a blank chromosome chart & legend with a message link to this page?
* Legend with rollover tooltip does not work (win 10)
=== Future feature To Do ===
* Add user config to specify the Association Type. Currently, the Association Type of DNA is used for this gramplet. It could be made user-controllable.
=== History ===
* DNA Segment Map gramplet [https://github.com/gramps-project/addons-source/pull/550 Pull Request #550] (GitHub pre-release) Jun 25, 2023
* [https://gramps.discourse.group/t/updated-dna-gramplet-ready-for-review/807 Updated DNA gramplet ready for review], Discourse forum discussion on the DNAgramplet; 15th of October, 2020
== See also ==
* [[Addon:DNAMatches|DNA Matches gramplet]] addon presents the users with a table of people whose DNA has a match with the currently selected person.
* [[Addon:SyncAssociation|Sync Association]] addon tool - For every Association, if there is not a reciprocal Association then it will be created. That is, where Person John Smith has a DNA Association (with an Association Note) to Person Jane Jones, then if Jane Jones does not have a corresponding DNA Association to John Smith, it will be created which shares the Note.
* [[Addon:SyncAssociation#Add_Types_to_the_Sync_Association_tool|Add Types to the SyncAssociation tool]]
* [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Associations|Introduction to Associations in Gramps]]
* [[Roles, Relationships & Associations]]
* [[Genetics]]
* [https://thegeneticgenealogist.com/2016/11/21/visual-phasing-an-example-part-1-of-5 Visual Phasing: An Example (Series of 5 parts)], By The Genetic Genealogist, 21st November 2016
[[Category:Plugins]]
[[Category:Addons]]