Spatial Discrete Event Simulation (SpaDES)

Build Status Appveyor Build status Coverage Status CRAN_Status_Badge Downloads DOI

Develop and run spatially explicit discrete event simulation models

Metapackage for implementing a variety of event-based models, with a focus on spatially explicit models. These include raster-based, event-based, and agent-based models. The core simulation components (provided by SpaDES.core) are built upon a discrete event simulation (DES) framework that facilitates modularity, and easily enables the user to include additional functionality by running user-built simulation modules (see also Included are numerous tools to visualize rasters and other maps (via quickPlot), and caching methods for reproducible simulations (via reproducible). Additional functionality is provided by the SpaDES.addins and SpaDES.shiny packages.

Getting started



SpaDES metapackage:

Other SpaDES ecosystem packages:

Predictive Ecology Blog:

Canadian Forest Service Adaptation Toolkit:

LandWeb Demonstration App:

Examples for R-savvy users:

Copy the linked .Rmd file to your computer. Open it with a text editor or in RStudio, and run all chunks in R. It is not intended to be knitted; knitting will only output the script.


Install development libraries: building packages from source requires the appropriate development libraries for your operating system.

See here for more details.

Install suggested packages: the fastshp package can be installed with:

install.packages("fastshp", repos = "", type = "source")

Current stable release

Install from CRAN:


Install from GitHub:

install_github("PredictiveEcology/SpaDES", dependencies = TRUE) # stable

Development version (unstable)

Install from GitHub:

install_github("PredictiveEcology/SpaDES", ref = "development", dependencies = TRUE) # unstable

Getting help

Q&A forum is available on the SpaDES Users Google Group. This is the place to ask for help on setting up and running simulations, as well as module development. Please do not file bug reports here.

Reporting bugs

The SpaDES metapackage simply loads a number of other packages from the SpaDES ecosystem. Bug reports should be reported to the specific package in question rather than the metapackage, and should contain a concise reproducible example. Contact us via the package’s GitHub site:

Copyright (C) 2019 Her Majesty the Queen in Right of Canada, as represented by the Minister of Natural Resources Canada