A library to do ambulance dispatch simulation and analysis.
There are many ways to get the simulator to work. See The Installation Instructions.
python3 run-simulation --help
Among other things, you will see this:
usage: run-simulation [-h] config_file
The program expects you to configure the specifications of the simulation and state where those specifications are.
The configuration file is in YAML format, and it contains user specifications for how the simulation runs. For specification details, an upcoming paper will detail that. For now, take a look
at configurations/example.yaml
.
pwd
should return your directory and /Algorithms/
. For example, here's mine:
/Users/vectflux/ReEMS/Algorithms
python3 run-simulation configurations/example.yaml
If you got an error like results does not exist
, make a new subdirectory:
mkdir results
Don't worry about accidentally pushing your own results. This folder is in the .gitignore
file.
./results/
ls ./results/
python3 run-simulation configurations/simple.yaml
That's because this particular configuration uses certain historical data files that do not exist yet.
You will need to run one of our scripts to produce some synthetic input data. These inputs are examples of well-formatted CSV files that EMS organizations can export their historical data to. Alternatively, another data reader can be implemented that accepts data in a different way.
[Insert command for script here.]
python3 run-simulation configurations/simple.yaml
./results/
under a different name.ls ./results/
To run a custom simulation, create a new YAML file or copy an existing one.
Specify the requirements for the simulation (look to the other YAMLs for an example). Additional extensions for the framework can also be specified here.
python run.py simple.yaml
Demo notebooks can be run online on binder.
Just click on the binder logo: