Skip to main content

A tool for easy-to-use demographic inference

Project description

GADMA

Docs Build status codecov PyPI - Downloads

Welcome to GADMA v2!

GADMA implements methods for automatic inference of the joint demographic history of multiple populations from the genetic data.

GADMA is a command-line tool. Basic pipeline presents a series of launches of the global search algorithm followed by the local search optimization.

GADMA provides two types of demographic inference: 1) for user-specified model of demographic history or a custom model, 2) automatic inference for the model with specified structure (up to three populations, see more here).

GADMA provides choice of several engines of demographic inference. This list will be extended in the future. Available engines and maximum number of supported populations for custom model:

  • ∂a∂i (up to 5 populations)
  • moments (up to 5 populations)
  • momi2 (up to ∞ populations)
  • momentsLD - extenstion of moments (up to 5 populations)

More information about engines see here.

GADMA features various optimization methods (global and local search algorithms) which may be used for any general optimization problem.

Two global search algorithms are supported in GADMA:

  • Genetic algorithm — the most common choice of optimization,
  • Bayesian optimization — for demographic inference with time-consuming evaluations, e.g. for four and five populations using moments or ∂a∂i.

GADMA is developed in Computer Technologies laboratory at ITMO University under the supervision of Vladimir Ulyantsev and Pavel Dobrynin. The principal maintainer is Ekaterina Noskova (ekaterina.e.noskova@gmail.com)

GADMA is now of version 2! See Changelog.

Documentation

Please see documentation for more information including installation instructions, usage, examples and API.

Getting help

F.A.Q.

Please don't be afraid to contact me for different problems and offers via email ekaterina.e.noskova@gmail.com. I will be glad to answer all questions.

Also you are always welcome to create an issue on the GitHub page of GADMA with your question.

Citations

Please see full list of citations in documentation.

If you use GADMA in your research please cite:

Ekaterina Noskova, Vladimir Ulyantsev, Klaus-Peter Koepfli, Stephen J O’Brien, Pavel Dobrynin, GADMA: Genetic algorithm for inferring demographic history of multiple populations from allele frequency spectrum data, GigaScience, Volume 9, Issue 3, March 2020, giaa005, https://doi.org/10.1093/gigascience/giaa005

If you use GADMA2 in your research please cite:

Ekaterina Noskova, Nikita Abramov, Stanislav Iliutkin, Anton Sidorin, Pavel Dobrynin, and Vladimir Ulyantsev, GADMA2: more efficient and flexible demographic inference from genetic data, GigaScience, Volume 12, August 2023, giad059, https://doi.org/10.1093/gigascience/giad059

If you use Bayesian optimization please cite:

Ekaterina Noskova and Viacheslav Borovitskiy, Bayesian optimization for demographic inference, G3 Genes|Genomes|Genetics, Volume 13, Issue 7, July 2023, jkad080, https://doi.org/10.1093/g3journal/jkad080

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gadma-2.0.3.tar.gz (65.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gadma-2.0.3-py3-none-any.whl (214.5 kB view details)

Uploaded Python 3

File details

Details for the file gadma-2.0.3.tar.gz.

File metadata

  • Download URL: gadma-2.0.3.tar.gz
  • Upload date:
  • Size: 65.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for gadma-2.0.3.tar.gz
Algorithm Hash digest
SHA256 1ed8a4a03d43954497a93fdaa5e216e30cc9cbb9f62a41c8643bf688e3d104aa
MD5 c4378ca6464fb7d3a82fc8fa195dc1d5
BLAKE2b-256 8e5f2b3e34f2893a481c016dd5ec410c8f71c391c8fd6100c865729fa2c5b6a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for gadma-2.0.3.tar.gz:

Publisher: publication_to_pypi.yml on ctlab/GADMA

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file gadma-2.0.3-py3-none-any.whl.

File metadata

  • Download URL: gadma-2.0.3-py3-none-any.whl
  • Upload date:
  • Size: 214.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for gadma-2.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4a3a9392f80b6e5cfeee4bd0e5bfc0d0309da3fcd98328044e7991035ba64798
MD5 11ec64adefd4352a42871cae0054d29a
BLAKE2b-256 4abe0b7a1c4b53d2c41ec3958f42b773607910a37685c62d0e39d206e95fa43c

See more details on using hashes here.

Provenance

The following attestation bundles were made for gadma-2.0.3-py3-none-any.whl:

Publisher: publication_to_pypi.yml on ctlab/GADMA

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page