Documentation Build Status DOI
stable docs build tests JuliaNightly DOI
dev docs codecov

Package for running dynamic ecosystem simulations


EcoSISTEM (Ecosystem Simulation through Integrated Species-Trait Environment Modelling) is a Julia package that provides functionality for simulating species undergoing dynamic biological processes such as birth, death, competition and dispersal, as well as environmental changes in climate and habitat.

The package was primarily developed for global scale simulations of plant biodiversity. The underlying model for this is described in the arXiv paper arXiv:1911.12257 (q-bio.QM), Dynamic virtual ecosystems as a tool for detecting large-scale responses of biodiversity to environmental and land-use change.

There are substantial changes to the package introduced through the dev branch (docs), including epidemiological simulations and refactoring of the code base for further flexibility.

This package is in beta now, so please raise an issue if you find any problems. For more information on how to contribute, please read our contributing guidelines. We are supported by NERC's Landscape Decisions small and large maths grants and an EPSRC studentship.

Introduction to EcoSISTEM

You can now run through a full introduction to EcoSISTEM with Pluto.jl if you have the source of the package cloned. To get started (if you are in the root of the package):

(EcoSISTEM) pkg> activate --temp
  Activating new project at `/var/folders/fv/1rqrvwq14ssggm_gc_x4v1cw0000gq/T/jl_IFxVXO`

(jl_IFxVXO) pkg> dev .
   Resolving package versions...
    Updating `/private/var/folders/fv/1rqrvwq14ssggm_gc_x4v1cw0000gq/T/jl_IFxVXO/Project.toml`
  [ed2dc23b] + EcoSISTEM
    Updating `/private/var/folders/fv/1rqrvwq14ssggm_gc_x4v1cw0000gq/T/jl_IFxVXO/Manifest.toml`

(jl_IFxVXO) pkg> add Pluto
   Resolving package versions...
    Updating `/private/var/folders/fv/1rqrvwq14ssggm_gc_x4v1cw0000gq/T/jl_IFxVXO/Project.toml`
  [c3e4b0f8] + Pluto
  No Changes to `/private/var/folders/fv/1rqrvwq14ssggm_gc_x4v1cw0000gq/T/jl_IFxVXO/Manifest.toml`

julia> import Pluto

 Opening http://localhost:1235/?secret=xxxxxxxx in your default browser... ~ have fun!
 Press Ctrl+C in this terminal to stop Pluto

This should open a Pluto window in your browser - from there you can find notebooks/Introduction.jl in the Open a notebook box. You can also test notebooks/InteractiveAfrica.jl to see an invasive species colonising Africa. Note that it may be slow on first launch as it must install packages and in the latter case download climate data from the internet. If you are using a different Julia version you may need to add a block at the start of the examples to update the manifest:

    using Pkg