Skip to content
🌶 An R package for genetic analysis of populations with mixed (clonal/sexual) reproduction
R C Other
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
R update read.genalex to take in character data May 23, 2020
data add documentation for Pram Jun 29, 2015
docs update broken links Feb 12, 2020
inst Hyperlink DOIs against preferred resolver May 19, 2018
man update cran comments Feb 24, 2020
src comment out unused code May 13, 2018
tests update read.genalex to take in character data May 23, 2020
tools add parallel message to startup Jul 9, 2015
vignettes update broken links Feb 12, 2020
.gitignore first step in converting Rnw -> Rmd [skip ci] Aug 28, 2016
.travis.yml travis 🔥 🔥 Mar 5, 2019 rename conduct [skip ci] Apr 3, 2018 Add and (#146) Sep 3, 2017
CRAN-RELEASE published on CRAN Feb 26, 2020
DESCRIPTION bump version; update NEWS Feb 19, 2020 update issue template [skip ci] Jan 15, 2018
Makefile update makefile to update branch Dec 15, 2015
NAMESPACE add distenv slot and accessor to mlg class Jun 16, 2019 update read.genalex to take in character data May 23, 2020 fix broken URL in README Feb 12, 2020
_pkgdown.yml update main package documentation Aug 29, 2018
appveyor.yml Add appveyor Mar 16, 2018 update cran comments Feb 24, 2020
poppr.Rproj attempt to fix tests on ubuntu Sep 4, 2017

Poppr version 2

Build Status Coverage Status CRAN version CRAN check status Downloads

What is poppr?

Poppr is an R package designed for analysis of populations with mixed modes of sexual and clonal reproduction. It is built around the framework of adegenet's genind and genlight objects and offers the following implementations:

  • clone censoring of populations at any of multiple levels of a hierarchy
  • convenient counting of multilocus genotypes and sub-setting of populations with multiple levels of hierarchy
  • define multilocus genotypes
  • calculation of indices of genotypic diversity, evenness, richness, and rarefaction
  • drawing of dendrograms with bootstrap support for genetic distances
  • drawing of minimum spanning networks for genetic distances
  • calculation of the index of association (Index of association) or (Standardized index of association)
  • batch processing on any server that has R (≥ 2.15.1) installed
  • calculation of Bruvo's distance for microsatellite (SSR) markers (implemented in C for speed)
  • import of data from and export to GenAlEx

New in version 2.0:

  • handling of genomic SNP data
  • custom multilocus genotype definitions
  • collapse multilocus lineages by genetic distance
  • calculate reticulate minimum spanning networks
  • calculate index of association in a sliding window across snps
  • bootstrapping of MLG diversity statistics
  • interactive exploration of minimum spanning networks
  • and more!

For full details, see the NEWS file or type in your R console:

news(Version >= "2.0.0", package = "poppr")


If you use poppr at all, please specify the version and cite:

Kamvar ZN, Tabima JF, Grünwald NJ. (2014) Poppr: an R package for genetic analysis of populations with clonal, partially clonal, and/or sexual reproduction. PeerJ 2:e281

If you use poppr in a presentation please mention it as the poppr R package, specify the version, and use our logo: (png) | (svg).

Additionally, if you use any following functionalities:

  • minimum spanning networks with reticulation
  • collapsing multilocus genotypes into multilocus lineages with mlg.filter()
  • custom multilocus genotype definitions with mlg.custom()
  • index of association for genomic data with win.ia() or samp.ia()
  • bootstrapping any genetic distance with genind, genlight, or genpop objects with aboot()

Please also cite:

Kamvar ZN, Brooks JC and Grünwald NJ (2015) Novel R tools for analysis of genome-wide population genetic data with emphasis on clonality. Front. Genet. 6:208. doi: 10.3389/fgene.2015.00208

You can obtain citation information in R by typing:

citation(package = "poppr")



Binary versions for mac and windows are available for R ≥ 2.15.1 here.

To install, make sure R is at least version 2.15.1 (the authors recommend ≥ 3.0), and in your console, type:


If you want the absolute latest version of poppr, see about installing from github below.

Stable and Development versions

To install this package from github, make sure you have the following:

For Linux users, make sure that the function getOption("unzip") returns "unzip" or "internal". If it doesn't, then run options(unzip = "internal").

Once you have devtools and a C compiler installed, you can use the install_github() function to install the current version from github.

Stable version

This release will contain bug fixes and new, documented, and stable features that will be included in future releases. Note: if you don't have LaTeX installed, you should set build_vignettes = FALSE.

devtools::install_github(repo = "grunwaldlab/poppr", build_vignettes = TRUE)

Unstable/Development versions

All new features in testing will be released on different branches. These features will be in various stages of development and may or may not be documented. Install with caution. The below command would install features on the branch called "devel". Note that these branches might be out of date from the master branch.

devtools::install_github(repo = "grunwaldlab/poppr@devel", build_vignettes = TRUE)

Help / Documentation

R documentation

To access a descriptive index of help files in poppr, type in your console:



A few vignettes have been written for poppr:

Title Command
Algorightms and Equations vignette("algo", "poppr")
Data import and manipulation vignette("poppr_manual", "poppr")
Multilocus Genotype Analysis vignette("mlg", "poppr")

User Group

Users who have any questions/comments/suggestions regarding any version of poppr (stable or development) should direct their comments to the Poppr google group


In Spring of 2014, Dr. Niklaus J. Grünwald, Dr. Sydney E. Everhart and Zhian N. Kamvar wrote a primer for population genetic analysis in R located at


Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. If you wish to contribute code to poppr, please fork the repository and create a pull request with your added feature.

You can’t perform that action at this time.