This repository serves as a template for simulation projects developed in the MA course
“Agent-based Modelling for Archaeologists: From Concept to Application and Publication.”
It provides a recommended folder structure and documentation style to ensure that every project is:
- Reproducible
- Transparent
- Citable
- Easy to understand and extend
Replace this text with a short description of your own project once you fork the repository.
| Folder | Contents | Purpose |
|---|---|---|
model/ |
NetLogo model files (.nlogo, .nlogox) |
Implementation of your simulation |
data/ |
Input datasets (e.g., environment, agents) | Empirical or synthetic data |
results/ |
Simulation outputs | Results from experiments or BehaviorSpace runs |
analysis/ |
R scripts and outputs | Data preparation, analysis and visualisation |
docs/ |
Notes and references | Conceptual documentation, figures, and citations |
You can edit files directly in your browser:
- Click “Use this template” → “Create a new repository.”
- Name it
project2025_<model-name>. - Edit files by clicking “Add file → Create new file” or the ✏️ icon.
git clone https://github.com/CoDArchLab-ABM/project2025_<model-name>.gitThen edit, commit, and push as usual.
- Fill in your project’s conceptual model in
docs/notes.md. - Add a draft NetLogo file in
model/. - Add placeholder data (if relevant) in
data/. - Commit your changes and push them to GitHub.
- Publish your first release (
v0.1) and connect Zenodo to obtain a DOI.
This template uses the MIT License. You may change it to another open license if needed (e.g. GPL-3.0, CC-BY-4.0).
Angourakis, A. (2025). CoDArchLab/Project2025_Template: Course repository template for Agent-based Modelling for Archaeologists. DOI: 10.5281/zenodo.xxxxxxx
Developed for the MA course Agent-based Modelling for Archaeologists: From Concept to Application and Publication by Andreas Angourakis and the CoDArchLab.