Welcome to GADMA’s documentation!
GADMA [Noskova2020] [Noskova2023GADMA2] implements methods for automatic inference of the joint demographic history of multiple populations from genetic data.
GADMA is a command-line tool. It presents a series of launches of the global and local search algorithms and infers demographic history of multiple populations. The automatic inference handles up to three populations.
GADMA provides choice of several engines for the demographic inference:
dadi developed by Ryan Gutenkunst [Gutenkunst2009]
moments developed by Simon Gravel [Jouganous2017]
momentsLD extension of
moments
for LD stats [Ragsdale2019] [Ragsdale2020]
GADMA implements two base global search algorithms:
Genetic algorithm — the most common choice of optimization,
Bayesian optimization [Noskova2023BO] — for demographic inference with time-consuming evaluations, e.g. for four and five populations using moments or ∂a∂i.
GADMA features variuos optimization methods (global and local search algorithms) which may be used for any general optimization problem.
Base usage of GADMA via command-line:
$ gadma --help
GADMA version 2.0.0 by Ekaterina Noskova (ekaterina.e.noskova@gmail.com)
Usage:
gadma -p/--params <params_file>
-e/--extra <extra_params_file>
Instead/With -p/--params and -e/--extra option you can set:
-o/--output <output_dir> output directory.
-i/--input <in.fs>/<in.txt>/ input data for demographic inference
<in.vcf>,<popmap> (AFS or dadi format or VCF).
--resume <resume_dir> resume another launch from <resume_dir>.
--only_models flag to take models only from another
launch (--resume option).
-h/--help show this help message and exit.
-v/--version show version and exit.
--test run test case.
In case of any questions or problems, please contact: ekaterina.e.noskova@gmail.com
What is parameter file of GADMA?
A parameter file is a simple text file (created in a text editor, such as Notepad), which contains a list of parameters/options/settings with their assigned values. Create a parameter file that reflects your particular options. Hereinafter, as an example, the name of your parameter file will be defined as param_file
.
Note
Each section of user manual contain list of related options for parameter file with small description.
Full example of parameter file could be found in a section Example parameters file.
Getting started
User manual
Development documentation
- Changelogs
- [2.0.2] - 2023-11-06
- [2.0.0] - 2023-09-23
- [2.0.0rc26] - 2023-06-29
- [2.0.0rc25] - 2023-04-24
- [2.0.0rc24] - 2023-04-21
- [2.0.0rc23] - 2022-12-01
- [2.0.0rc22] - 2022-09-10
- [2.0.0rc21] - 2022-06-09
- [2.0.0rc20] - 2022-05-01
- [2.0.0rc19] - 2022-03-18
- [2.0.0rc18] - 2021-09-03
- [2.0.0rc16] - 2021-06-27
- [2.0.0rc15] - 2021-06-13
- [2.0.0rc13] - 2021-05-21
- [2.0.0rc9] - 2021-01-27
- Development workflow
- API
- API examples