Open main menu

Gramps β

Changes

Addon:DNASegmentMapGramplet

1,143 bytes added, 01:40, 4 November 2025
History
You can install the {{man label|DNA Segment Map Gramplet}} on the bottombar of one of the People or Relationship category list views.
The Initially the {{man label|DNA Segment Map Gramplet}} with no DNA information (chromosome data) is empty as the purpose of this gramplet is to view DNA segment data for the active user and a set of associated users. Once the user has done an autosomal DNA test and uploaded their data to one of the [[#Getting_the_chromosome_data|vendors]] (GEDmatch or FamilyTreeDNA, for example), the vendor can calculate the shared DNA segments with others in their system. These list of people with their shared segments are input to this gramplet for visualization.
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.
=====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 form of a note with a single line specifying '''Shared DNA''', '''Unweighted shared DNA''' and the '''Longest segment''', in that order, separated by tabs result: [[File:Ancestry.com-unweighted-dna-example2025.png|thumb|450px|right|An example of a DNA match where the individuals share 55cM or commas, like soidentical DNA from a recent common ancestor. They also share an additional 17cM of identical DNA not from a common ancestor. Copied from https: <code>168,5,68</code>/support.ancestry.com/s/article/Understanding-Unweighted-Shared-DNA ]]
You can find this information by going to your DNA Matches comparison page and selecting the link to show the page that list
<pre>
You and [Name of Match]
Longest segment XXXX cM
</pre>
 
From this information you can create a note with a single line specifying '''Shared DNA''', '''Unweighted shared DNA''' and the '''Longest segment''', in that order, separated by tabs or commas, for example screenshot the result would be: <code>55,72,21</code>
 
{{-}}
====Legend====
====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.
==== Example ====
[[File:DNA-SegmentMapGramplet-addon-Associations-Note-with-DNA-data-example-60.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:DNA-SegmentMapGramplet-addon-PersonReferenceEditor-example-60.png|thumb|600px|right]]
=== Reference Info ===
==== Untested Areas ====
There are areas in the DNA test that are generally not tested as they are not reliable indicators of a match. If you want to visualize these areas, create a dummy person and add an association with the following DNA segments.
 
<pre>
13,1,19020094,0,0
14,1,19067948,0,0
15,1,20004965,0,0
21,1,9922017,0,0
22,1,16055121,0,0
</pre>
 
==== 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. 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>
== To Do ==See also:* [https://en.wikipedia.org/wiki/Centromere Centromere] - From Wikipedia, the free encyclopedia
The following ==== Untested Areas ====There are capabilities areas in the DNA test that are currently disabled but can be enabled if user desiregenerally not tested as they are not reliable indicators of a match. These If you want to visualize these areas, create a dummy person and add complications to an association with the user interface and are deemed not beneficialfollowing DNA segments.
* Add user config to specify the Association Type. Currently<pre>13, the Association Type of DNA is used for this gramplet. It could be made user-controllable.1,19020094,0,014,1,19067948,0,015,1,20004965,0,021,1,9922017,0,022,1,16055121,0,0</pre>
== Issues ==
* 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 ==
* DNA Segment Map gramplet [https://github.com/gramps-project/addons-source/pull/550 Pull Request #550] (GitHub pre-release)
* [[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]]
* [https://gramps.discourse.group/t/updated-dna-gramplet-ready-for-review/807 Discourse forum discussion on the DNAgramplet]
* [[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]]