About tspop

Suppose your genealogical ancestors can be partitioned into distinct populations (represented here by different colours):

alternate text

This is typically reported as global and local ancestry:

alternate text

Using msprime and SLiM, you can simulate under detailed models of migration and population structure. This is the documentation for tspop, a lightweight package that makes it easier for you to extract information about population-based ancestry from these simulations.


Add link to preprint/note when it’s written.

Under the hood, tspop relies on

  • the tskit package to efficiently extract the population-based information in the simulated datasets.

  • the pandas package to provide user-friendly, interpretable output.

First steps

  • Head to the Installation page to install tspop on your computer.

  • Population-based ancestry is not well-defined without some notion of a census time. Read Simulation setup to see how to design your simulations to ensure they will work with tspop.

  • Flick through the Examples to see tspop in action.

  • Check out The ideas behind tspop to learn more about why tspop is so efficient.