Learn R Programming

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

dartR (version 1.0.5)

Importing and Analysing SNP and Silicodart Data Generated by Genome-Wide Restriction Fragment Analysis

Description

Functions are provided that facilitate the import and analysis of SNP (single nucleotide polymorphism) and silicodart (presence/absence) data. The main focus is on data generated by DarT (Diversity Arrays Technology). However, once SNP or related fragment presence/absence data from any source is imported into a genlight object many of the functions can be used. Functions are available for input and output of SNP and silicodart data, for reporting on and filtering on various criteria (e.g. CallRate, Heterozygosity, Reproducibility, maximum allele frequency). Advanced filtering is based on Linkage Disequilibrium and HWE (Hardy-Weinberg equilibrium). Other functions are available for visualization after PCoA (Principle Coordinate Analysis), or to facilitate transfer of data between genlight/genind objects and newhybrids, related, phylip, structure, faststructure packages.

Copy Link

Version

Install

install.packages('dartR')

Monthly Downloads

4,205

Version

1.0.5

License

GPL-2

Maintainer

Bernd Gruber

Last Published

May 11th, 2018

Functions in dartR (1.0.5)

gl.fixed.diff

Generate a matrix of fixed differences from a genelight or genind object {adegenet}
gl.hwe.pop

Filter function to facilitate analysing of dart data
gl.merge.pop

Merge two or more populations in a genelight {adegenet} object into one population
gl.keep.pop

Remove all but specified populations from a genelight {adegenet} object
gl.outflank

Function to identify loci under selection per population using the outflank method of Whitlock and Lotterhos (2015)
gl.read.dart

Import DarT data into R and conver it to a genlight object
gl2gds

Convert a genlight object to nexus format PAUP SVDquartets
gl.pcoa

PCoA ordination (glPca)
gl.gene.freq

Calculate a statistic for each locus by group An internal function essentially to convey readability to rather contorted R code. It takes as input a genlight {adegenet} object with an index variable (say, population) and calculates the selected statistic for each locus, broken down by the groups defined by the index variable.
gl.subsample.loci

Subsample n loci from a genlight object and return as a genlight object
gl.read.silicodart

Import presence/absence data from SilicoDArT and convert to genind {agegenet} format
util.outflank.MakeDiploidFSTMat

Creates OutFLANK input file from individual genotype info.
gl.pcoa.plot.3d

3D interactive plot of the results of a PCoA ordination
gl.report.callrate

Report summary of Call Rate for loci or individuals
gl.keep.ind

Remove all but the specified individuals from a genelight {adegenet} object
gl2structure

Converts genlight objects to STRUCTURE formated files
gl.pcoa.plot

Bivariate plot of the results of a PCoA ordination
gl.report.monomorphs

Report monomorphic loci, including those with all NAs
gl.report.hamming

Calculates the pairwise Hamming distance between DArT trimmed DNA sequences
gl.tree.nj

Output an nj tree to summarize genetic similarity among populations
gl.ibd

Isolation by distance
gl.recalc.metrics

Recalculate locus metrics when individuals or populations are deleted from a genlight {adegenet} object
gl.report.pa

Report number of private alleles possessed by an individual of unknown provenance
gl.make.recode.ind

Create a proforma recode_ind file for reassigning individual (=specimen) names
gl.sexlinkage

Identify loci that are sex linked in specimens in a genlight {adegenet} object
utils.hwe

Calculates departure from Hardy-Weinberg Equilibrium. Utility script not meant for end users.
gl.nhybrids

Create an input file for the program NewHybrids and run it if NewHybrids is installed
gl.read.dart.2row

Import SNP data from DArT and convert to genlight {agegenet} format (gl)
utils.recalc.avgpic

A utility script to recalculate the OneRatioRef, OneRatioSnp, PICRef, PICSnp, and AvgPIC by locus after some populations have been deleted.
gl2gi

Converts a genlight object to genind object
gl.report.hwe

Reports departure from Hardy-Weinberg Equilibrium
utils.recalc.callrate

A utility script to recalculate the callrate by locus after some populations have been deleted
utils.recalc.freqhets

A utility script to recalculate the the frequency of the heterozygous SNPs by locus after some populations have been deleted
gl.make.recode.pop

Create a proforma recode_pop_table file for reassigning population names
gl.pcoa.pop

PCoA ordination of populations
gl.utils.fdsim

Estimate the rate of false positives in a fixed difference analysis
gl2svdquartets

Convert a genlight object to nexus format PAUP SVDquartets
gl.percent.freq

Generate percentage allele frequencies by locus and population
gl.report.secondaries

Report loci containing secondary SNPs in a genlight {adegenet} object
gl2fasta

Concatenates DArT trimmed sequences and outputs a fastA file.
testset_pop_recode

Recode file to be used with the function.
gl.recode.ind

Recode individual (=specimen) labels in a genelight or genind object {adegenet}
gl2shp

Convert genlight objects to ESRI shapefiles
gl.report.ld

Calculates pairwise population based Linkage Disequilibirum across all loci using the specifyied number of cores
utils.hamming

Calculates the Hamming distance between two DArT trimmed DNA sequences
gl.report.maf

Report minor allele frequency for loci
gl.report.heterozygosity

Reports hetrozygosity
utils.recalc.freqhomsnp

A utility script to recalculate the the frequency of the homozygous alternate SNP by locus after some populations have been deleted
gl2faststructure

Export DArT genlight object {adegenet} to faststructure format (to run faststructure elsewhere)
gl.report.bases

Summary of base pair frequencies
gl.recode.pop

Recode population assignments in a genelight object {adegenet}
gl.pcoa.scree

Produce a plot of eigenvalues, standardized as percentages, derived from a PCoA
testset_metadata

Metadata file. Can be integrated via the dart2genlight function.
is.fixed

Test to see if two populations are fixed at a given locus
gl.report.repavg

Report summary of RepAvg, reproducibility averaged over both alleles for each locus in a genlight adegenet object
testset.gl

A genlight object created via the read.dart functions
gl.write.csv

util.outflank.plotter

Plotting functions for Fst distributions after OutFLANK This function takes the output of OutFLANK as input with the OFoutput parameter. It plots a histogram of the FST (by default, the uncorrected FSTs used by OutFLANK) of loci and overlays the inferred null histogram.
platy

Example data set as text file to be imported into a genlight object
testset_SNPs_2Row

Testfile in DArT format (as provided by DArT)
gl2demerelate

Create a dataframe suitable for input to package {Demerelate} from a genlight {adegenet} object
gl2phylip

Create a Phylip input distance matrix from a genlight (SNP) or genind (SilicoDarT) {adegenet} object
prob.hwe

Exact SNP test of Hardy-Weinberg Equilibrium
read.dart

Import DarT data to R
util.outflank

OutFLANK: An Fst outlier approach by Mike Whitlock and Katie Lotterhos, University of British Columbia.
utils.recalc.freqhomref

A utility script to recalculate the the frequency of the homozygous reference SNP by locus after some populations have been deleted
gl.collapse

Collapse a distance matrix by amalgamating populations
gl.drop.pop

Remove specified populations from a genelight {adegenet} object
gi2gl

Converts a genind object to genlight object
gl.dist

Calculate a distance matrix for populations defined in an {adegenet} genlight object
gl.collapse.pval

Collapse a fixed distance matrix by amalgamating populations for which fixed differences are not significant
gl.collapse.recursive

Recursively collapse a distance matrix by amalgamating populations
gl.filter.cloneid

Filter for CloneID to select only unique SNPs
gl.assign

Assign an individual of unknown provenance to population
gl.edit.recode.ind

Create or edit a individual (=specimen) names and create an recode_ind file
gl.filter.callrate

Filter loci or specimens in a genlight {adegenet} object based on call rate
gl.filter.secondaries

Filter loci that represent secondary SNPs in a genlight {adegenet} object
gl.edit.recode.pop

Create or edit a population re-assignment table
dart2genlight

Convert DarT to genlight
gl.drop.ind

Remove specified individuals from a genelight {adegenet} object
gl.filter.monomorphs

Remove monomorphic loci, including those with all NAs
gl.filter.repavg

Filter loci in a genlight {adegenet} object based on average reproducibility of alleles at a locus
gl.filter.hwe

Filters loci that show significant departure from Hardy-Weinberg Equilibrium
gl.filter.hamming

Filters loci in a genlight object based on pairwise Hamming distance between sequence tags