Skip to main content

Flee is an agent-based modelling toolkit which is purpose-built for simulating the movement of individuals across geographical locations.

Project description

Flee

Build Status GitHub Issues GitHub last-commit

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 forcibly displaced persons (FDPs).

Full documentation of Flee is available at https://flee.readthedocs.io.

Official releases will be done on https://www.github.com/djgroen/flee. (flee-release is deprecated and will be removed in due course.)

Parallel performance testing

Parallel tests can be performed using test_par.py. The interface is as follows:

mpirun -np python3 tests/test_par.py [options]

Options can be as follows:

  • "-p", "--parallelmode" - Parallelization mode ([advanced], classic, cl-hilat OR adv-lowlat).
  • "-N", "--initialagents" - Number of agents at the start of the simulation [100000].
  • "-d", "--newagentsperstep", Number of agents added per time step [1000].
  • "-t", "--simulationperiod", Duration of the simulation in days [10].

Here are a few settings good for benchmarking:

  • mpirun -np <cores> python3 test_par.py -N 500000 -p advanced -d 10000 -t 10
  • mpirun -np <cores> python3 test_par.py -N 500000 -p classic -d 10000 -t 10
  • mpirun -np <cores> python3 test_par.py -N 500000 -p cl-hilat -d 10000 -t 10
  • mpirun -np <cores> python3 test_par.py -N 500000 -p adv-lowlat -d 10000 -t 10

Acknowledgements

The development on Flee has been made possible through funding from the Horizon 2020 funded HiDALGO project (grant no. 824115, https://hidalgo-project.eu) and VECMA (grant no. 800925, https://www.vecma.eu).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flee-3.1.tar.gz (93.3 kB view hashes)

Uploaded Source

Built Distribution

flee-3.1-py3-none-any.whl (91.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page