Flee is an agent-based modelling toolkit which is purpose-built for simulating the movement of individuals across geographical locations. Flee is currently used primarily for modelling the movements of refugees and internally displaces persons (IDPs).
Flee is currently closed-source, but will be released periodically under a BSD 3-clause license once the first journal paper is accepted.
file name | what it does |
---|---|
flee/flee.py | Main ABM kernel |
flee/SimulationSettings.py | Data structure for global sim parameters. |
analysis.py | Library with statistical analysis routines. |
DataTable.py | Data Handling kernel for csv data. |
Flee consists of a range of testing scripts. These include, but are not limited to:
script name | what it does |
---|---|
test_datatable.py | Test data loading from CSV |
test_removelink.py | Test link removal |
test_retrofit.py | Test time retrofitting functionality |
test_toy_escape.py | Test toy escape scenario |
test_close_location.py | Test closing and opening of locations |
All tests can be run with Python 3, no arguments need to be specified.
script name | what it does |
---|---|
maliv2.py | Mali simulation |
burundi.py | Burundi simulation |
car.py | CAR simulation |
ssudan-csv.py | South Sudan simulation |
iraq-idp.py | Iraq simulation (IDPs only) |
rm test-output/* python3 test_csv.py > test-output/out.csv python3 plot-flee-output.py test-output
rm test-output/* python3 car-csv.py SimSettings/default.csv > test-output/out.csv python3 plot-flee-output.py test-output
mpirun -np test_par.py