Skip to content

Numerical model for life history evolution of age-structured populations

License

Notifications You must be signed in to change notification settings

valenzano-lab/aegis

Repository files navigation

PyPI version Python 3.6+

AEGIS

Aging of Evolving Genomes In Silico (AY-jis, /eɪd͡ʒɪs/)

Numerical model for life history evolution of age-structured populations under customizable ecological scenarios.

How to use

You can run AEGIS simulations on a webserver or locally. The webserver is especially useful if you want to try AEGIS out and run a couple of simple simulations. For more demanding simulations, it is best to install and run AEGIS on your local machine.

Webserver use

You can access the AEGIS webserver here. The server is running AEGIS GUI.

Local use

You can install AEGIS locally using pip (pip install aegis-sim). The package is available on https://pypi.org/project/aegis-sim/. You can use AEGIS with a GUI or in a terminal. GUI is useful for running individual simulations, while the terminal is useful for running batches of simulations.

python3 -m aegis # starts GUI
python3 -m aegis -c {path/to/config_file} # runs a simulation within a terminal
python3 -m aegis --help # shows help documentation

To run simulations within a terminal, you need to prepare config files in YAML format which contain custom values for simulation parameters. The list of parameters, including their descriptions and default values you can find here. An example of a config file:

RANDOM_SEED: 42
STEPS_PER_SIMULATION: 10000
AGE_LIMIT: 50

Developer installation

If you want to contribute to the codebase, install AEGIS from github:

git clone [email protected]:valenzano-lab/aegis.git
cd aegis
make install_dev

Documentation

Model description

Most documentation about the model is available within the GUI itself, including description of submodels, configuration parameters, output specification, and genetic architecture. Use the webserver or a local installation to access the GUI. Further information is available in scientific articles:

API reference

Exhaustive, searchable API reference made by pdoc is available here.

Contributors

  • Martin Bagić (v2): email, github
  • Dario Valenzano (v1, v2): github
  • Erik Boelen Theile (v2)
  • Arian Šajina (v1): github
  • William Bradshaw (v1): github