About tspop

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

This is typically reported as global and local ancestry:

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.

Note

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.