v1.0.1 – Metadata and documentation update

• Fixed project title: "Using survey-based ABM in migration research"
• Updated README.md with DOI badge
• Updated zenodo.json metadata for future releases

v1.0.0 – First release of “Using survey-based ABM in migration research”

v1.0.0 – First Release of Tutorial ABM. Originally part of a tutorial given in Summer 2023 as part of the Research Incubator at the Max Planck Institute for Demographic Research.

This is the initial release of the Tutorial on Agent-Based Modelling (ABM) with Survey Data.
It contains all materials needed to reproduce the examples presented in the tutorial.

Contents

• 1_theoretical_ABM/

  • Jupyter notebooks and Julia scripts for a theoretical ABM.
  • Includes data/colinc/ (Colombian household survey data).
  • scenarios.jl and scenarios.ipynb run all simulations.

• 2_survey_ABM/

  • Data management model (data_management_model/):
    • R and Stata scripts (run_scripts.R, manage_lamp_ABM.R, model_ABM.do) for preparing LAMP survey data.
    • Produces input datasets (lampABM.csv, macro.csv) and model parameters (stat_model_lampABM_mlogit.csv).
  • ABM implementation: Julia scripts and notebooks (import.ipynb, model.ipynb, setup.ipynb, run.ipynb, scenarios.jl, creation_figures.ipynb).
  • Data (data/): preprocessed LAMP datasets (micro/macro, censored, uncensored, parameters).

• presentation.pptx
  PowerPoint slides used in the tutorial, with an overview of ABM concepts and a walkthrough of the models.

How to Run

1. Theoretical ABM

   cd 1_theoretical_ABM
   jupyter notebook scenarios.ipynb

2. Survey ABM pipeline

   cd 2_survey_ABM/data_management_model
   Rscript run_scripts.R
   stata-se -b do model_ABM.do   # or run interactively in Stata
   cd ..
   julia scenarios.jl

   Then use run.ipynb for analysis and visualization.

📖 Notes

• Requires Julia ≥ 1.9, R ≥ 4.0, and Stata (for event history estimation).
• Recommended Julia packages: Agents.jl, StatsBase.jl, DataFrames.jl, IJulia.
• For detailed instructions, see the updated README.md.