Skip to content

An online pedigree tool for research applications. Build pedigrees interactively and store as images or text files in ped format. QuickPed also computes a variety of relatedness coefficients and offers verbal descriptions of pairwise relationships.

License

Notifications You must be signed in to change notification settings

magnusdv/quickped

Repository files navigation

QuickPed

What is QuickPed?

QuickPed is an interactive web application for drawing and analysing pedigrees. A created pedigree may be saved as an image, as a .ped file (see below) or in the form of R code to reproduce the plot. You may also obtain various information about the pedigree, including relatedness coefficients and verbal descriptions of relationships.

QuickPed is powered by the pedsuite, and uses kinship2 for plot alignment calculations. The web app was built with Shiny.

Getting started

Creating pedigrees with QuickPed is very intuitive: Select a suitable start pedigree and modify it as needed. You may also load an existing ped file (see below). Modifications are done by clicking on one or several individuals and then applying appropriate buttons, for instance to add children, siblings or parents. At any time you may change attributes like sex, affection status, twin status and ID labels.

Tips and tricks

  • Selecting individuals. Select/deselect pedigree members by clicking on them. Selected individuals are shown in red colour. To deselect everyone, click the button.

  • Adding parents. If you select a single founder and click “Add Parents,” new parents will be created for this individual. From version 4.1.1, you can also assign existing members as parents. First, select the child, then the intended parent(s) — the order of selection matters! Finally, click “Add Parents.”

  • Labels: Automatic labelling of the pedigree members are available in two different formats. The button marked 1,2,.. applies numeric labels to all individuals, in the order of their appearance in the pedigree plot. Alternatively, the I-1, I-2,.. button numbers the members generation-wise, using roman numerals to indicate the generation number.

  • Line breaks in labels. By default, pedigree labels are folded automatically to width approximately 12 characters. To insert hard line breaks, use a double space. For instance, if you want “King Lear” to appear on two lines, modify the label to “King␣␣Lear”, i.e., with two spaces between the words.

  • Text annotation. Double clicking on a pedigree member opens a popup window, in which text may be added around and inside the symbol for this individual.

  • Plot settings. If the pedigree gets too large, increase the plot region using the control panel on the far right. Here you may also adjust the margins, the size of pedigree symbols and text labels.

  • R code. The “R code” button, located on the right side of QuickPed, opens a text window containing R code that reproduces the current pedigree plot. By saving this to a .R file, or simply copy-pasting the code into R, you can explore further plot options (see ?pedtools::plot.ped for lots of examples!) or use the pedigree as starting point for analysis with the pedsuite.

Built-in pedigrees

In the left-most panel of QuickPed the user may choose among a selection of standard pedigrees, including trios, full/half siblings, avuncular and cousin pedigrees of different kinds. Also included are several interesting (albeit less common) pedigree structures like double cousins and quad half first cousins. Finally, the following historic pedigrees are available:

Relationship information

Under Relationships there are four buttons offering different analyses of relationships within the loaded pedigree. The buttons are, in order:

  • Describe relationship. Prints a standardised description of the relationship between two selected individuals. The text is generated by verbalisr.

  • Calculate coefficients. Prints the most important relatedness coefficients between two selected individuals:

    • The inbreeding coefficient of each individual.
    • The kinship coefficient $\varphi$.
    • The degree of relationship.
    • The IBD coefficients $\kappa = (\kappa_0, \kappa_1, \kappa_2)$, if both individuals are non-inbred.
    • The condensed identity coefficients $\Delta = (\Delta_1, ..., \Delta_9)$, if either individual is inbred.
  • Relatedness triangle. Produces a plot representing the IBD coefficients $\kappa$ as a point in a relatedness triangle.

  • Table of coefficients. Activates a popup window where the user can choose among a variety of coefficients, including detailed identity and X-chromosomal coefficients, to be computed for each pair of pedigree members. Generates a tab-separated file for download.

More information about these coefficients can be found in the documentation of the ribd package, which is used in the calculations.

Ped files

A useful feature of QuickPed is to produce text files describing pedigrees in so-called ped format. Such files are often required by software for pedigree analysis.

For a simple illustration, consider this pedigree:

A text file describing this pedigree may contain the following.

 id fid mid sex aff
  1   0   0   1   1
  2   0   0   2   1
  3   1   2   2   2

The columns are:

  • id: Individual ID
  • fid: Father’s ID (or 0 if not included in the pedigree)
  • mid: Mother’s ID (or 0 if not included in the pedigree)
  • sex: Sex (1 = male; 2 = female; 0 = unknown)
  • aff: Affection status (1 = unaffected; 2 = affected; 0 = unknown)

It should be noted that the ped format is not completely standardised, and different software may use slightly different versions. For example, a first column with Family ID is sometimes required. Also, the aff column may not be needed in non-medical applications. These and other details may be specified when using QuickPed.

Some pedigree information may be shown on the plot, but is not stored in the ped file. In the current version of QuickPed, this includes colours, text annotations (expect main labels), twin relationships, and deceased status.

About

An online pedigree tool for research applications. Build pedigrees interactively and store as images or text files in ped format. QuickPed also computes a variety of relatedness coefficients and offers verbal descriptions of pairwise relationships.

Topics

Resources

License

Stars

Watchers

Forks