This repository contains ASMC and an extension, FastSMC, together with python bindings for both.
The following pages of documentation contains specific information:
ASMC and FastSMC are regularly built and tested on Ubuntu and macOS. They consist of a C++ library, C++ executables, and optional Python bindings.
The C++ libraries and executables require:
We recommend installing dependencies using vcpkg, distributed with this repository as a submodule. Information below.
Building the optional Python bindings additionally requires:
Decoding quantities files are required in order to run ASMC and FastSMC. These can be generated directly from a Python module, and instructions can be found here. Input and output file formats for the tool used to create decoding quantities are described here.
Note: the CEU.demo demographic model and the decoding quantities for CEU+UKBB previously provided in this repository and this repository were mistakenly encoded as diploid rather than haploid. The file CEU.demo and CEU+UKBB decoding quantities here have now been fixed. They were generated using v2.2.1 of the PrepareDecoding tool, which also provides a simpler interface for computing decoding quantities as well as support for additional demographic models. Using these new decoding quantities with v1.2 of ASMC will tend to produce more recent estimates for TMRCAs compared to the decoding quantities distributed with v1.0 and v1.1. This should not have a substantial impact on most downstream analyses.
vX.Y
ASMC and FastSMC are distributed under the GNU General Public License v3.0 (GPLv3). For any questions or comments on ASMC, please contact Pier Palamara using <lastname>@stats.ox.ac.uk
.
If you use this software, please cite the appropriate reference(s) below.
The ASMC algorithm and software were developed in
The FastSMC algorithm and software were developed in