asdm 0.0.3

Agile System Dynamics Engine

ASDM

Agile System Dynamics Modelling

This project is a Python-based tool that could be used for building, simulating, calibrating, and carrying out analyses of System Dynamics (SD) models.

How to use

Python version

The library is tested under Python 3.9.0 on Ubuntu Linux and Windows. It is supposed to work also on higher versions of Python. If you encounter problems using it please open an issue.

OS

It has been noticed that on macOS, the multi-thread sampling of PyMC3 does not work well. This is due to the fact that macOS handles multiprocess in a different way. The impact is that we can only use one thread to do multi-chain MCMC sampling which is much slower.

Although the rest of the functionalities of ASDM still work on macOS, we recommend that you switch to Linux for the optimal parameter estimation experience.

Dependencies

We recommend that you use pip to install asdm but if you do wish to develop it further pipenv instructions are provided.

Tutorial Notebooks

We use a series of Jupyter Notebooks to provide functionality guidance for the users.

1. SD Modelling

• Creating an SD model from scratch
  • Adding stocks, flows, auxiliaries
  • Support for nonlinear functions (MIN, MAX, etc.)
  • Support for stochastic functions (random binomial trial, etc.)
• Running simulations
• Exporting and examing simulation outcomes
• Displaying simulation outcomes as graph

Why ASDM?

Acknowledging that there are a number of SD tools that enable simulating SD models in a Python environment (see PySD and venpy), we build ASDM to bring the capability of structure modelling to the Python SD community. ASDM allows users to create an SD model from scratch and edit model structure as needed. With a native Python implementation of stock-and-flow structure, ASDM allows building SD models without software like Vensim and Stella.

The long-term goal ASDM intends to achieve is an approach for data-informed structure modelling where data can be used to finetune SD model structure automatically. This is both an extension of data-informed SD model parameter estimation, and an innovative way to discover feedback structures from data.

Limitations

The main drawback at the moment is that we have not been working a lot on translating Vensim/Stella models into the format that ASDM uses, although PySD has proved this fully doable. This functionality is in our development roadmap.

We have neither been working a lot on the speed of simulation. Although simulating large SD models given mordern computer specs would not be extremely time-consuming, in tasks involing Monte Carlo simulation (such as parameter estimation) the speed of running a model can matter a lot more. Acceleration is in our development roadmap too.

Docs

Full docs are incoming

Licence

ASDM is made public under the MIT licence.

Authors

Wang Zhao
PhD candidate at University of Strathclyde, UK
[e-mail]

Matt Stammers
MD candidate at University of Southampton, UK
[e-mail]