Flee 3.1

This is the release of Flee 3.1, and incremental update from Flee 3.0. All issues related to this release can be found here:
https://github.com/djgroen/flee/issues?q=is%3Aissue+milestone%3A%22Flee+3.1%22+is%3Aclosed

Major new features

• The importance of link weighting can be amplified or diminished with a scaling factor now, reducing or increasing randomness in the algorithm.
• Location weights (and default move chances) can now be weighted by the population of a location, making large settlements more atractive (or less likely to be moved away from).

Minor new features

• Added a marker location type, which can be used for visualisation purposes.
• Support for a weighting preference where displaced persons will favour staying close to their home location.

Bugfixes

• Major bug in route selection and weight calculation found and resolved. This bug triggered only when AwarenessLevel is set to higher than 1.
• Minor code cleanup activities and improvements in the test suite.

Note that unlike previous versions, Flee 3 will be subject to regular incremental releases and updates, as we foresee the need to implement a range of new mechanisms and move rules during the lifetime of this version.

Lastly, note that Flee 3.0 can only be used with FabFlee 3.0 or higher. It is backwards compatible with the Flee 2.0 input files, but the simsetting.yml will need to be defined and added.

Flee 3.0

This is the release of Flee 3.0.

Major new features

• New format for defining simulation settings (simsettings.yml).
• Support for custom-based location-specific and link-specific properties.
• Support for demographic attributes on agents.
• Addition of four new demographics-based move rules.
• Support for conflict-driven spawning, where new displaced persons are spawned based on conflict intensity, rather than provided in advance by the user.
• Large revisions and extensions to https://flee.readthedocs.io
• Hugely extended logging infrastructure, allowing logs for individual agent movements, individual links, and counting the number of hops.

Minor new features

• Added support for the idpcamp location type, which can be opened or closed.
• Added support to load agents in advance from an agents.csv file.
• Added support for remove_forced_redirection.
• Added support for sink locations, which deactivate agents when agents reside there.
• Added support for delayed camp openings.
• Added support for link-dependent MaxMoveSpeeds.
• The conflict property of a location is no longer a binary values, but a float with which intensity can be varied by changing its value.
• Added support for a foreign_weight parameter for foreign locations, separately from camp_weight
• Added YYYY-MM-DD date information to out.csv, to make parsing easier.

Bugfixes

• Removed several bugs from the Burundi conflict example in FabFlee.
• Revised the path selection algorithm for higher awareness levels, such that routes are pre-planned more sensibly.
• Default camp capacities are changed from 0 to unlimited.
• Refactored the source code altogether, making it more modular and easier to debug.
• Removed a range of obsolete and/or unused functions.
• Rephrased "refugees" to "displaced persons" in output and plotting infrastructure.
• Fixed a wide range of test cases and added several new unit tests to improve code reliability.

Note that unlike previous versions, Flee 3 will be subject to regular incremental releases and updates, as we foresee the need to implement a range of new mechanisms and move rules during the lifetime of this version.

Lastly, note that Flee 3.0 can only be used with FabFlee 3.0 or higher. It is backwards compatible with the Flee 2.0 input files, but the simsetting.yml will need to be defined and added.

FLEE v3.0alpha

This is the alpha release of Flee 3.0. There are still a range of issues to solve and things to update, but the basic code is working.

Flee 3.0 contains a range of updates, including:

• New format for defining simulation settings (simsettings.yml) (not yet documented, but format is visible in SimulationSettings.py for now)
• Support for custom-based location-specific properties. (documented)
• Support for demographic attributes on agents. (documented)
• Addition of four new demographics-based move rules. (not yet documented)

This version is meant for community testing, and we strive to push a beta version in the middle of August. Please leave any suggestions or bug reports as GitHub issues.

Lastly, note that Flee 3.0 can only be used with FabFlee 3.0 or higher. It is backwards compatible with the Flee 2.0 input files, but the simsettings.yml will need to be defined and added.

Flee 2 - Accessibility version

A modified version of Flee 2.0 used for the paper "Analysing the effect of a dynamic physical environment network on the travel dynamics of forcibly displaced persons in Mali"

FLEE 2.0

The first release of FLEE at pypi.org

Flee 2.0 pre-release

This version of Flee features an updated and more configurable ruleset, improved parallel performance, and has been tested against a much wider range of conflicts.

Although it has been extensively tested, way may make further improvements to the ruleset before tagging a full release.

Last version of the code with Ruleset 1.0

This is the last version of the code, before the updated ruleset branch has been merged into the master.

v1.0 - Code used with Scientific Reports article.

This is the version of FLEE that has been used for the (final) runs in the Scientific Reports paper. Not all files are in the public release (which is on www.github.com/djgroen/flee-release), as some of the files are works in progress towards future papers.