This is the code for the HAAMoS (Hybrid Aggregated Agent‐based Microsimulation of Segregation) model.
HAAMoS is a data-driven, multifactor, multiscale, multi-measure agent-based microsimulation model for investigating various scenarios related to the effects of population mobility, housing vacancy, individual preferences & behaviours, and economic factors on ethnic residential segregation.
The scenarios are applied to the multi-ethnic population of the Auckland metropolitan area, encompassing four significant ethnic groups. Population mobility, driven by empirical data, is generated from geographical census-based area units. However, the majority of analyses are concentrated within the five most densely populated territorial authorities of the central Auckland region.
While the Auckland region serves as a case study to investigate residential segregation dynamics and ethnic mosaic patterns, the model's versatility allows its application to any urban area. To adapt the model to a different urban area, one would need the corresponding shapefile, GAL file, and other relevant empirical data.
One notable feature of this hybrid approach, which combines agent-based modelling (ABM) and Microsimulation (MSM) methodologies, is its ability to operate in both realistic, census-GIS-based environments and artificial grid-based settings.
The model can calculate the following segregation measures:
The model can be used within the limited range of functionalities described in:
Using a Hybrid Model for Investigating Residential Segregation: An Empirical and Simulation-based Study
and
An agent-based microsimulation framework for investigating residential segregation using census data
Please note that the HAAMoS model was not initially developed with public usage in mind. Some concepts and features have been inherited and maintained from the initial prototypes (described in the thesis), and there might be instances where certain aspects are not fully functional within the HAAMoS model.
To install and run the HAAMoS model, you need to install the following programs on your computer.
You can install Java before installing Eclipse.
The model was tested on the Windows operating system, but it should also work on other platforms such as Mac OS and Linux, as long as you download and install the compatible versions of the following programs. Additionally, you may need to adjust the paths to specific files in batch mode according to the syntax requirements of your operating system. Please note that the compatibility and installation instructions may vary depending on your specific operating system and software versions. It's recommended to refer to the documentation or guidelines provided with each program for detailed installation and configuration instructions.
To import a Repast project into Eclipse, follow these instructions:
To import the HAAMoS project into Eclipse, follow these instructions:
To run the model follow these steps:
Initial Launch:
Launch Configuration:
Model Execution:
Additional Configuration (Batch Mode):
Batch Mode Setting:
Shapefile Configuration:
Environment Settings:
Immigration Configuration:
Census-based Immigration:
Make sure to adjust these parameters in the Const class of the HAAMoS model to suit your desired settings and then execute the model accordingly.
Right-click on the HAAMoSModel.java file in the Eclipse Package Explorer to open the pop-up menu.
From the pop-up menu, select "Run As" and then choose the "Open Run Dialog..." option.
This will open the Run Configurations dialog box.
In the Run Configurations dialog box, locate the "VM arguments" section.
In the VM arguments field, add the following argument to increase the maximum heap size: -Xmx
For example, to set the maximum heap size to 500 Megabytes, use -Xmx500M.
After setting the desired maximum heap size, click the "Apply" button to save the changes.
Click the "Run" button to launch the simulation with the increased heap size.
By increasing the heap size, you allocate more memory to the Java runtime, which can help prevent Java "Out Of Memory Error" messages during the execution of scenarios.
The HAAMoS model is licensed under the GNU GENERAL PUBLIC LICENSE. See LICENSE for more information.
Babak Mahdavi Ardestani