Learn R Programming

⚠️There's a newer version (1.0.3) of this package.Take me there.

ggenealogy

Motivation:

Genealogists wish to study the parent-child relationship between groups of organisms. Visual representations of genealogical relationships allow scientists to more effectively understand the historical changes that caused novel and desirable traits to arise in lineages. For example, in crops, desirable modifications could include an increase in protein yield or an increase in disease resistance. However, there are also times when lineages of detrimental traits can be viewed, such as to determine the origin of hazardous traits in rapidly-evolving viruses.

While there are visual methods available for genealogical data structures, there is a need for additional development of tools that are more customized to particular needs that arise when scientists want to make informed decisions while visualizing their data.

Description:

This package provides methods for searching through genealogical data and displaying the results. The available plotting algorithms can assist users in performing data exploration, as well as in generating publication-quality images. This package uses the Grammar of Graphics.

Some of the currently-available methods include:

  • Drawing genealogy trees from database of known lineage.
  • Selecting generation number of ancestors and descendants to show around a given variety.
  • Showing shortest path between two given varieties, and superimpose over full lineage structure.
  • Obtaining graph theory measures of the full lineage structure.
  • Producing color matrix plots of variables between a subset of varieties.
  • Interactively visualizing genealogical structure

Installation:

  • The latest released version: install.packages("ggenealogy")
  • The latest development version: install_github("lrutter/ggenealogy")

Resources:

Installation of the package will automatically download a vignette, which contains a more thorough explanation of the available methods, and example code.

License:

GPL

Copy Link

Version

Install

install.packages('ggenealogy')

Monthly Downloads

211

Version

0.2.0

License

GPL

Maintainer

Lindsay Rutter

Last Published

July 3rd, 2016

Functions in ggenealogy (0.2.0)

buildAncDesCoordDF

Returns the coordinate positions of all ancestors and descendants of a variety.
buildMinusPathDF

Process the genealogy graph
buildAncList

Returns the ancestors of a particular variety (if they exist).
buildPathDF

Build data frame for path representation
buildDesList

Returns the descendants of a particular variety (if they exist).
dfToIG

Process the genealogy graph
buildSpreadTotalDF

Build a data frame where the varieties are spread so they do not overlap
buildAncDesTotalDF

Returns data frame with plot coordinates of all ancestors and descendants of a variety.
buildPlotTotalDF

Build all labels in the graph
buildEdgeTotalDF

Build the edges in the genealogy graph.
getChild

Returns the children of a particular variety (if they exist)
getParent

Returns the parents of a particular variety (if they exist)
getPath

Determine the path between two varieties
getDegree

Determine the degree between two varieties
plotPath

Construct the graphic object of the path
getEdges

Returns edges (vertex names and edge weights) for the full genealogy
getYear

Determine the year of a variety
getDescendants

Returns a list of the descendants of a particular variety (if they exist)
getBasicStatistics

Determine basic statistics of the graph object
plotAncDes

Returns the image object to show the ancestors and descendants of a variety
nodeToDF

Returns the data frame representation of all ancestors and descendants of a variety
plotYearMatrix

Returns the image object to show the heat map of years between the inputted set of vertices
isParent

Determine if a variety is a parent of another
statGeneal

Academic statistics data
plotDegMatrix

Returns the image object to show the heat map of degrees between the inputted set of vertices
isChild

Determine if a variety is a child of another
sbGeneal

Soybean data
getNodes

Returns the nodes for a full genealogy
plotPathOnAll

Plot a path between two vertices over the full genealogy
getAncestors

Returns a list of the ancestors of a particular variety (if they exist)