Metadata-Version: 2.1
Name: geb
Version: 1.0.0b4
Summary: GEB simulates the environment, the individual behaviour of people, households and organizations - including their interactions - at small and large scale.
Author-email: Jens de Bruijn <jens.de.bruijn@vu.nl>, Maurice Kalthof <w.m.l.kalthof@vu.nl>, Veerle Bril <v.c.bril@vu.nl>, Tim Busker <tim.busker@vu.nl>
Requires-Python: >=3.11, <3.13
Description-Content-Type: text/markdown
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Hydrology
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Requires-Dist: cdsapi>=0.7.3
Requires-Dist: damagescanner==0.8b1
Requires-Dist: dask>=2024.6
Requires-Dist: deap>=1.4.1
Requires-Dist: flopy>=3.8.0
Requires-Dist: geopandas>=1.0.1
Requires-Dist: honeybees>=1.0.4
Requires-Dist: hydromt==0.10.0
Requires-Dist: hydromt-sfincs>=1.1.0
Requires-Dist: isimip-client>=1.0.1
Requires-Dist: matplotlib>=3.9.2
Requires-Dist: numba>=0.60.0
Requires-Dist: numpy<2
Requires-Dist: openpyxl>=3.1.2
Requires-Dist: pyarrow>=17.0.0
Requires-Dist: pybind11>=2.13.4
Requires-Dist: pyogrio>=0.9.0
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: rasterio>=1.3.10
Requires-Dist: rioxarray>=0.17.0
Requires-Dist: s3fs>=2023.6.0
Requires-Dist: SALib>=1.4.8
Requires-Dist: scipy>=1.14.0
Requires-Dist: seaborn>=0.13.2
Requires-Dist: tbb4py>=2021.13.1
Requires-Dist: tqdm>=4.66.1
Requires-Dist: xarray>=2024.3.0
Requires-Dist: xclim>=0.52.0
Requires-Dist: xesmf>=0.8.4
Requires-Dist: xmipy>=1.5.0
Requires-Dist: zarr>=2.18.2
Requires-Dist: pytest ; extra == "dev"
Requires-Dist: ruff ; extra == "dev"
Requires-Dist: sphinx<8 ; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints ; extra == "docs"
Requires-Dist: sphinxcontrib-autoprogram ; extra == "docs"
Requires-Dist: sphinxcontrib-bibtex ; extra == "docs"
Requires-Dist: sphinx_rtd_theme ; extra == "docs"
Requires-Dist: sphinxcontrib-autoyaml ; extra == "docs"
Requires-Dist: pypandoc ; extra == "docs"
Requires-Dist: pgmpy>=0.1.24 ; extra == "fairstream"
Requires-Dist: daft>=0.1.2 ; extra == "fairstream"
Requires-Dist: opt-einsum>=3.3.0 ; extra == "fairstream"
Requires-Dist: cupy ; extra == "gpu"
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: fairstream
Provides-Extra: full
Provides-Extra: gpu

## Installation

GEB can be installed with pip, including all dependencies on Windows, Linux and Mac OS X.

```bash
pip install geb
```

## Overview
GEB (Geographical Environmental and Behavioural model) simulates the environment (e.g., hydrology, floods), the individual people, households and orginizations as well as their interactions at both small and large scale. The model does so through a "deep" coupling of an agent-based model a hydrological model, a vegetation model and a hydrodynamic model. You can find full documentation [here](https://geb-model.github.io/GEB/).

The figure below shows a schematic overview of the model agent-based and hydrological model.

![Schematic model overview of GEB.](https://raw.githubusercontent.com/GEB-model/GEB/refs/heads/main/docs/images/schematic_overview.svg "Schematic model overview")

## Cite as

### Model framework

> de Bruijn, J. A., Smilovic, M., Burek, P., Guillaumot, L., Wada, Y., and Aerts, J. C. J. H.: GEB v0.1: a large-scale agent-based socio-hydrological model – simulating 10 million individual farming households in a fully distributed hydrological model, Geosci. Model Dev., 16, 2437–2454, [https://doi.org/10.5194/gmd-16-2437-2023](https://doi.org/10.5194/gmd-16-2437-2023), 2023.

### Applications

> Kalthof, M. W. M. L., de Bruijn, J., de Moel, H., Kreibich, H., and Aerts, J. C. J. H.: Adaptive Behavior of Over a Million Individual Farmers Under Consecutive Droughts: A Large-Scale Agent-Based Modeling Analysis in the Bhima Basin, India, EGUsphere preprint, [https://doi.org/10.5194/egusphere-2024-1588](https://doi.org/10.5194/egusphere-2024-1588), 2024.

## Building on the shoulders of giants

GEB builds on, couples and extends several models, depicted in the figure below.

![Model components of GEB.](https://raw.githubusercontent.com/GEB-model/GEB/refs/heads/main/docs/images/models_overview.svg "Schematic model overview")

1. Burek, Peter, et al. "Development of the Community Water Model (CWatM v1.04) A high-resolution hydrological model for global and regional assessment of integrated water resources management." (2019).
2. Langevin, Christian D., et al. Documentation for the MODFLOW 6 groundwater flow model. No. 6-A55. US Geological Survey, 2017.
3. Tierolf, Lars, et al. "A coupled agent-based model for France for simulating adaptation and migration decisions under future coastal flood risk." Scientific Reports 13.1 (2023): 4176.
4. Streefkerk, Ileen N., et al. "A coupled agent-based model to analyse human-drought feedbacks for agropastoralists in dryland regions." Frontiers in Water 4 (2023): 1037971.
5. Joshi, Jaideep, et al. "Plant-FATE-Predicting the adaptive responses of biodiverse plant communities using functional-trait evolution." EGU General Assembly Conference Abstracts. 2022.
6. Leijnse, Tim, et al. "Modeling compound flooding in coastal systems using a computationally efficient reduced-physics solver: Including fluvial, pluvial, tidal, wind-and wave-driven processes." Coastal Engineering 163 (2021): 103796.

## Developers (ordered by full-time equivalent working time on model)
- [Jens de Bruijn](https://research.vu.nl/en/persons/jens-de-bruijn)
- [Maurice Kalthof](https://research.vu.nl/en/persons/maurice-kalthof)
- [Tarun Sadana](https://research.vu.nl/en/persons/tarun-sadana)
- [Veerle Bril](https://research.vu.nl/en/persons/veerle-bril)
- [Tim Busker](https://research.vu.nl/en/persons/tim-busker)

## Current or past contributors (in order of first to last contribution)
- [Mikhail Smilovic](https://iiasa.ac.at/staff/mikhail-smilovic)
- Luca Guillaumot
- Romijn Servaas
- Thomas van Eldik
