This repository includes:

• All files required to run abm-cue models;
• A directory called ./samples with examples of input files and datasets;
• A directory called ./docs with some documentation files;
• A directory called ./gui with some graphical user interface files;
• The User Guide file: guide.md
• The installation tutorial for Windows file: install_windows.md
• The Input/Output documentation file: iodocs.md;

Note: see the User Guide

1. Agents walk randomly around a ring-like 1-D world of places;
2. Agents and places have orientation traits;
3. Agents have a bias to go to places like themselves;
4. Agents have a limited window of sight to the nearest places to go;
5. Agents interact with places only if they are related enough;
6. During interaction, agents influence the place orientation trait to a certain extent, and vice-versa.

The result is an evolving urban environment in 1-D world:

Or in 2-D world:

Topology features of simulations may be assessed via integration with GIS applications:

Large batch processing may be used for in-depth insights with sensitivity analysis:

Note: see the installation tutorial for Windows

For Windows, Mac and Linux, follow these generic steps:

1. Install python 3;
2. Install the following Python dependencies:
   • numpy;
   • scipy;
   • pandas;
   • matplotlib;
   • imageio.
3. Clone the latest release of this repository (download the asset zip folder);
4. Extract the files to a folder of preference (ex: C:\Users\Home\Documents\abm-cue-main);

Warning: do not change internal folder and file names.

6. Execute the app_cue1d.py file for the CUE 1-D model or the app_cue2d.py file for the CUE 2-D model.