Addon:DNAMatches

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.

File:Addon-DNAMatches-Example.png

Example DNA Matches table.

The DNA Matches gramplet addon 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 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: 168,5,68

Navigation

Double-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.

[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

Hide Columns

Changing a value under this heading to 1 will hide that specific column from the table. For example, relationship=1 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, relationship=1 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

• DNA Segment Map Gramplet - addon
• Sync Association addon tool
• New Gramplet: DNA Matches Introduction thread for this gramplet on the Forum. Oct 22nd, 2023
  • Original pull request for this addon. Gramps 5.1 & Gramps 5.2
• Introduction to Associations in Gramps
• Roles, Relationships & Associations
• Genetics