Tools and Resources

A community-maintained standard library of population genetic models

Department of Biology and Institute of Ecology and Evolution, University of Oregon, United States
Weatherall Institute of Molecular Medicine, University of Oxford, United Kingdom
Simons Center for Quantitative Biology, Cold Spring Harbor Laboratory, United States
Department of Genetics, University of North Carolina at Chapel Hill, United States
Lundbeck GeoGenetics Centre, Globe Institute, University of Copenhagen, Denmark
Department of Ecology and Evolutionary Biology, University of California, Los Angeles, United States
Department of Human Genetics, McGill University, Canada
Melbourne Integrative Genomics, School of Mathematics and Statistics, University of Melbourne, Australia
Department of Mathematical Stochastics, University of Freiburg, Germany
Department of Genome Sciences, University of Washington, United States
The Biodesign Institute and The School of Life Sciences, Arizona State University, United States
Department of Human Genetics, David Geffen School of Medicine, University of California, Los Angeles, United States
The Efi Arazi School of Computer Science, Herzliya Interdisciplinary Center, Israel
Department of Biology, Stanford University, United States
Department of Ecology, Evolution, and Environmental Biology, Columbia University, United States
Department of Computational BiologyCornell University, United States
Computer Technologies Laboratory, ITMO University, Russian Federation
International Laboratory for Human Genome Research, National Autonomous University of Mexico, Mexico
Departmentof Molecular and Cellular Biology, University of Arizona, United States
Department of Mathematics, University of Oregon, United States
Big Data Institute, Li Ka Shing Centre for Health Information and Discovery, University of Oxford, United Kingdom

Jun 23, 2020

https://doi.org/10.7554/eLife.54967

Open access
Copyright information

Version of Record

Accepted for publication after peer review and revision.

Download
Cite
Share
CommentOpen annotations (there are currently 0 annotations on this page).

Version of Record published: August 19, 2020 (This version)
Accepted Manuscript updated: June 25, 2020 (Go to version)
Accepted Manuscript published: June 23, 2020 (Go to version)
Accepted: June 15, 2020
Received: January 7, 2020

1. Built upon by
Expanding the stdpopsim species catalog, and lessons learned for realistic genome simulations

M Elise Lauterbur, Maria Izabel A Cavassim ... Ilan Gronau

Research Advance Jun 21, 2023
Further reading

Abstract
Introduction
Results
Discussion
Materials and methods
Appendix 1
Data availability
References
Article and author information
Metrics

Abstract

The explosion in population genomic data demands ever more complex modes of analysis, and increasingly, these analyses depend on sophisticated simulations. Recent advances in population genetic simulation have made it possible to simulate large and complex models, but specifying such models for a particular simulation engine remains a difficult and error-prone task. Computational genetics researchers currently re-implement simulation models independently, leading to inconsistency and duplication of effort. This situation presents a major barrier to empirical researchers seeking to use simulations for power analyses of upcoming studies or sanity checks on existing genomic data. Population genetics, as a field, also lacks standard benchmarks by which new tools for inference might be measured. Here, we describe a new resource, stdpopsim, that attempts to rectify this situation. Stdpopsim is a community-driven open source project, which provides easy access to a growing catalog of published simulation models from a range of organisms and supports multiple simulation engine backends. This resource is available as a well-documented python library with a simple command-line interface. We share some examples demonstrating how stdpopsim can be used to systematically compare demographic inference methods, and we encourage a broader community of developers to contribute to this growing resource.

Introduction

While population genetics has always used statistical methods to make inferences from data, the degree of sophistication of the questions, models, data, and computational approaches used have all increased over the past two decades. Currently, there exist a myriad of computational methods that can infer the histories of populations (Gutenkunst et al., 2009; Li and Durbin, 2011; Excoffier et al., 2013; Schiffels and Durbin, 2014; Terhorst et al., 2017; Ragsdale and Gravel, 2019), the distribution of fitness effects (Boyko et al., 2008; Kim et al., 2017; Tataru et al., 2017; Fortier et al., 2019; Huang and Siepel, 2019; Vecchyo et al., 2019), recombination rates (McVean et al., 2004; Chan et al., 2012; Lin et al., 2013; Adrion et al., 2020; V Barroso et al., 2019), and the extent of positive selection in genome sequence data (Kim and Stephan, 2002; Eyre-Walker and Keightley, 2009; Alachiotis et al., 2012; Garud et al., 2015; DeGiorgio et al., 2016; Kern and Schrider, 2018; Sugden et al., 2018). While these methods have undoubtedly increased our understanding of genetic and evolutionary processes, very little has been done to systematically benchmark the quality of these inferences or their robustness to deviations from their underlying assumptions. As large databases of population genetic variation begin to be used to inform public health procedures, the accuracy and quality of these inferences is becoming ever more important.

Assessing the accuracy of inference methods for population genetics is challenging in large part because the ‘ground-truth’ in question generally comes not from direct empirical observations, as the relevant historical processes can rarely be observed, but instead from simulations. Population genetic simulations are therefore critically important to the field, yet there has been no systematic attempt to establish community standards or best practices for executing them. Instead, the general modus operandi to date has been for individual groups to validate their own methods using simulations coded from scratch. Often these simulations are more useful to showcase a novel method than to rigorously compare it with competing methods. Moreover, this situation results in a great deal of duplicated effort, and contributes to decreased reproducibility and transparency across the entire field. It is also a barrier to entry to the field, because new researchers can struggle with the many steps involved in implementing a state-of-the-art population genetics simulation, including identifying appropriate demographic models from the literature, translating them into input for a simulator, and choosing appropriate values for key population genetic parameters, such as the mutation and recombination rates.

A related issue is that it has been challenging to assess the degree to which modeling assumptions and choices of data summaries can affect population genetic inferences. Standardized simulations would enable these questions to be systematically examined. Importantly, there are clear examples of different methods yielding fundamentally different conclusions. For example, Markovian coalescent methods applied to human genomes have suggested large ancient (> 100,000 years ago) ancestral population sizes and bottlenecks that have not been detected by other methods based on allele frequency spectra (see Beichman et al., 2017). These distinct methods differ in how they model, summarize, and optimize fit to genetic variation data, suggesting that such design choices can greatly affect the performance of the inference. Furthermore, some methods are likely to perform better than others under certain scenarios, but researchers lack principled guidelines for selecting the best method for addressing their particular questions. The need for guidance from simulated data will only increase as researchers seek to apply population genetic methods to a growing collection of non-model taxa.

For these reasons, we have generated a standardized, community-driven resource for simulating published demographic models from a number of popular study systems. This resource, which we call stdpopsim, makes running realistic simulations for population genetic analysis a simple matter of choosing pre-implemented models from a community-maintained catalog. The stdpopsim catalog currently contains six species: humans, Pongo abelii, Canis familiaris, Drosophila melanogaster, Arabidopsis thaliana, and Escherichia coli. For each species, the catalog contains curated information on our current understanding of the physical organization of its genome, inferred genetic maps, population-level parameters (e.g. mutation rate and generation time estimates), and published demographic models. These models and parameters are meant to represent the field’s current understanding, and we intend for this resource to evolve as new results become available, and other existing models are added to stdpopsim by the community. We have implemented both a command line interface and a simple Python API that can be used to simulate genomic data from a choice of organism, genetic map, chromosome, and demographic history. In this way, stdpopsim will lower the barrier to high-quality simulation for exploratory analyses, enable rigorous evaluation of population genetic software, and contribute to increased reliability of population genetic inferences.

The stdpopsim library has been developed by the PopSim Consortium using a distributed open source model, with strong procedures in place to continue its growth and maintain quality. Importantly, we developed rigorous quality control methods to ensure that we have correctly implemented the models as described in their original publication and provided documented methods for others to contribute new models. We invite new collaborators to join our community: those interested should visit our developer documentation at https://stdpopsim.readthedocs.io/en/latest/development.html. Below we describe the resource and give examples of how it can be used to benchmark demographic inference methods.

Results

The stdpopsim library is a community-maintained collection of empirical genome data and population genetics simulation models, illustrated in Figure 1. The package (https://github.com/popsim-consortium/stdpopsim) centers on a catalog of genomic information and demographic models for a growing list of species (Figure 1A), and software resources to facilitate efficient simulations (Figure 1B–C). Given the genome data and simulation model descriptions defined within the library, it is straightforward to run standardized simulations across a range of organisms. Stdpopsim has a Python API and a user-friendly command line interface, allowing users with minimal experience direct access to state-of-the-art simulations. Simulations are output in the ‘succinct tree sequence’ format (Kelleher et al., 2016; Kelleher et al., 2018; Kelleher et al., 2019), which contains complete genealogical information about the simulated samples, is extremely compact, and can be processed efficiently using the tskit library (Kelleher et al., 2016; Kelleher et al., 2018). The tree sequence format could also be converted to other formats (e.g., VCF) by the user if desired.

Figure 1

Download asset Open asset

Structure of stdpopsim.

(A) The hierarchical organization of the stdpopsim catalog contains all model simulation information within individual species (expanded information shown here for *H. sapiens* only). Each species is associated with a representation of the physical genome, and one or more genetic maps and demographic models. Dotted lines indicate that only a subset of these categories is shown. At right we show example code to specify and simulate models using (B) the python API or (C) the command line interface.

The species catalog

The central feature of stdpopsim is the species catalog, a systematic organization of the key quantitative data needed to simulate a given species. Data are currently available for humans, P. abelii, C. familiaris, D. melanogaster, A. thaliana, and E. coli. A species definition consists of two key elements. Firstly, the library defines some basic information about our current understanding of each species’ genome, including information about chromosome lengths, average mutation rate estimates, and generation times. We also provide access to detailed empirical information such as inferred genetic maps, which model observed heterogeneity in recombination rate along chromosomes. Such maps are often large, so we do not distribute them directly with the software, but make them available for download in a standard format. When a simulation using such a map is requested by the user, stdpopsim will transparently download the map data into a local cache, where it can be quickly retrieved for subsequent simulations. In the initial version of stdpopsim, we support the HapMapII (Frazer et al., 2007) and deCODE (Kong et al., 2010) genetic maps for humans; the Nater et al., 2017 maps for P. abelii; the Campbell et al., 2016 map for C. familiaris; the Salomé et al., 2012 map for A. thaliana; and the Comeron et al., 2012 map for D. melanogaster. Adding further maps to the library is straightforward. The second key element of a species description within stdpopsim is a set of carefully curated population genetic model descriptions from the literature, which allow simulation under specific historical scenarios that have been fit to present-day patterns of genetic variation (see the Materials and methods for a description of the community development and quality-control process for these models.)

The current demographic models in the stdpopsim catalog are shown in Table 1. Homo sapiens currently has the richest selection of population models. These include: a simplified version of the Tennessen et al., 2012 model with only the African population specified (expansion from the ancestral population and recent growth; Africa_1T12); the three-population model of Gutenkunst et al., 2009, which specifies the out-of-Africa bottleneck as well as the subsequent divergence of the European and Asian populations (OutOfAfrica_3G09); the Tennessen et al., 2012 two-population variant of the Gutenkunst et al. model, which does not include Asian populations but more explicitly models recent rapid human population growth in Europe (OutOfAfrica_2T12); the Browning et al., 2018 admixture model for American populations, which specifies ancestral African, European, and Asian population components (AmericanAdmixture_4B11); a three-population out-of-Africa model from Ragsdale and Gravel, 2019, which includes archaic admixture (OutOfAfricaArchaicAdmixture_5R19); a complex model of ancient Eurasian admixture from Kamm et al., 2019 (AncientEurasia_9K19); and a synthetic model of oscillating population size from Schiffels and Durbin, 2014 (Zigzag_1S14).

Table 1

Initial set of demographic models in the catalog and summary of computing resources needed for simulation.

For each model, we report the CPU time, maximum memory usage and the size of the output tskit file, as simulated using the msprime simulation engine (version 0.7.4). In each case, we simulate 100 samples drawn from the first population, for the shortest chromosome of that species and a constant chromosome-specific recombination rate. The times reported are for a single run on an Intel i5-7600K CPU. Computing resources required will vary widely depending on sample sizes, chromosome length, recombination rates and other factors.

Model ID	Citation	CPU(s)	Ram(MB)	File(MB)
HomSap (Homo sapiens)
Africa_1T12	Tennessen et al., 2012	10.0	194.2	23.3
Zigzag_1S14	Schiffels and Durbin, 2014	3.3	106.1	7.9
AshkSub_7G19	Gladstein and Hammer, 2019	13.8	216.3	26.4
OutOfAfrica_3G09	Gutenkunst et al., 2009	10.2	182.0	21.1
OutOfAfrica_2T12	Tennessen et al., 2012	10.7	198.4	24.1
AncientEurasia_9K19	Kamm et al., 2019	63.1	304.4	41.2
AmericanAdmixture_4B11	Browning et al., 2018	10.6	188.1	22.3
PapuansOutOfAfrica_10J19	Jacobs et al., 2019	204.5	524.7	77.8
OutOfAfricaArchaicAdmixture_5R19	Ragsdale and Gravel, 2019	8.8	185.4	21.7
DroMel (Drosophila melanogaster)
OutOfAfrica_2L06	Li and Stephan, 2006	252.8	678.0	106.7
African3Epoch_1S16	Sheehan and Song, 2016	3.0	123.9	11.5
AraTha (Arabidopsis thaliana)
African2Epoch_1H18	Huber et al., 2018	4.3	220.5	16.5
African3Epoch_1H18	Huber et al., 2018	2.6	241.3	18.4
PonAbe (Pongo abelii)
TwoSpecies_2L11	Locke et al., 2011	7.2	171.9	14.7

For D. melanogaster, we have implemented the three-epoch model estimated by Sheehan and Song, 2016 from an African sample (African3Epoch_1S16), as well as the out-of-Africa divergence and associated bottleneck model of Li and Stephan, 2006, which jointly models African and European populations (OutOfAfrica_2L06). For A. thaliana, we implemented the model in Durvasula et al., 2017 inferred using MSMC. This model includes a continuous change in population size over time, rather than pre-specified epochs of different population sizes (SouthMiddleAtlas_1D17). We have also implemented a two-epoch and a three-epoch model estimated from African samples of A. thaliana in Huber et al., 2018 (African2Epoch_1H18 and African3Epoch_1H18).

In addition to organism-specific models, stdpopsim also includes a generic piecewise constant size model and isolation with migration (IM) model which can be used with any genome and genetic map. Together, these models contain many features believed to affect observed patterns of polymorphism (e.g. bottlenecks, population growth, admixture) and therefore provide useful benchmarks for method development.

To guarantee reproducibility, we have standardized naming conventions for species, genetic maps, and demographic models that will enable long-term stability of unique identifiers used throughout stdpopsim, as described in our documentation (https://stdpopsim.readthedocs.io/en/latest/development.html#naming-conventions).

Simulation engines

Currently, stdpopsim uses the msprime coalescent simulator (Kelleher et al., 2016) as the default simulation engine. Coalescent simulations, while highly efficient, are limited in their ability to model continuous geography or complex selection scenarios, such as recurrent sweeps and background selection. For these reasons, we have also implemented the forward-time simulator, SLiM (Haller and Messer, 2019; Haller and Messer, 2019), as an alternative backend engine to stdpopsim, allowing for the simulation of processes that cannot be modeled under the coalescent. However, as forward-time simulators explicitly model all individuals in a population, simulating large population sizes can be highly demanding of computational resources. One common practice used to address this challenge is to simulate a smaller population, but to rescale resulting times, mutation rates, recombination rates, and selection coefficients so that the intensity of mutation, recombination, and allele frequency change due to selection per unit time remains the same (see the SLiM manual and Uricchio and Hernandez, 2014). Our implementation of the SLiM backend allows easy use of this rescaling through a single ‘scaling factor’ argument. Such down-scaled simulations are not completely equivalent to simulating all individuals in the population, and may lead to subtle differences, especially in the presence of selection. However, since many sequence-based measures of population diversity remain nearly unchanged when rescaling in this fashion, this practice is effective for many purposes and widely employed.

We validated our implementation of the SLiM engine by comparing estimates of several population genetic summary statistics for neutral simulations generated by both SLiM and msprime. Examples of this validation for the AncientEurasia_9K19 model (Kamm et al., 2019) are shown in Appendix 1—figure 1 and Appendix 1—figure 2. For this model, down-scaling factors of up to 10 produce patterns of both diversity and linkage disequilibrium that are indistinguishable from those observed under the coalescent (i.e. msprime). Scaling down by a factor of 50 does appear to modify the distribution of these sequence statistics. Interestingly, the apparent difference between distributions is somewhat larger when simulating using a uniform recombination rate (Appendix 1—figure 2), likely due to the lower variation in the values of these statistics. Importantly, both comparisons validate the equivalence of SLiM and msprime when no down-scaling is applied. The results are also optimistic about the rescaling strategy to reduce computational burden, but the possible effects are not well-understood, so results relying on rescaled simulations should be carefully validated.

Documentation and reproducibility

The stdpopsim command-line interface, by default, outputs citation information for the models, genetic maps, and simulation engines used in any particular run. We hope that this feature will encourage users to appropriately acknowledge the resources used in published work, and encourage authors publishing demographic models to contribute to our ongoing community-driven development process. Together with the stdpopsim version number and the long-term stable identifiers for population models and genetic maps, this citation information will result in well-documented and reproducible simulation workflows. The individual tree sequence files produced by stdpopsim also contain complete provenance information including the command line arguments, operating system environment and versions of key libraries used.

Use case: comparing methods of demographic inference

As an example of the utility of stdpopsim, we demonstrate how it can be easily used to perform a fair comparison of popular demographic inference methods. Although we present comparison of results from several methods, our aim at this stage is not to provide an exhaustive evaluation or ranking of these methods. Our hope is instead to demonstrate how stdpopsim will facilitate more detailed future explorations of the strengths and weaknesses of the numerous inference methods that are available to the population genetics community (see Discussion).

We start by comparing popular methods for estimating population size histories of single populations and subsequently show simple examples of multi-population inference. To reproducibly evaluate and compare the performance of inference methods, we developed workflows using snakemake (Köster and Rahmann, 2012), available from https://github.com/popsim-consortium/analysis, that allow efficient computing in multicore or cluster environments. Our workflow generates $R$ replicates of $C$ chromosomes, producing $n$ population samples in each of a total of $R \times C$ simulations for each demographic model. After simulation, the workflow prepares input files for each inference method by grouping all $n \times R \times C$ simulated chromosomes into a single file. Each file is then converted into an input file appropriate for each inference method (such that all inference methods run on the same simulation replicates). Each of the inference programs are then run in parallel, and finally, estimates of population size history from each program are plotted.

Single-population demographic models

For single-population demographic models, we compared MSMC (Schiffels and Durbin, 2014), SMC++ (Terhorst et al., 2017), and stairway plot (Liu and Fu, 2015) on simulated genomes sampled from a single population, under several of the demographic models described above. However, these experiments raise the question of what to use as the ‘true’ population sizes in the case of multi-population models with migration. In particular, a simple single-population model that is fit to data simulated under a multi-population model, is not expected to recover the actual simulated population sizes because of model misspecification. Instead, we argue that the best one may expect in such a scenario is to infer a model that accurately reflects the coalescence time distribution of the simulated model. Under a multi-population model, the coalescence time distribution is influenced by migration between the target population and populations not analyzed in inference, as well as by the ancestral effective population sizes. The inverse coalescence rate is commonly interpreted as the effective population size, since these are equal in a single-population model with random mating. We thus analytically computed inverse coalescence rates in msprime for each simulated model, and used them as benchmarks for the ‘true’ effective population sizes. See the Appendix for a precise definition and description of the inverse coalescence rate computation.

Figure 2 presents the results from simulations under OutOfAfricaArchaicAdmixture_5R19, a model of human migration out of Africa that includes archaic admixture (Ragsdale and Gravel, 2019), along with an empirical genetic map.In each column of this figure we show the inferred population size history (denoted $N (t)$ ) from samples taken from each of the three extant populations in the model. In each row we show comparisons among the methods (including two sample sizes for MSMC). Blue lines show estimates from each of three replicate whole genome simulations, and black lines indicate the ‘true’ values depicted by the inverse coalescence rates (although in this specific model the inverse coalescence rates are very close to the simulated population sizes; Appendix 1—figure 3). While there is variation in accuracy among methods, populations, and individual replicates, the methods generally produce a good estimate of the true effective population sizes of the simulations, with inferred values mostly within a factor of two of the truth, and most methods inferring a bottleneck at approximately the correct time.

Figure 2

Download asset Open asset

Comparing estimates of $N (t)$ in humans.

Here we show estimates of population size over time ( $N (t)$ ) inferred using four different methods: smc++, stairway plot, and MSMC with $n = 2$ and $n = 8$ samples. Data were generated by simulating replicate human genomes under the OutOfAfricaArchaicAdmixture_5R19 model (Ragsdale and Gravel, 2019) and using the HapMapII_GRCh37 genetic map (Frazer et al., 2007). From top to bottom, we show estimates for each of the three populations in the model (YRI, CEU, and CHB). In shades of blue we show the estimated $N (t)$ trajectories for each of three replicates. As a proxy for the ‘truth’, in black we show inverse coalescence rates as calculated from the demographic model used for simulation (see text).

Using stdpopsim, we can readily compare performance on this benchmark to that based on a different model of human history. In Appendix 1—figure 4, we show estimates of $N (t)$ from simulations using the same physical and genetic maps, but from the OutOfAfrica_3G09 demographic model that does not include archaic admixture. Again we see that each of the methods is capturing relevant parts of the population history, although the accuracy varies across time. In comparing inferences between the models it is interesting to note that $N (t)$ estimates for the CHB and CEU simulated populations are generally better across methods than estimates from the YRI simulated population.

We can also see how well methods might do at recovering the population history of a constant-sized population, with human genome architecture and genetic map. We show results of such an experiment in Appendix 1—figure 5. All methods recover population size within a factor of two of the simulated values; however, SMC-based methods tend to infer sinusoidal patterns of population size even though no such change is present.

As most method development for population genetics has been focused on human data, it is important to ask how such methods might perform in non-human genomes. Figure 3 shows parameter estimates from the African3Epoch_1S16 model, originally estimated from an African sample of D. melanogaster (Sheehan and Song, 2016), and Appendix 1—figure 6 shows estimates from simulations of A. thaliana under the African2Epoch_1H18 model originally inferred by Huber et al., 2018. In both cases, as with humans, we use stdpopsim to simulate replicate genomes using an empirically-derived genetic map, and try to infer back parameters of the simulation model. Accuracy is mixed among methods when doing inference on simulated data from these D. melanogaster and A. thaliana models, and generally worse than what we observe for simulations of the human genome.

Figure 3

Download asset Open asset

Comparing estimates of $N (t)$ in *Drosophila*.

Population size over time ( $N (t)$ ) estimated from an African population sample. Data were generated by simulating replicate *D. melanogaster* genomes under the African3Epoch_1S16 model (Sheehan and Song, 2016) with the genetic map of Comeron et al., 2012. In shades of blue we show the estimated $N (t)$ trajectories for each replicate. As a proxy for the ‘truth’, in black we show inverse coalescence rates as calculated from the demographic model used for simulation (see text).

Multi-population demographic models

As stdpopsim implements multi-population demographic models, we also explored parameter estimation of population divergence parameters. In particular, we simulated data under multi-population models for humans and D. melanogaster and then inferred parameters using $\partial a \partial i$ , fastsimcoal2, and smc++. For simplicity, we conducted inference in $\partial a \partial i$ and fastsimcoal2 by fitting an isolation with migration (IM) model with constant population sizes and bi-directional migration (Hey and Nielsen, 2004). Our motivation for fitting this simple IM model was to mimic the typical approach of two population inference on empirical data, where the user is not aware of the ‘true’ underlying demography and the inference model is often misspecified. For human models with more than two populations (e.g. Gutenkunst et al., 2009) this limitation means that users are inferring parameters for a model that does not match the model from which the data were generated (Figure 4A and B). However, since the model used for inference also allows gene flow between populations, we directly compare estimated effective population sizes to the values used in simulations (black line in Figure 4C) and not the inverse coalescence rates.

Figure 4

Download asset Open asset

Parameters estimated using a multi-population human model.

Here we show estimates of $N (t)$ inferred using $\partial a \partial i$ , fastsimcoal2, and smc++. (A) Data were generated by simulating replicate human genomes under the OutOfAfrica_3G09 model and using the HapMapII_GRCh37 genetic map inferred in Frazer et al., 2007. (B) For $\partial a \partial i$ and fastsimcoal2 we show parameters inferred by fitting the depicted IM model, which includes population sizes, migration rates, and a split time between CEU and YRI samples. (C) Population size estimates for each population (rows) from $\partial a \partial i$ , fastsimcoal2, and smc++ (columns). In shades of blue we show $N (t)$ trajectories estimated from each simulation, and in black simulated population sizes for the respective population. The population split time, $T_{D I V}$ , is shown at the bottom (simulated value in black and inferred values in blue), with a common $x$ -axis to the population size panels.

In Figure 4C, we show estimates of population sizes and divergence time, for each of the inference methods, using samples drawn from African and European populations simulated under the OutOfAfrica_3G09 model. Our results highlight many of the strengths and weaknesses of the different methods. For instance, the SFS-based approaches with simple IM models do not capture recent exponential growth in the CEU population, but do consistently recover the simulated YRI population size history. Moreover, these approaches allow migration rates to be estimated (Appendix 1—figure 7), and lead to more accurate inferences of divergence times. However, these migration rate estimates are somewhat biased. In contrast, smc++ is much better at capturing the recent exponential growth in the CEU population, though it consistently underestimates divergence times because it assumes no migration between populations (Figure 4C).

Again, we can extend this analysis to other taxa and examine the performance of these methods for a two-population model of D. melanogaster. Appendix 1—figure 8 shows inference results using data simulated under the OutOfAfrica_2L06 model. This model includes an ancestral population in Africa from which a European population splits off following a bottleneck, with no post-divergence gene flow between the African and European population (Appendix 1—figure 8A). Here again, we find that $\partial a \partial i$ and fastsimcoal2 infer more consistent histories, but they do not detect the brief bottleneck in Europe, due to the inference model not allowing for population size changes after the population split. In addition, $\partial a \partial i$ and fastsimcoal2 both do reasonably well at correctly inferring the absence of migration (Appendix 1—figure 9). In contrast, the inferred demographic parameters from smc++ are more noisy, though in some cases better capture the short bottleneck in the European population.

Although these results do not represent an exhaustive benchmarking, we have begun to highlight some of the strengths and weaknesses of these methods. Future work should build on these results and undertake more in-depth comparisons under a wider range of simulated demographic models.

Discussion

Here, we have described the first major product from the PopSim Consortium: the stdpopsim library. We have founded the Consortium with a number of specific goals in mind: standardization of simulation within the population genetics community, increased reproducibility and ease of use of complex simulations, community-based development and decision making guiding best practices in population genetics, and benchmarking of inference methods.

The stdpopsim library allows for rigorous standardization of complex population genetic simulations. Population genetics, as a field, has yet to coalesce around a set of standards for the crucial task of method evaluation, which in our discipline hinges on simulation. In contrast, other fields such as structural biology (Moult et al., 1995) and machine learning Russakovsky et al., 2015 have a long track record of standardized method testing. We hope that our efforts represent the beginning of what will prove to be an equally longstanding and valuable tradition in population genetics.

Besides being a resource for developers of computational methods, we aim for stdpopsim to be a resource for empirical researchers using genomic data. For instance, stdpopsim could be used in power analyses to determine adequate sample sizes, or in sanity checks to see if observed data (e.g. levels of divergence or the allele frequency spectrum) are roughly consistent with the hypothesized scenario. Currently, many studies would benefit from such simulation-based checks. However, there are major barriers to implementation, since individual research groups must reimplement complex, previously published demographic models, a task made especially daunting by additional layers of realism (e.g. recombination maps).

Benchmarking population size inference

We have illustrated in this paper how stdpopsim can be used for direct comparisons of inferential methods on a common set of simulations. Our benchmarking comparisons have been limited, but nevertheless reveal some informative features. For example, at the task of estimating population size histories for simulated human populations, we find that the sequence-based methods (MSMC and smc++) perform somewhat better overall—at least for moderate times in the past—than the site frequency spectrum-based method (stairway plot), which tends to over-estimate the sizes of oscillations (Figure 2 and Appendix 1—figure 4). In contrast, stairway plot outperforms the sequence-based methods on simulations of D. melanogaster or A. thaliana populations, in which linkage disequilibrium is reduced (Figure 3 and Appendix 1—figure 6). In simulations of two human populations (Figure 4), $\partial a \partial i$ and fastsimcoal2 do reasonably well at reconstructing the simulated YRI history and estimating divergence times, but struggle with the more complex simulated CEU history, in large part because the methods assume constant population sizes. On the other hand, smc++ does not have the same restrictions on its inferred history, and as a result does much better with the CEU history but tends to underestimate divergence times due to the assumption of no migration. The results for the two-population D. melanogaster model (Appendix 1—figure 8) are generally similar. In these comparisons, fastsimcoal2 and $\partial a \partial i$ perform almost identically, which is expected because they fit the same models to the same summaries of the data, differing only in how they calculate model expectations and optimize parameters.

All methods for inferring demographic history have strengths and weaknesses (as recently reviewed by Beichman et al., 2018). We compared inferences from simulated whole genome data, but many factors affect choice of methodology. Markovian coalescent methods (MSMC and smc++) require long contiguous stretches of sequence data. In contrast, frequency spectrum methods (stairway plot, $\partial a \partial i$ , and fastsimcoal2) can use reduced-representation sequencing data, such as RADseq (Andrews et al., 2016). $\partial a \partial i$ and fastsimcoal2 require a pre-specified parametric model, unlike MSMC, smc++, and stairway plot. Using a parametric approach yields less noisy results, but a model that is too simple may not capture important demographic events (Figure 4 and Appendix 1—figure 8), and other forms of model misspecification may also produce undesirable behavior. From a software engineering perspective, methods also differ in their ease of installation and use. We hope our workflows will assist in the application of all the methods we have considered.

Altogether, these preliminary experiments highlight the utility of stdpopsim for comparing a variety of inference methods on the same footing, under a variety of different demographic models. In addition, the ability of stdpopsim to generate data with and without significant features, such as a genetic map or population-size changes (e.g., Appendix 1—figure 5), allows investigation of the failure modes of popular methods. Moreover the comparison of methods across the various genome organizations, genetic maps, and demographic histories of different organisms, provides valuable information about how methods might perform on non-human systems. Finally, comparison of results across methods or simulation runs provides an estimate of inference uncertainty, analogous to parametric bootstrapping, especially when different methods are vulnerable to model misspecification in different ways.

Next steps

Stdpopsim is intended to be a fully open, community-developed project. Our implementations of genome representations and genetic maps for the some of the most common study systems in computational genetics—humans, Drosophila, and Arabidopsis (among others)—are only intended to be a starting point for future development. Researchers are invited to contribute to the resource by adding their organisms and models of choice. The stdpopsim resource is accompanied by clearly documented standard operating procedures that are intended to minimize barriers to entry for new developers. In this way, we expect the resource to expand and adapt to meet the evolving needs of the population genomics community.

One of our goals is to engage research communities studying other taxa, so as to expand the resource to many more species. Although we have included demographic models and recombination maps, there are many biological processes that we do not model. Some of the additions that we are enthusiastic to add are: selection (including distributions of fitness effects, maps of functional elements, both single and recurrent hitchhiking events, and selection on polygenic traits), gene conversion, mutation models (rate heterogeneity), more realistic demography (overlapping generations, separate sexes, mortality/fecundity schedules), geographic population structure, and downstream aspects of data quality (genotyping and mapping error). Moreover, an in-depth investigation into the effects of population-size rescaling under many of the above scenarios is warranted, given our preliminary findings using neutral simulations (Appendix 1—figures 1 and 2). Some other important processes are more challenging to model with current simulation software, such as structural variation, changing recombination maps over time, transposable elements, and context-dependent mutation.

We wish to emphasize that although the included demographic histories are some of the most widely used models for our current set of species, we anticipate the set of available models to expand as new methods and new modeling frameworks are developed. For instance, the current models all describe a small set of discrete, randomly mating populations, which are likely good approximations for deep-time population history, but may be less useful for methods describing dynamics of contemporary populations. Stdpopsim’s framework is sufficiently general that more realistic population models will be easily incorporated, as they are published. Additional aspects of the framework, such as genome builds, will also continue to change as improvements are made to our understanding of genome structure.

Materials and methods

Model quality control

Request a detailed protocol

As a consortium we have agreed to a standardized procedure for model inclusion into stdpopsim that allows for rigorous quality control. Imagine Developer A wants to introduce a new model into stdpopsim. Developer A implements the demographic model for the relevant organism along with clear documentation of the model parameters and populations. This model is submitted as a ‘pull request’, where it is evaluated by a reviewer and then included as ‘preliminary’, but is not linked to the online documentation nor the command line interface. Developer A submits a quality control (QC) issue, after which a second developer, Developer B (perhaps found by requesting review from the broader Consortium), then independently reimplements the model from the relevant primary sources and adds an automatic unit test for equality between the QC implementation and the preliminary production model. If the two implementations are equivalent, the original model is included in stdpopsim. If not, we move to an arbitration process whereby A and B first try to work out the details of what went wrong. If that fails, the original authors of the published model must be contacted to resolve ambiguities. Further details of our QC process can be found in our developer documentation (https://stdpopsim.readthedocs.io/en/latest/development.html).

The possibility for error and the importance of careful qualty control was illustrated very clearly during our own development process: while carrying out the final revisions of this paper, we noticed that the OutOfAfrica_3G09 model (Gutenkunst et al., 2009) had not gone through our QC process. The subsequent QC revealed that our implementation was in fact slightly wrong—migration rates had not been set to zero to the European population in the most ancient time period when there should have only been a single population. This error was propagated from the msprime documentation, where the model was presented as an illustrative example. A number of studies have been published using copies of this erroneous example code.

Workflow for analysis of simulated data

Request a detailed protocol

To demonstrate the utility of stdpopsim we created Snakemake workflows (Köster and Rahmann, 2012) that perform demographic inference on tree sequence output from our package using a few common software packages (see Appendix 1—figure 10 for an example workflow). Our choice of Snakemake allows complete reproducibility of the analyses shown, and all code is available from https://github.com/popsim-consortium/analysis.

We performed two types of demographic inference. Our first task was to infer effective population size over time (denoted $N (t)$ ). This was done using three software packages: stairway plot, which uses site frequency spectrum information only (Liu and Fu, 2015); MSMC (Schiffels and Durbin, 2014), which is based on the sequentially Markovian coalescent (SMC), run with two different sample sizes ( $n = 2, 8$ ); and smc++ (Terhorst et al., 2017), which combines information from the site frequency spectrum with recombination information as in SMC-based methods. No attempt was made at trying to optimize the analysis from any particular software package, as our goal was not to benchmark performance of methods but instead show how such benchmarking could be easily done using the stdpopsim resource. In this spirit, we ran each software package as near to default parameters as possible. For stairway plot, we set the parameters numRuns = 1 and dimFactor = 5000. For smc++ we used the ‘estimate’ run mode to infer $N (t)$ with all other parameters set to their default values. For MSMC, we used the --fixedRecombination option and used the default number of iterations.

For the single-population task, we ran human (HomSap) simulations using a variety of models (see Table 1): OutOfAfricaArchaicAdmixture_5R19, OutOfAfrica_3G09, and a constant-sized generic model. Each simulation used the HapmapII_GRCh37 genetic map. For D. melanogaster we estimated $N (t)$ from an African sample simulated under the DroMel, African3Epoch_1S16 model using the Comeron2012_dm6 map. Finally, we ran simulations of A. thaliana genomes using the AraTha African2Epoch_1H18 model under the Salome2012_TAIR7 map. For each model, three replicate whole genomes were simulated and the population size estimated from those data. In all cases, we set the sample size of the focal population to $N = 50$ chromosomes.

Following simulation, low-recombination portions of chromosomes were masked from the analysis in a manner that reflects the ‘accessible’ subset of sites used in empirical population genomic studies (e.g. Danecek et al., 2011; Langley et al., 2012). Specifically we masked all regions of 1 cM or greater in the lowest 5th percentile of the empirical distribution of recombination, regions which are nearly uniformly absent for empirical analysis. This approach to masking was chosen to prevent marginal trees with low or no recombination from biasing the comparisons of demographic inference methods. It should be noted that masking is not implemented within stdpopsim proper; tree sequences generated by stdpopsim are always raw and unmasked. This allows users the flexibility to implement masking approaches that are specific to their needs for downstream analysis.

Our second task was to explore inference with two-population models using some of the multi-population demographic models implemented in stdpopsim. For HomSap, we used the OutOfAfrica_3G09 model with the HapmapII_GRCh37 genetic map, and for DroMel we used the OutOfAfrica_2L06 model with the Comeron2012_dm6 map. The HomSap model is a three population model (Africa, Europe, and Asia) including post-divergence migration and exponential growth (Figure 4C), whereas the DroMel model is a two population model (Africa and Europe) with no post-divergence migration and constant population sizes (Appendix 1—figure 8).

To conduct inference on these models, we applied three commonly used methods: $\partial a \partial i$ (Gutenkunst et al., 2009), fastsimcoal2 (Excoffier et al., 2013), and smc++ (Terhorst et al., 2017). As above, these methods were used generally with default settings and we did not attempt to optimize their performance or fit parameter-rich demographic models.

For both $\partial a \partial i$ and fastsimcoal2, we fit a two population isolation-with-migration (IM) model with constant population sizes. This IM model contains six parameters: the ancestral population size, the sizes of each population after the split, the divergence time, and two migration rate parameters. Importantly, this meant that for both species, the fitted model did not match the simulated model (Figure 4 and Appendix 1—figure 8). In the HomSap case, we therefore performed inference solely on the Africa and Europe populations, meaning that the Asia population functioned as a ‘ghost’ population that was ignored by our inference. To validate our inference approach, we also conducted inference on a generic IM model that was identical to the model used for inference (Appendix 1—figure 11).

From HomSap simulations, we took 20 whole genome samples each from the Europe and Africa populations from each replicate. Runtimes of DroMel simulations were prohibitively slow when simulating whole genomes with the Comeron2012_dm6 map due to large effective population sizes leading to high effective recombination rates. For this reason, we present only data from 50 samples of a 3 MB region of chromosome 2R from simulations under OutOfAfrica_2L06. For the generic IM simulations, we used the HomSap genome along with the HapmapII_GRCh37 genetic map and sampled 20 individuals from each population.

Following simulation, we output tree sequences and masked low-recombination regions using the same approach described for the single population workflow above. We converted tree sequences into a two-dimensional site frequency spectrum for all chromosomes in the appropriate format for $\partial a \partial i$ and fastsimcoal2. For each simulation replicate, we performed 10 runs of $\partial a \partial i$ and fastsimcoal2, checking to ensure that each method reached convergence.

Detailed settings for $\partial a \partial i$ and fastsimcoal2 can be found in the Snakefile on our git repository (https://github.com/popsim-consortium/analysis). Estimates from the highest log-likelihood (out of 10 runs) for each simulation replicate are shown in Figure 4C and Appendix 1—figure 8C.

For smc++, we converted the tree sequences into VCF format and performed inference with default settings. Importantly, smc++ assumes no migration post-divergence, deviating from the simulated model. However, because smc++ allows for continuous population size changes, it is better equipped to capture many of the more complex aspects of the simulated demographic models (e.g. exponential growth).

To visualize our results, we plotted the inferred population size trajectories for each simulation replicate alongside the simulated population sizes (Figure 4C and Appendix 1—figure 8C). Here, unlike the single-population workflow, we compare our inferred population sizes only to the simulated population sizes and not the inverse coalescence rates.

Resource availability

Request a detailed protocol

The stdpopsim package is available for download on the Python Package Index: https://pypi.org/project/stdpopsim/. Documentation for the project can be found here: https://stdpopsim.readthedocs.io/en/latest/.

Appendix 1

Calculating coalescence rates

In population genetics, the ‘effective population size’ of a population model with constant (census) size is often defined to be the number of diploids in a Wright-Fisher population that would have the same coalescence rate (or, equivalently, genetic drift) as the population in question (reviewed in Crow and Denniston, 1988). One reason the concept is useful is because theory predicts that genetic data from distinct populations with the same effective population size will look similar in many ways: for instance, their mean coalescence times will be the same. Conversely, this implies that effective population size should be easier to infer from genomic data than aspects of population demography that do not affect effective population size. An analogous observation holds for populations of changing size, if we define the ‘coalescence rate’ of a given demographic model at a particular point back in time to be the rate of coalescence of remaining lineages and define the ‘coalescence effective size’ at that time, denoted $N_{e} (t)$ , so that the coalescence rate at time $t$ in the past is $1 / (2 N_{e} (t))$ . With these definitions, any two models with the same effective population size trajectory ( $N_{e} (t)$ ) will have the same distribution of coalescence times. For this reason, we might guess that if we apply an inference method that assumes a Wright-Fisher population with changing size through time to a different population model, the inferred demographic history will match the ‘effective population size history’ defined in this way. These observations and the following calculations are standard in coalescent theory (see e.g. Wakeley, 2005), but they are provided here for completeness.

We compute the coalescence rate of a collection of samples in a given demographic model at a particular point back in time as the expected number of coalescences happening at that time per unit of time and per pair of as-yet-uncoalesced lineages. More concretely, let $p (t)$ denote the probability that the lineages of a randomly chosen pair of samples have not yet coalesced $t$ units of time ago, let $p (z, t)$ denote the probability that those lineages have not yet coalesced and are furthermore both in location $z$ , and let $N_{e} (z, t)$ be the (effective) diploid population size in location $z$ at the time, so that $1 / (2 N_{e} (z, t))$ is the rate of coalescence there. Then, we compute the mean coalescence rate as

r (t) = \frac{1}{p (t)} \sum_{z} \frac{p (z, t)}{2 N_{e} (z, t)} .

This follows because if we have $m$ diploid samples, and hence $(\begin{matrix} 2 m \\ 2 \end{matrix})$ lineages, the expected number of coalescences in location $z$ between times $t$ and $t + d t$ ago is

(\begin{matrix} 2 m \\ 2 \end{matrix}) p (z, t) \frac{d t}{2 N_{e} (z, t)},

and the expected number of pairs of uncoalesced lineages at that time is

(\begin{matrix} 2 m \\ 2 \end{matrix}) p (t) .

The expression for $r (t)$ is a ratio of these two quantities; to obtain it we need to compute $p (t)$ and $p (z, t)$ . This is relatively straightforward using the general theory of Markov chains (e.g,. Kemeny et al., 2012), and is implemented in msprime.

Note that since these quantities are per pair of lineages, this definition depends on the locations of the samples. The coalescence rate also has the intuitive interpretation that it is the average between-lineage coalescence rate, averaged over where uncoalesced lineages might be. Since the local coalescence rate is the inverse of the population size, $1 / r (t)$ (as shown for instance in Figure 2) is a weighted harmonic mean of the census sizes of the different populations present at that time. This is as expected: suppose that we have two populations, one big and one small, connected by migration. If all our samples are from the big population, the number of recent coalescences should be small, reflecting the large population size, while in the long run, the coalescence rate approaches an intermediate rate. On the other hand, more recent coalescences are expected if all samples are from the small population, A method that fits a single, time-varying population size to the data might be expected to find a population size trajectory to match these time-varying rates of coalescence.

We use the same computations to analytically compute mean coalescence times: since for any nonnegative random variable $T$ , the mean value is $𝔼 [T] = \int_{0}^{\infty} ℙ {T > t} d t$ , we can obtain the mean coalescence time as

\int_{0}^{\infty} p (t) 𝑑 t,

where $p (t)$ is defined above.

The coalescence rate trajectories can be computed from a model in msprime using the coalescence_rate_trajectory method of the Demography Debugger class, which can be obtained from a stdpopsim model using the model.get_demography_debugger() method.

Appendix 1—figure 1

Download asset Open asset

Validating the SLiM engine backend under a genetic map.

Here, we validate our integration of the SLiM (Haller et al., 2019; Haller and Messer, 2019) engine backend. We show quantile-quantile plots between SLiM and msprime engines for three population genetic summary statistics: r², Tajima’s $π$ , and Tajima’s D. Additionally, we show runtimes for generating each simulation replicate. Data were generated by simulating 100 replicates of human chromosome 22 under the AncientEurasia_9K19 model (Kamm et al., 2019) using the HapMapII_GRCh37 genetic map (Frazer et al., 2007). 12 samples were drawn from each population (excluding basal Eurasians). From top to bottom, we show results using three scaling factors for the population sizes: Q = 1, Q = 10, and Q = 50. Kolmogorov-Smirnov two-sample test statistics (D) and p-values are shown, testing the null hypothesis that the quantiles were drawn from the same continuous distribution.

Appendix 1—figure 2

Download asset Open asset

Validating the SLiM engine backend under uniform recombination.

Here, we validate our integration of the SLiM (Haller et al., 2019; Haller and Messer, 2019) engine backend. We show quantile-quantile plots between SLiM and msprime engines for three population genetic summary statistics: r², Tajima’s $π$ , and Tajima’s D. Additionally, we show runtimes for generating each simulation replicate. Data were generated by simulating 100 replicates of human chromosome 22 under the AncientEurasia_9K19 model (Kamm et al., 2019) using a uniform rate of recombination across the chromosome. 12 samples were drawn from each population (excluding basal Eurasians). From top to bottom, we show results using three scaling factors for the population sizes: Q = 1, Q = 10, and Q = 50. Kolmogorov-Smirnov two-sample test statistics (D) and p-values are shown, testing the null hypothesis that the quantiles were drawn from the same continuous distribution.

Appendix 1—figure 3

Download asset Open asset

Comparing simulated population sizes and inverse coalescence rates in humans.

Data are shown from human genomes under the OutOfAfricaArchaicAdmixture_5R19 model (Ragsdale and Gravel, 2019) and using the HapMapII_GRCh37 genetic map (Frazer et al., 2007). From left to right, we show sizes for each of the three populations in the model: YRI, CEU, and CHB. We plot the simulated sizes for each population in black, and in red we plot inverse coalescence rates as calculated from the demographic model used for simulation (see text). In this specific model, these two measures are near identical, but in other models with higher migration rates we expect to see a larger departure between the two.

Appendix 1—figure 4

Download asset Open asset

Comparing estimates of $N (t)$ in humans.

Estimates of population size over time ( $N (t)$ ) inferred using four different methods, smc++, stairway plot, and MSMC with $n = 2$ and $n = 8$ . Data were generated by simulating replicate human genomes under the OutOfAfrica_3G09 model (Gutenkunst et al., 2009) and using the HapMapII_GRCh37 genetic map (Frazer et al., 2007). From top to bottom, we show estimates for each of the three populations in the model: YRI, CEU, and CHB. In shades of blue, we show the estimated $N (t)$ trajectories for each replicate. As a proxy for the ‘truth’, in black we show inverse coalescence rates as calculated from the demographic model used for simulation (see text).

Appendix 1—figure 5

Download asset Open asset

Comparing estimates of $N (t)$ in humans.

Here, we show estimates of population size over time ( $N (t)$ ) inferred using fourdifferent methods, smc+, and stairway plot, and MSMC with $n = 2$ and $n = 8$ . Data were generated by simulating replicate human genomes under a constant sized population model with $N = 10^{4}$ and using the HapMapII_GRCh37 genetic map (Frazer et al., 2007). As a proxy for the ‘truth’, in black we show inverse coalescence rates as calculated from the demographic model used for simulation (see text).

Appendix 1—figure 6

Download asset Open asset

Comparing estimates of $N (t)$ in *A. thaliana*.

Here, we show estimates of population size over time ( $N (t)$ ) inferred using four different methods, smc++, and stairway plot, and MSMC with $n = 2$ and $n = 8$ . Data were generated by simulating replicate *A. thaliana* genomes under the African2Epoch_1H18 model (Durvasula et al., 2017) and using the SalomeAveraged_TAIR7 genetic map (Salomé et al., 2012). As a proxy for the ‘truth’, in black we show inverse coalescence rates as calculated from the demographic model used for simulation (see text).

Appendix 1—figure 7

Download asset Open asset

Migration rate estimates for the human Gutenkunst model.

Here, we show inferred migration rates from $\partial a \partial i$ and fastsimcoal2. Data were generated by simulating replicate human genomes under the Gutenkunst et al., 2009 model and using the genetic map inferred in Frazer et al., 2007. Directional migration from Europe to Africa is represented as $M I G_A F_E U$ and migration from Africa to Europe is represented as $M I G_E U_A F$ . Note that the $x$ -axis coordinates are arbitrary.

Appendix 1—figure 8

Download asset Open asset

Parameters estimated using a two-population *Drosophila* model.

Here, we show estimates of $N (t)$ inferred using $\partial a \partial i$ , fastsimcoal2, and smc++. Data were generated by simulating replicate *Drosophila* genomes under the Li and Stephan, 2006 model and using the genetic map inferred in Comeron et al., 2012. See legend of Figure 4 for details. In shades of blue, we show the estimated $N (t)$ trajectories for each replicate. In black we show the simulated population sizes.

Appendix 1—figure 9

Download asset Open asset

Migration rate parameters estimated under a two-population *Drosophila* model.

Here, we show inferred migration rates from $\partial a \partial i$ and fastsimcoal2. Data were generated by simulating replicate *Drosophila* genomes under the Li and Stephan, 2006 model and using the genetic map inferred in Comeron et al., 2012. Directional migration from Europe to Africa is represented as $M I G_A F_E U$ and migration from Africa to Europe is represented as $M I G_E U_A F$ . Note that the $x$ -axis coordinates are arbitrary.

Appendix 1—figure 10

Download asset Open asset

Workflow for our N(t) inference methods comparison.

Here, we show single replicate for two chromosomes, chr22 and chrX, simulated under the HomSap OutOfAfrica_3G09 demographic model, with a HapmapII_GRCh37 genetic map. Note that the data used as input by all inference methods smc++, MSMC, and stairway plot, come from the same set of simulations.

Appendix 1—figure 11

Download asset Open asset

Parameters estimated from a generic IM model Here we show estimates of $N (t)$ inferred using $\partial a \partial i$ , fastsimcoal2, and smc++.

Data were generated by simulating under a generic IM model with a human genome and Frazer et al., 2007 genetic map. In shades of blue we show the estimated $N (t)$ trajectories for each replicate. In black we show the simulated population sizes.

Data availability

All resources are available from https://github.com/popsim-consortium/stdpopsim (copy archived at https://github.com/elifesciences-publications/stdpopsim).

References

(2020) Predicting the landscape of recombination using deep learning
Molecular Biology and Evolution 37:1790–1808.
https://doi.org/10.1093/molbev/msaa038
- PubMed
- Google Scholar
(2012) OmegaPlus: a scalable tool for rapid detection of selective sweeps in whole-genome datasets
Bioinformatics 28:2274–2275.
https://doi.org/10.1093/bioinformatics/bts419
- PubMed
- Google Scholar
(2016) Harnessing the power of RADseq for ecological and evolutionary genomics
Nature Reviews Genetics 17:81–92.
https://doi.org/10.1038/nrg.2015.28
- PubMed
- Google Scholar
(2017) Comparison of single genome and allele frequency data reveals discordant demographic histories
G3: Genes, Genomes, Genetics 7:3605–3620.
https://doi.org/10.1534/g3.117.300259
- Google Scholar
(2018) Using genomic data to infer historic population dynamics of nonmodel organisms
Annual Review of Ecology, Evolution, and Systematics 49:433–456.
https://doi.org/10.1146/annurev-ecolsys-110617-062431
- Google Scholar
1. Boyko AR
2. Williamson SH
3. Indap AR
4. Degenhardt JD
5. Hernandez RD
6. Lohmueller KE
7. Adams MD
8. Schmidt S
9. Sninsky JJ
10. Sunyaev SR
11. White TJ
12. Nielsen R
13. Clark AG
14. Bustamante CD
(2008) Assessing the evolutionary impact of amino acid mutations in the human genome
PLOS Genetics 4:e1000083.
https://doi.org/10.1371/journal.pgen.1000083
- PubMed
- Google Scholar
(2018) Ancestry-specific recent effective population size in the americas
PLOS Genetics 14:e1007385.
https://doi.org/10.1371/journal.pgen.1007385
- PubMed
- Google Scholar
1. Campbell CL
2. Bhérer C
3. Morrow BE
4. Boyko AR
5. Auton A
(2016) A Pedigree-Based map of recombination in the domestic dog genome
G3: Genes, Genomes, Genetics 6:3517–3524.
https://doi.org/10.1534/g3.116.034678
- Google Scholar
(2012) Genome-wide fine-scale recombination rate variation in Drosophila melanogaster
PLOS Genetics 8:e1003090.
https://doi.org/10.1371/journal.pgen.1003090
- PubMed
- Google Scholar
(2012) The many landscapes of recombination in Drosophila melanogaster
PLOS Genetics 8:e1002905.
https://doi.org/10.1371/journal.pgen.1002905
- PubMed
- Google Scholar
1. Crow JF
2. Denniston C
(1988) Inbreeding and variance effective population numbers
Evolution 42:482–495.
https://doi.org/10.1111/j.1558-5646.1988.tb04154.x
- Google Scholar
(2011) The variant call format and VCFtools
Bioinformatics 27:2156–2158.
https://doi.org/10.1093/bioinformatics/btr330
- PubMed
- Google Scholar
(2016) SweepFinder2: increased sensitivity, robustness and flexibility
Bioinformatics 32:1895–1897.
https://doi.org/10.1093/bioinformatics/btw051
- PubMed
- Google Scholar
(2017) African genomes illuminate the early history and transition to selfing in Arabidopsis thaliana
PNAS 114:5213–5218.
https://doi.org/10.1073/pnas.1616736114
- PubMed
- Google Scholar
(2013) Robust demographic inference from genomic and SNP data
PLOS Genetics 9:e1003905.
https://doi.org/10.1371/journal.pgen.1003905
- PubMed
- Google Scholar
1. Eyre-Walker A
2. Keightley PD
(2009) Estimating the rate of adaptive molecular evolution in the presence of slightly deleterious mutations and population size change
Molecular Biology and Evolution 26:2097–2108.
https://doi.org/10.1093/molbev/msp119
- PubMed
- Google Scholar
Preprint
(2019) DFEnitely different: genome-wide characterization of differences in mutation fitness effects between populations
bioRxiv.
https://doi.org/10.1101/703918
- Google Scholar
1. Frazer KA
2. Ballinger DG
3. Cox DR
4. Hinds DA
5. Stuve LL
6. Gibbs RA
7. Belmont JW
8. Boudreau A
9. Hardenbol P
10. Leal SM
11. Pasternak S
12. Wheeler DA
13. Willis TD
14. Yu F
15. Yang H
16. Zeng C
17. Gao Y
18. Hu H
19. Hu W
20. Li C
21. Lin W
22. Liu S
23. Pan H
24. Tang X
25. Wang J
26. Wang W
27. Yu J
28. Zhang B
29. Zhang Q
30. Zhao H
31. Zhao H
32. Zhou J
33. Gabriel SB
34. Barry R
35. Blumenstiel B
36. Camargo A
37. Defelice M
38. Faggart M
39. Goyette M
40. Gupta S
41. Moore J
42. Nguyen H
43. Onofrio RC
44. Parkin M
45. Roy J
46. Stahl E
47. Winchester E
48. Ziaugra L
49. Altshuler D
50. Shen Y
51. Yao Z
52. Huang W
53. Chu X
54. He Y
55. Jin L
56. Liu Y
57. Shen Y
58. Sun W
59. Wang H
60. Wang Y
61. Wang Y
62. Xiong X
63. Xu L
64. Waye MM
65. Tsui SK
66. Xue H
67. Wong JT
68. Galver LM
69. Fan JB
70. Gunderson K
71. Murray SS
72. Oliphant AR
73. Chee MS
74. Montpetit A
75. Chagnon F
76. Ferretti V
77. Leboeuf M
78. Olivier JF
79. Phillips MS
80. Roumy S
81. Sallée C
82. Verner A
83. Hudson TJ
84. Kwok PY
85. Cai D
86. Koboldt DC
87. Miller RD
88. Pawlikowska L
89. Taillon-Miller P
90. Xiao M
91. Tsui LC
92. Mak W
93. Song YQ
94. Tam PK
95. Nakamura Y
96. Kawaguchi T
97. Kitamoto T
98. Morizono T
99. Nagashima A
100. Ohnishi Y
101. Sekine A
102. Tanaka T
103. Tsunoda T
104. Deloukas P
105. Bird CP
106. Delgado M
107. Dermitzakis ET
108. Gwilliam R
109. Hunt S
110. Morrison J
111. Powell D
112. Stranger BE
113. Whittaker P
114. Bentley DR
115. Daly MJ
116. de Bakker PI
117. Barrett J
118. Chretien YR
119. Maller J
120. McCarroll S
121. Patterson N
122. Pe'er I
123. Price A
124. Purcell S
125. Richter DJ
126. Sabeti P
127. Saxena R
128. Schaffner SF
129. Sham PC
130. Varilly P
131. Altshuler D
132. Stein LD
133. Krishnan L
134. Smith AV
135. Tello-Ruiz MK
136. Thorisson GA
137. Chakravarti A
138. Chen PE
139. Cutler DJ
140. Kashuk CS
141. Lin S
142. Abecasis GR
143. Guan W
144. Li Y
145. Munro HM
146. Qin ZS
147. Thomas DJ
148. McVean G
149. Auton A
150. Bottolo L
151. Cardin N
152. Eyheramendy S
153. Freeman C
154. Marchini J
155. Myers S
156. Spencer C
157. Stephens M
158. Donnelly P
159. Cardon LR
160. Clarke G
161. Evans DM
162. Morris AP
163. Weir BS
164. Tsunoda T
165. Mullikin JC
166. Sherry ST
167. Feolo M
168. Skol A
169. Zhang H
170. Zeng C
171. Zhao H
172. Matsuda I
173. Fukushima Y
174. Macer DR
175. Suda E
176. Rotimi CN
177. Adebamowo CA
178. Ajayi I
179. Aniagwu T
180. Marshall PA
181. Nkwodimmah C
182. Royal CD
183. Leppert MF
184. Dixon M
185. Peiffer A
186. Qiu R
187. Kent A
188. Kato K
189. Niikawa N
190. Adewole IF
191. Knoppers BM
192. Foster MW
193. Clayton EW
194. Watkin J
195. Gibbs RA
196. Belmont JW
197. Muzny D
198. Nazareth L
199. Sodergren E
200. Weinstock GM
201. Wheeler DA
202. Yakub I
203. Gabriel SB
204. Onofrio RC
205. Richter DJ
206. Ziaugra L
207. Birren BW
208. Daly MJ
209. Altshuler D
210. Wilson RK
211. Fulton LL
212. Rogers J
213. Burton J
214. Carter NP
215. Clee CM
216. Griffiths M
217. Jones MC
218. McLay K
219. Plumb RW
220. Ross MT
221. Sims SK
222. Willey DL
223. Chen Z
224. Han H
225. Kang L
226. Godbout M
227. Wallenburg JC
228. L'Archevêque P
229. Bellemare G
230. Saeki K
231. Wang H
232. An D
233. Fu H
234. Li Q
235. Wang Z
236. Wang R
237. Holden AL
238. Brooks LD
239. McEwen JE
240. Guyer MS
241. Wang VO
242. Peterson JL
243. Shi M
244. Spiegel J
245. Sung LM
246. Zacharia LF
247. Collins FS
248. Kennedy K
249. Jamieson R
250. Stewart J
251. International HapMap Consortium
(2007) A second generation human haplotype map of over 3.1 million SNPs
Nature 449:851–861.
https://doi.org/10.1038/nature06258
- PubMed
- Google Scholar
(2015) Recent selective sweeps in north american Drosophila melanogaster show signatures of soft sweeps
PLOS Genetics 11:e1005004.
https://doi.org/10.1371/journal.pgen.1005004
- PubMed
- Google Scholar
1. Gladstein AL
2. Hammer MF
(2019) Substructured population growth in the ashkenazi jews inferred with approximate bayesian computation
Molecular Biology and Evolution 36:1162–1171.
https://doi.org/10.1093/molbev/msz047
- PubMed
- Google Scholar
(2009) Inferring the joint demographic history of multiple populations from multidimensional SNP frequency data
PLOS Genetics 5:e1000695.
https://doi.org/10.1371/journal.pgen.1000695
- PubMed
- Google Scholar
(2019) Tree-sequence recording in SLiM opens new horizons for forward-time simulation of whole genomes
Molecular Ecology Resources 19:552–566.
https://doi.org/10.1111/1755-0998.12968
- PubMed
- Google Scholar
1. Haller BC
2. Messer PW
(2019) SLiM 3: forward genetic simulations beyond the Wright-Fisher model
Molecular Biology and Evolution 36:632–637.
https://doi.org/10.1093/molbev/msy228
- PubMed
- Google Scholar
1. Hey J
2. Nielsen R
(2004) Multilocus methods for estimating population sizes, migration rates and divergence time, with applications to the divergence of Drosophila pseudoobscura and D. persimilis
Genetics 167:747–760.
https://doi.org/10.1534/genetics.103.024182
- PubMed
- Google Scholar
1. Huang YF
2. Siepel A
(2019) Estimation of allele-specific fitness effects across human protein-coding sequences and implications for disease
Genome Research 29:1310–1321.
https://doi.org/10.1101/gr.245522.118
- PubMed
- Google Scholar
(2018) Gene expression drives the evolution of dominance
Nature Communications 9:7.
https://doi.org/10.1038/s41467-018-05281-7
- Google Scholar
1. Jacobs GS
2. Hudjashov G
3. Saag L
4. Kusuma P
5. Darusallam CC
6. Lawson DJ
7. Mondal M
8. Pagani L
9. Ricaut FX
10. Stoneking M
11. Metspalu M
12. Sudoyo H
13. Lansing JS
14. Cox MP
(2019) Multiple deeply divergent denisovan ancestries in papuans
Cell 177:1010–1021.
https://doi.org/10.1016/j.cell.2019.02.035
- PubMed
- Google Scholar
1. Kamm J
2. Terhorst J
3. Durbin R
4. Song YS
(2019) Efficiently inferring the demographic history of many populations with allele count data
Journal of the American Statistical Association 155:1–16.
https://doi.org/10.1080/01621459.2019.1635482
- Google Scholar
(2016) Efficient coalescent simulation and genealogical analysis for large sample sizes
PLOS Computational Biology 12:e1004842.
https://doi.org/10.1371/journal.pcbi.1004842
- PubMed
- Google Scholar
(2018) Efficient pedigree recording for fast population genetics simulation
PLOS Computational Biology 14:e1006581.
https://doi.org/10.1371/journal.pcbi.1006581
- PubMed
- Google Scholar
1. Kelleher J
2. Wong Y
3. Wohns AW
4. Fadil C
5. Albers PK
6. McVean G
(2019) Inferring whole-genome histories in large population datasets
Nature Genetics 51:1330–1338.
https://doi.org/10.1038/s41588-019-0483-y
- PubMed
- Google Scholar
Book
(2012) Denumerable Markov Chains
Springer Science & Business Media.
https://doi.org/10.1007/978-1-4684-9455-6
- Google Scholar
1. Kern AD
2. Schrider DR
(2018) diploS/HIC: an updated approach to classifying selective sweeps
G3: Genes, Genomes, Genetics 8:1959–1970.
https://doi.org/10.1534/g3.118.200262
- Google Scholar
(2017) Inference of the distribution of selection coefficients for new nonsynonymous mutations using large samples
Genetics 206:345–361.
https://doi.org/10.1534/genetics.116.197145
- PubMed
- Google Scholar
1. Kim Y
2. Stephan W
(2002)
Detecting a local signature of genetic hitchhiking along a recombining chromosome

Genetics 160:765–777.
- PubMed
- Google Scholar
(2010) Fine-scale recombination rate differences between sexes, populations and individuals
Nature 467:1099–1103.
https://doi.org/10.1038/nature09525
- PubMed
- Google Scholar
1. Köster J
2. Rahmann S
(2012) Snakemake--a scalable bioinformatics workflow engine
Bioinformatics 28:2520–2522.
https://doi.org/10.1093/bioinformatics/bts480
- PubMed
- Google Scholar
1. Langley CH
2. Stevens K
3. Cardeno C
4. Lee YC
5. Schrider DR
6. Pool JE
7. Langley SA
8. Suarez C
9. Corbett-Detig RB
10. Kolaczkowski B
11. Fang S
12. Nista PM
13. Holloway AK
14. Kern AD
15. Dewey CN
16. Song YS
17. Hahn MW
18. Begun DJ
(2012) Genomic variation in natural populations of Drosophila melanogaster
Genetics 192:533–598.
https://doi.org/10.1534/genetics.112.142018
- PubMed
- Google Scholar
1. Li H
2. Durbin R
(2011) Inference of human population history from individual whole-genome sequences
Nature 475:493–496.
https://doi.org/10.1038/nature10231
- PubMed
- Google Scholar
1. Li H
2. Stephan W
(2006) Inferring the demographic history and rate of adaptive substitution in Drosophila
PLOS Genetics 2:e166.
https://doi.org/10.1371/journal.pgen.0020166
- PubMed
- Google Scholar
1. Lin K
2. Futschik A
3. Li H
(2013) A fast estimate for the population recombination rate based on regression
Genetics 194:473–484.
https://doi.org/10.1534/genetics.113.150201
- PubMed
- Google Scholar
1. Liu X
2. Fu YX
(2015) Exploring population size changes using SNP frequency spectra
Nature Genetics 47:555–559.
https://doi.org/10.1038/ng.3254
- PubMed
- Google Scholar
1. Locke DP
2. Hillier LW
3. Warren WC
4. Worley KC
5. Nazareth LV
6. Muzny DM
7. Yang SP
8. Wang Z
9. Chinwalla AT
10. Minx P
11. Mitreva M
12. Cook L
13. Delehaunty KD
14. Fronick C
15. Schmidt H
16. Fulton LA
17. Fulton RS
18. Nelson JO
19. Magrini V
20. Pohl C
21. Graves TA
22. Markovic C
23. Cree A
24. Dinh HH
25. Hume J
26. Kovar CL
27. Fowler GR
28. Lunter G
29. Meader S
30. Heger A
31. Ponting CP
32. Marques-Bonet T
33. Alkan C
34. Chen L
35. Cheng Z
36. Kidd JM
37. Eichler EE
38. White S
39. Searle S
40. Vilella AJ
41. Chen Y
42. Flicek P
43. Ma J
44. Raney B
45. Suh B
46. Burhans R
47. Herrero J
48. Haussler D
49. Faria R
50. Fernando O
51. Darré F
52. Farré D
53. Gazave E
54. Oliva M
55. Navarro A
56. Roberto R
57. Capozzi O
58. Archidiacono N
59. Della Valle G
60. Purgato S
61. Rocchi M
62. Konkel MK
63. Walker JA
64. Ullmer B
65. Batzer MA
66. Smit AF
67. Hubley R
68. Casola C
69. Schrider DR
70. Hahn MW
71. Quesada V
72. Puente XS
73. Ordoñez GR
74. López-Otín C
75. Vinar T
76. Brejova B
77. Ratan A
78. Harris RS
79. Miller W
80. Kosiol C
81. Lawson HA
82. Taliwal V
83. Martins AL
84. Siepel A
85. Roychoudhury A
86. Ma X
87. Degenhardt J
88. Bustamante CD
89. Gutenkunst RN
90. Mailund T
91. Dutheil JY
92. Hobolth A
93. Schierup MH
94. Ryder OA
95. Yoshinaga Y
96. de Jong PJ
97. Weinstock GM
98. Rogers J
99. Mardis ER
100. Gibbs RA
101. Wilson RK
(2011) Comparative and demographic analysis of orang-utan genomes
Nature 469:529–533.
https://doi.org/10.1038/nature09687
- PubMed
- Google Scholar
1. McVean GA
2. Myers SR
3. Hunt S
4. Deloukas P
5. Bentley DR
6. Donnelly P
(2004) The fine-scale structure of recombination rate variation in the human genome
Science 304:581–584.
https://doi.org/10.1126/science.1092500
- PubMed
- Google Scholar
(1995) A large-scale experiment to assess protein structure prediction methods
Proteins: Structure, Function, and Genetics 23:303.
https://doi.org/10.1002/prot.340230303
- Google Scholar
1. Nater A
2. Mattle-Greminger MP
3. Nurcahyo A
4. Nowak MG
5. de Manuel M
6. Desai T
7. Groves C
8. Pybus M
9. Sonay TB
10. Roos C
11. Lameira AR
12. Wich SA
13. Askew J
14. Davila-Ross M
15. Fredriksson G
16. de Valles G
17. Casals F
18. Prado-Martinez J
19. Goossens B
20. Verschoor EJ
21. Warren KS
22. Singleton I
23. Marques DA
24. Pamungkas J
25. Perwitasari-Farajallah D
26. Rianti P
27. Tuuga A
28. Gut IG
29. Gut M
30. Orozco-terWengel P
31. van Schaik CP
32. Bertranpetit J
33. Anisimova M
34. Scally A
35. Marques-Bonet T
36. Meijaard E
37. Krützen M
(2017) Morphometric, behavioral, and genomic evidence for a new orangutan species
Current Biology 27:3487–3498.
https://doi.org/10.1016/j.cub.2017.09.047
- PubMed
- Google Scholar
1. Ragsdale AP
2. Gravel S
(2019) Models of archaic admixture and recent history from two-locus statistics
PLOS Genetics 15:e1008204.
https://doi.org/10.1371/journal.pgen.1008204
- PubMed
- Google Scholar
1. Russakovsky O
2. Deng J
3. Su H
4. Krause J
5. Satheesh S
6. Ma S
7. Huang Z
8. Karpathy A
9. Khosla A
10. Bernstein M
11. Berg AC
12. Fei-Fei L
(2015) ImageNet large scale visual recognition challenge
International Journal of Computer Vision 115:211–252.
https://doi.org/10.1007/s11263-015-0816-y
- Google Scholar
1. Salomé PA
2. Bomblies K
3. Fitz J
4. Laitinen RA
5. Warthmann N
6. Yant L
7. Weigel D
(2012) The recombination landscape in Arabidopsis thaliana F2 populations
Heredity 108:447–455.
https://doi.org/10.1038/hdy.2011.95
- PubMed
- Google Scholar
1. Schiffels S
2. Durbin R
(2014) Inferring human population size and separation history from multiple genome sequences
Nature Genetics 46:919–925.
https://doi.org/10.1038/ng.3015
- PubMed
- Google Scholar
1. Sheehan S
2. Song YS
(2016) Deep learning for population genetic inference
PLOS Computational Biology 12:e1004845.
https://doi.org/10.1371/journal.pcbi.1004845
- PubMed
- Google Scholar
(2018) Localization of adaptive variants in human genomes using averaged one-dependence estimation
Nature Communications 9:703.
https://doi.org/10.1038/s41467-018-03100-7
- PubMed
- Google Scholar
(2017) Inference of distribution of fitness effects and proportion of adaptive substitutions from polymorphism data
Genetics 207:1103–1119.
https://doi.org/10.1534/genetics.117.300323
- PubMed
- Google Scholar
1. Tennessen JA
2. Bigham AW
3. O'Connor TD
4. Fu W
5. Kenny EE
6. Gravel S
7. McGee S
8. Do R
9. Liu X
10. Jun G
11. Kang HM
12. Jordan D
13. Leal SM
14. Gabriel S
15. Rieder MJ
16. Abecasis G
17. Altshuler D
18. Nickerson DA
19. Boerwinkle E
20. Sunyaev S
21. Bustamante CD
22. Bamshad MJ
23. Akey JM
24. Broad GO, Seattle GO, NHLBI Exome Sequencing Project
(2012) Evolution and functional impact of rare coding variation from deep sequencing of human exomes
Science 337:64–69.
https://doi.org/10.1126/science.1219240
- PubMed
- Google Scholar
(2017) Robust and scalable inference of population history from hundreds of unphased whole genomes
Nature Genetics 49:303–309.
https://doi.org/10.1038/ng.3748
- PubMed
- Google Scholar
1. Uricchio LH
2. Hernandez RD
(2014) Robust forward simulations of recurrent hitchhiking
Genetics 197:221–236.
https://doi.org/10.1534/genetics.113.156935
- PubMed
- Google Scholar
(2019) Inference of recombination maps from a single pair of genomes and its application to ancient samples
PLOS Genetics 15:e1008449.
https://doi.org/10.1371/journal.pgen.1008449
- PubMed
- Google Scholar
Preprint
(2019) Haplotype-based inference of the distribution of fitness effects
bioRxiv.
https://doi.org/10.1101/770966
- Google Scholar
Report
1. Wakeley J
(2005) Coalescent Theory, an Introduction.
Roberts and Company.

http://www.coalescentheory.com/
- Google Scholar

Article and author information

Author details

Jeffrey R Adrion

Department of Biology and Institute of Ecology and Evolution, University of Oregon, Eugene, United States

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Christopher B Cole, Noah Dukler, Jared G Galloway, Ariella L Gladstein, Graham Gower, Christopher C Kyriazis, Aaron P Ragsdale and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0003-1021-6000
Christopher B Cole

Weatherall Institute of Molecular Medicine, University of Oxford, Oxford, United Kingdom

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Noah Dukler, Jared G Galloway, Ariella L Gladstein, Graham Gower, Christopher C Kyriazis, Aaron P Ragsdale and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-6733-633X
Noah Dukler

Simons Center for Quantitative Biology, Cold Spring Harbor Laboratory, Cold Spring Harbor, United States

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Christopher B Cole, Jared G Galloway, Ariella L Gladstein, Graham Gower, Christopher C Kyriazis, Aaron P Ragsdale and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-8739-8052
Jared G Galloway

Department of Biology and Institute of Ecology and Evolution, University of Oregon, Eugene, United States

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Christopher B Cole, Noah Dukler, Ariella L Gladstein, Graham Gower, Christopher C Kyriazis, Aaron P Ragsdale and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically
Ariella L Gladstein

Department of Genetics, University of North Carolina at Chapel Hill, Chapel Hill, United States

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Christopher B Cole, Noah Dukler, Jared G Galloway, Graham Gower, Christopher C Kyriazis, Aaron P Ragsdale and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0001-7735-2336
Graham Gower

Lundbeck GeoGenetics Centre, Globe Institute, University of Copenhagen, Copenhagen, Denmark

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Christopher B Cole, Noah Dukler, Jared G Galloway, Ariella L Gladstein, Christopher C Kyriazis, Aaron P Ragsdale and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-6197-3872
Christopher C Kyriazis

Department of Ecology and Evolutionary Biology, University of California, Los Angeles, Los Angeles, United States

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Christopher B Cole, Noah Dukler, Jared G Galloway, Ariella L Gladstein, Graham Gower, Aaron P Ragsdale and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-8771-3681
Aaron P Ragsdale

Department of Human Genetics, McGill University, Montreal, Canada

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Christopher B Cole, Noah Dukler, Jared G Galloway, Ariella L Gladstein, Graham Gower, Christopher C Kyriazis and Georgia Tsambos

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0003-0715-3432
Georgia Tsambos

Melbourne Integrative Genomics, School of Mathematics and Statistics, University of Melbourne, Melbourne, Australia

Contribution
Major contribution to stdpopsim, documentation or analysis

Contributed equally with
Jeffrey R Adrion, Christopher B Cole, Noah Dukler, Jared G Galloway, Ariella L Gladstein, Graham Gower, Christopher C Kyriazis and Aaron P Ragsdale

Competing interests
No competing interests declared

Additional information
Co-first authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0001-7001-2275
Franz Baumdicker

Department of Mathematical Stochastics, University of Freiburg, Freiburg, Germany

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared
Jedidiah Carlson

Department of Genome Sciences, University of Washington, Seattle, United States

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared
Reed A Cartwright

The Biodesign Institute and The School of Life Sciences, Arizona State University, Tempe, United States

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0002-0837-9380
Arun Durvasula

Department of Human Genetics, David Geffen School of Medicine, University of California, Los Angeles, Los Angeles, United States

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0003-0631-3238
Ilan Gronau

The Efi Arazi School of Computer Science, Herzliya Interdisciplinary Center, Herzliya, Israel

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0001-8536-4062
Bernard Y Kim

Department of Biology, Stanford University, Stanford, United States

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0002-5025-1292
Patrick McKenzie

Department of Ecology, Evolution, and Environmental Biology, Columbia University, New York, United States

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0002-8983-6060
Philipp W Messer

Department of Computational BiologyCornell University, Ithaca, United States

Contribution
Contribution to software/significant community contribution

Competing interests
Reviewing editor, eLife

"This ORCID iD identifies the author of this article:" 0000-0001-8453-9377
Ekaterina Noskova

Computer Technologies Laboratory, ITMO University, Saint Petersburg, Russian Federation

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0003-1168-0497
Diego Ortega-Del Vecchyo

International Laboratory for Human Genome Research, National Autonomous University of Mexico, Juriquilla, Mexico

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0003-4054-3766
Fernando Racimo

Lundbeck GeoGenetics Centre, Globe Institute, University of Copenhagen, Copenhagen, Denmark

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared

"This ORCID iD identifies the author of this article:" 0000-0002-5025-2607
Travis J Struck

Departmentof Molecular and Cellular Biology, University of Arizona, Tucson, United States

Contribution
Contribution to software/significant community contribution

Competing interests
No competing interests declared
Simon Gravel

Department of Human Genetics, McGill University, Montreal, Canada

Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Ryan N Gutenkunst, Kirk E Lohmueller, Peter L Ralph, Daniel R Schrider, Adam Siepel, Jerome Kelleher and Andrew D Kern

Competing interests
No competing interests declared

Additional information
Co-senior authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-9183-964X
Ryan N Gutenkunst

Departmentof Molecular and Cellular Biology, University of Arizona, Tucson, United States

Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Simon Gravel, Kirk E Lohmueller, Peter L Ralph, Daniel R Schrider, Adam Siepel, Jerome Kelleher and Andrew D Kern

Competing interests
No competing interests declared

Additional information
Co-senior authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-8659-0579
Kirk E Lohmueller
1. Department of Ecology and Evolutionary Biology, University of California, Los Angeles, Los Angeles, United States
2. Department of Human Genetics, David Geffen School of Medicine, University of California, Los Angeles, Los Angeles, United States
Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Simon Gravel, Ryan N Gutenkunst, Peter L Ralph, Daniel R Schrider, Adam Siepel, Jerome Kelleher and Andrew D Kern

Competing interests
No competing interests declared

Additional information
Co-senior authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-3874-369X
Peter L Ralph
1. Department of Biology and Institute of Ecology and Evolution, University of Oregon, Eugene, United States
2. Department of Mathematics, University of Oregon, Eugene, United States
Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Simon Gravel, Ryan N Gutenkunst, Kirk E Lohmueller, Daniel R Schrider, Adam Siepel, Jerome Kelleher and Andrew D Kern

Competing interests
No competing interests declared

Additional information
Co-senior authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-9459-6866
Daniel R Schrider

Department of Genetics, University of North Carolina at Chapel Hill, Chapel Hill, United States

Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Simon Gravel, Ryan N Gutenkunst, Kirk E Lohmueller, Peter L Ralph, Adam Siepel, Jerome Kelleher and Andrew D Kern

Competing interests
No competing interests declared

Additional information
Co-senior authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0001-5249-4151
Adam Siepel

Simons Center for Quantitative Biology, Cold Spring Harbor Laboratory, Cold Spring Harbor, United States

Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Simon Gravel, Ryan N Gutenkunst, Kirk E Lohmueller, Peter L Ralph, Daniel R Schrider, Jerome Kelleher and Andrew D Kern

Competing interests
No competing interests declared

Additional information
Co-senior authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-3557-7219
Jerome Kelleher

Big Data Institute, Li Ka Shing Centre for Health Information and Discovery, University of Oxford, Oxford, United Kingdom

Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Simon Gravel, Ryan N Gutenkunst, Kirk E Lohmueller, Peter L Ralph, Daniel R Schrider, Adam Siepel and Andrew D Kern

For correspondence
jerome.kelleher@bdi.ox.ac.uk

Competing interests
No competing interests declared

Additional information
Co-corresponding authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0002-7894-5253
Andrew D Kern

Department of Biology and Institute of Ecology and Evolution, University of Oregon, Eugene, United States

Contribution
Conceptualization, Methodology, Software, Validation, Formal Analysis, Resources, Data Curation, Writing - Original Draft Preparation, Writing - Review & Editing, Supervision, Project Administration

Contributed equally with
Simon Gravel, Ryan N Gutenkunst, Kirk E Lohmueller, Peter L Ralph, Daniel R Schrider, Adam Siepel and Jerome Kelleher

For correspondence
adkern@uoregon.edu

Competing interests
No competing interests declared

Additional information
Co-corresponding authors are listed alphabetically

"This ORCID iD identifies the author of this article:" 0000-0003-4381-4680

Funding

National Institute of General Medical Sciences (R35GM119856)

Christopher C Kyriazis
Kirk E Lohmueller

National Institute of General Medical Sciences (R01GM117241)

Jeffrey R Adrion
Andrew D Kern

National Institute of General Medical Sciences (R01GM127348)

Travis J Struck
Ryan N Gutenkunst

National Institute of General Medical Sciences (R00HG008696)

Ariella L Gladstein
Daniel R Schrider

National Institute of General Medical Sciences (R35GM127070)

Noah Dukler
Adam Siepel

National Human Genome Research Institute (R01HG010346)

Noah Dukler
Adam Siepel

Villum Fonden (00025300)

Graham Gower
Fernando Racimo

University of California Institute for Mexico and the United States (UC MEXUS-CONACYT Collaborative Grant)

Diego Ortega Del Vecchyo

Consejo Nacional de Ciencia y Tecnología (UC MEXUS-CONACYT Collaborative Grant)

Diego Ortega Del Vecchyo

Dirección General de Asuntos del Personal Académico, Universidad Nacional Autónoma de México (PAPIIT-IA200620)

Diego Ortega Del Vecchyo

Robertson Foundation

Jerome Kelleher

The funders had no role in study design, data collection and interpretation, or the decision to submit the work for publication.

Acknowledgements

We thank the Probabilistic Modeling in Genomics conference organizers for making this collaboration possible, and the Simons Center for Quantitative Biology at Cold Spring Harbor Laboratory for sponsoring the first workshop. Early on in the project we were encouraged by many people including Patrick Phillips, Richard Durbin, Dmitri Petrov, and Sohini Ramachandran. In addition, we thank NESCENT and Matt Hahn, Victoria Sork, and Michael Whitlock for organizing a 2014 catalysis meeting in which many of the goals of this effort were first laid out. CCK and KEL were funded under NIH Award R35GM119856. JRA and ADK were funded under NIH Award R01GM117241. TJS and RNG were funded under NIH Award R01GM127348. ALG and DRS were funded under NIH award R00HG008696. ND and AS were supported in part by NIH Awards R01HG010346 and R35GM127070. FR and GG were supported by a Villum Young Investigator award (project no. 00025300). DODV is funded by a UC MEXUS-CONACYT Collaborative Grant and a DGAPA-PAPIIT grant (PAPIIT-IA200620). JK is supported by the Robertson Foundation.

Version history

Received: January 7, 2020
Accepted: June 15, 2020
Accepted Manuscript published: June 23, 2020 (version 1)
Accepted Manuscript updated: June 25, 2020 (version 2)
Version of Record published: August 19, 2020 (version 3)

Copyright

This article is distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use and redistribution provided that the original author and source are credited.

Metrics

6,007

Page views
615

Downloads
78

Citations

Article citation count generated by polling the highest count across the following sources: PubMed Central, Scopus, Crossref.

Download links

A two-part list of links to download the article, or parts of the article, in various formats.

Downloads (link to download the article as PDF)

Article PDF

Open citations (links to open the citations from this article in various online reference manager services)

Mendeley

Cite this article (links to download the citations from this article in formats compatible with various reference manager tools)

Jeffrey R Adrion
Christopher B Cole
Noah Dukler
Jared G Galloway
Ariella L Gladstein
Graham Gower
Christopher C Kyriazis
Aaron P Ragsdale
Georgia Tsambos
Franz Baumdicker
Jedidiah Carlson
Reed A Cartwright
Arun Durvasula
Ilan Gronau
Bernard Y Kim
Patrick McKenzie
Philipp W Messer
Ekaterina Noskova
Diego Ortega-Del Vecchyo
Fernando Racimo
Travis J Struck
Simon Gravel
Ryan N Gutenkunst
Kirk E Lohmueller
Peter L Ralph
Daniel R Schrider
Adam Siepel
Jerome Kelleher
Andrew D Kern

(2020)

A community-maintained standard library of population genetic models

eLife 9:e54967.

https://doi.org/10.7554/eLife.54967

Categories and tags

Research organism

Human

Share this article

Cite this article

Structure of stdpopsim.

Initial set of demographic models in the catalog and summary of computing resources needed for simulation.

Comparing estimates of N⁢(t) in humans.

Comparing estimates of N⁢(t) in Drosophila.

Parameters estimated using a multi-population human model.

Validating the SLiM engine backend under a genetic map.

Validating the SLiM engine backend under uniform recombination.

Comparing simulated population sizes and inverse coalescence rates in humans.

Comparing estimates of N⁢(t) in humans.

Comparing estimates of N⁢(t) in humans.

Comparing estimates of N⁢(t) in A. thaliana.

Migration rate estimates for the human Gutenkunst model.

Parameters estimated using a two-population Drosophila model.

Migration rate parameters estimated under a two-population Drosophila model.

Workflow for our N(t) inference methods comparison.

Parameters estimated from a generic IM model Here we show estimates of N⁢(t) inferred using ∂⁡a⁢∂⁡i, fastsimcoal2, and smc++.

Author details

Jeffrey R Adrion

Contribution

Contributed equally with

Competing interests

Additional information

Christopher B Cole

Contribution

Contributed equally with

Competing interests

Additional information

Noah Dukler

Contribution

Contributed equally with

Competing interests

Additional information

Jared G Galloway

Contribution

Contributed equally with

Competing interests

Additional information

Ariella L Gladstein

Contribution

Contributed equally with

Competing interests

Additional information

Graham Gower

Contribution

Contributed equally with

Competing interests

Additional information

Christopher C Kyriazis

Contribution

Contributed equally with

Competing interests

Additional information

Aaron P Ragsdale

Contribution

Contributed equally with

Competing interests

Additional information

Georgia Tsambos

Contribution

Contributed equally with

Competing interests

Additional information

Franz Baumdicker

Contribution

Competing interests

Jedidiah Carlson

Contribution

Competing interests

Reed A Cartwright

Contribution

Competing interests

Arun Durvasula

Contribution

Competing interests

Ilan Gronau

Contribution

Competing interests

Bernard Y Kim

Comparing estimates of $N (t)$ in humans.

Comparing estimates of $N (t)$ in Drosophila.

Comparing estimates of $N (t)$ in humans.

Comparing estimates of $N (t)$ in humans.

Comparing estimates of $N (t)$ in A. thaliana.

Parameters estimated from a generic IM model Here we show estimates of $N (t)$ inferred using $\partial a \partial i$ , fastsimcoal2, and smc++.