UKDemographicABM.jl: A demographic Agent-based model of the UK
Implementation of a demographic agent-based model of the UK based on the UKSEABMLib.jl [1] and employs an agent-based model simulator tool, ABMSim.jl [2] and Agents.jl package [3]. The implementation based on Agents.jl is just a first attempt and is subject to tuning. The model is a re-implementation of the demographic part of the Lone Parent Model implemented in Python [4]. The code is extended from from LoneParentsModel.jl V0.6.1 [5].
-
V0.1.0 (28.11.2022) : The lone parent model (corresponding to LoneParentsModel.jl Version 0.6.1) based on the SocioEconomics.jl package V0.1.0
- V0.1.1 (29.11) : Simplified usage of SocioEconomics Library
- V0.1.2 ( 1.12) : "data parameters" and loading / handling parameters from command line and input files is now part of SE library within ParamTypes module
- V0.1.3 ( 2.12) : Utilties is a part of the SE* libraries (compatible with SE V0.1.3)
-
V0.2.0 (5.12.2022) : Unified API of CreateX and Initialize functions (compatible with SE V0.2)
-
Remark: main.jl is no longer maintained.
-
V0.2.1 (7.12) : New Simulation Interface for 3 functions, doBirths!, doDeaths!, doDivorces, Improved API for parameter accessory functions, compatible with SE* Version 0.2.1
-
V0.2.2 (8.12) : doMarriages (SE* V0.2.2)
-
V0.2.3 (9.12) : adoptions, workTransitions, socialTransitions, ageTransitions (SE* V0.2.3)
-
V0.2.4 (14.12) : adjusting to SimpleABM types of MA Version 0.4, improved model data structure
-
V0.2.5 (21.12) : exploits some tuned simulation functions from SE* V0.2.5 and improved performance
-
V0.2.6 (27.12) : Improved implementation of allocation algorithms (no temporary arrays), tuned do marriage algorithm (memoization can be avoided) & Improved runtime performance (3x faster & 4x less memory allocation and storage w.r.t. V0.2.5)
-
V0.2.7 (6.1.2023) : Memoization with domarriage alg can be done only externally (if desired). Employing newly tuned and exact API of four simulation functions. Optimized simulation (with deads removal) vs. normal simulation (without deads removal)
-
V0.2.8 (8.1.2023) : employing tuned API of assigning guardians
-
-
V0.3 (14.01.2023) : Making use of the rest of the fixed API of SE's Simulate function, further code simplification and tuning. Signficant memory allocation reduction and runtime performance improvement
- V0.3.1 (16.1) : Blue style badge, separating mainMAHelpers.jl from mainHelpers.jl, arbitrary population size
- V0.3.2 (20.1) : Employing the blue-styled SE V0.3.2
-
V0.4 (14.03.2023) : Compatible with SE Version SE0.4, started an Agents.jl-based main program, moving unsed code to deprecated
- V0.4.1 (15.5) : another main simulation program based on Agents.jl
- V0.4.2 (16.5) : simplification of main simulation functions (now without time argument)
- V0.4.3 (19.5) : improved code structure, simulation with a simple simulator type
- V0.4.4 (23.5) : caching pre-computations and little tuning
-
V0.5 (29.8.2023): Employing ABMSim V0.6 rather than MultiAgents, SE V0.5, bug fixes for mainAgents.jl, removing unnecessary code
-
V0.6 (30.8.2023): Renaming SocioEconomics.jl to UKSEABMLib.jl, renaming LPM.jl to UKDemographicABM.jl
- V0.6.1 (5.10): Signficant performance improvement for Agents.jl-based main
See here
MIT License
Copyright (c) 2023 Atiyah Elsheikh, MRC/CSO Social & Public Health Sciences Unit, School of Health and Wellbeing, University of Glasgow, Cf. License for further information
This code was developed and experimented on
- Ubuntu 22.04.2 LTS
- VSCode V1.71.2
- Julia language V1.9.1
- Agents.jl V5.14.0
This model is making use of the ABMSim.jl package which needs to be internally installed (currently not registered).
> include("main.jl")
> # or
> include("mainAgents.jl") # for using Agents.jl
[1] Atiyah Elsheikh,The UKSEABMLib.jl componants library for agent-based UK-oriented socioeconomics modelling applications, 2023. Zenodo. https://doi.org/10.5281/zenodo.8301125
[2] Atiyah Elsheikh, ABMSim.jl: An agent-based model simulator. Zenodo. https://doi.org/10.5281/zenodo.8284008, 2023
[3] George Datseris, Ali R. Vahdati and Timothy C. DuBois: Agents.jl: a performant and feature-full agent-based modeling software of minimal code complexity. SIMULATION. 2022. doi:10.1177/00375497211068820
[4] Umberto Gostoli and Eric Silverman Social and child care provision in kinship networks: An agent-based model. PLoS ONE 15(12): 2020 (https://doi.org/10.1371/journal.pone.0242779)
[5] LoneParentsModel.jl V0.6.1
Atiyah Elsheikh. (2023). UKDemographicABM.jl: A demographic Agent-based model of the UK. Zenodo. https://doi.org/10.5281/zenodo.8302495
Version 0.6:
Atiyah Elsheikh. (2023). UKDemographicABM.jl: A demographic Agent-based model of the UK (0.6). Zenodo. https://doi.org/10.5281/zenodo.8302496
@software{atiyah_elsheikh_2023_8302496, author = {Atiyah Elsheikh}, title = {{UKDemographicABM.jl: A demographic Agent-based model of the UK}}, month = aug, year = 2023, publisher = {Zenodo}, doi = {10.5281/zenodo.8302495}, url = {https://doi.org/10.5281/zenodo.8302495} }
version 0.6:
@software{atiyah_elsheikh_2023_8302496, author = {Atiyah Elsheikh}, title = {{UKDemographicABM.jl: A demographic Agent-based model of the UK}}, month = aug, year = 2023, publisher = {Zenodo}, version = {0.6}, doi = {10.5281/zenodo.8302496}, url = {https://doi.org/10.5281/zenodo.8302496} }
For the purpose of open access, the author(s) has applied a Creative Commons Attribution (CC BY) licence to any Author Accepted Manuscript version arising from this submission.
Dr. Atyiah Elsheikh, by the time of publishing Version 0.6 of this software, is a Research Software Engineer at MRC/CSO Social & Public Health Sciences Unit, School of Health and Wellbeing, University of Glasgow. He is in the Complexity in Health programme. He is supported by the Medical Research Council (MC_UU_00022/1) and the Scottish Government Chief Scientist Office (SPHSU16).