Data

Tools

Indexes

Applications

Experiments

Open Source Science

mayasim

An agent-based model of the ancient Maya social-ecological system

https://github.com/pik-copan/mayasim

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 3 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: zenodo.org
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (10.0%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

An agent-based model of the ancient Maya social-ecological system

Basic Info
  • Host: GitHub
  • Owner: pik-copan
  • License: gpl-3.0
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 81.7 MB
Statistics
  • Stars: 8
  • Watchers: 2
  • Forks: 5
  • Open Issues: 5
  • Releases: 4
Created over 10 years ago · Last pushed about 1 year ago
Metadata Files
Readme License Citation

README.md

MayaSim

DOI

An agent-based model of the ancient Maya social-ecological system.

MayaSim is an integrated agent-based, cellular-automaton and network simulation of the Maya civilization on the Yucatan peninsula throughout the Mayan Classic epoch. Agents are settlements situated on a gridded spatial landscape. These settlements grow and interact with their surrounding forest ecosystem through use of ecosystem services, agriculture induced soil erosion and forest succession. The model aims to reproduce interrelations between climate variability, primary production, hydrology, ecosystem services, forest succession, agricultural production, population growth and the stability of trade networks. The project is based on previous work by Scott Heckbert (2013) published in Netlogo, and is reimplemented and further developed in Python. The focus lies firstly on the implementation of realistic approaches to modeling agents' income from agriculture and trade. The goal is to first test the model's structural stability and parameter sensitivity, and then to test the plausibility of different hypotheses on the causes of the ancient Maya's spectacular rise and subsequent catastrophic reorganization.

Install

Install MayaSim in a conda environment following these steps:

  1. Create and activate environment: $> conda create -n mayasim -c conda-forge python=3.11 numpy=1 mpi4py gfortran pandas networkx scipy sympy matplotlib tqdm pytables notebook $> conda activate mayasim Note: MayaSim has successfully been run on python>=3.9, <=3.11.

  2. Download/clone MayaSim to a local directory. Then navigate to this directory and install with pip: $> cd path/to/MayaSim $> pip install .

  3. Build MayaSim's Fortran extension module by running the included script: $> cd mayasim/model/_ext $> sh f90makefile.sh

Run

Import and run MayaSim from a Python script:

```python from mayasim.model.core import Core as MayaSim

model = MayaSim() model.run(steps=350) ```

Take a look into the quickstart-tutorial in docs for some example settings.

Owner

  • Name: copan
  • Login: pik-copan
  • Kind: organization
  • Email: donges@pik-potsdam.de
  • Location: Potsdam (Germany)

Coevolutionary Pathways – collaboration at Potsdam Institute for Climate Impact Research (PIK)

Citation (CITATION.cff) 

cff-version: 1.2.0
message: If you use this software, please cite it using the metadata provided below.
type: software
title: 'MayaSim: An agent-based model of the ancient Maya social-ecological system'
version: 1.3.0
date-released: '2024-09-13'
abstract: MayaSim is an integrated agent-based, cellular-automaton and network simulation
  of the Maya civilization on the Yucatan peninsula throughout the Mayan Classic epoch.
  Agents are settlements situated on a gridded spatial landscape. These settlements grow
  and interact with their surrounding forest ecosystem through use of ecosystem services,
  agriculture induced soil erosion and forest succession. The model aims to reproduce
  interrelations between climate variability, primary production, hydrology, ecosystem
  services, forest succession, agricultural production, population growth and the
  stability of trade networks. The project is based on previous work by Scott Heckbert
  (2013) published in Netlogo, and is reimplemented and further developed in Python.
  The focus lies firstly on the implementation of realistic approaches to modeling agents'
  income from agriculture and trade. The goal is to first test the model's structural
  stability and parameter sensitivity, and then to test the plausibility of different
  hypotheses on the causes of the ancient Maya's spectacular rise and subsequent
  catastrophic reorganization.
authors:
- family-names: Kühlein
  given-names: Fritz
- family-names: Kolb
  given-names: Jakob J.

license: GPL-3
repository-code: https://github.com/pik-copan/MayaSim
doi: 10.5281/zenodo.13734595

GitHub Events

Total
  • Watch event: 2
  • Push event: 1
  • Fork event: 1
Last Year
  • Watch event: 2
  • Push event: 1
  • Fork event: 1

Dependencies

setup.py pypi
  • matplotlib *
  • networkx *
  • numpy ==1.13.0
  • pandas ==0.22.0
  • pickleshare *
  • pymofa *
  • scipy *