Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

GEB

Coupling of an agent-based model which simulates millions individual people or households, a hydrological model, a vegetation model and a hydrodynamic model.
https://github.com/geb-model/geb

Category: Hydrosphere
Sub Category: Freshwater and Hydrology

Keywords from Contributors

hydrology

Last synced: about 2 hours ago
JSON representation

Repository metadata

README.md

GEB (Geographical Environmental and Behavioural model) simulates the environment (e.g., hydrology, floods), the individual people, households and organizations 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.

The figure below shows a schematic overview of GEB.

Schematic model overview of GEB.

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, 2023.

Applications

Bril, V. C., de Bruijn, J., de Moel, H., Sadana, T., Busker, T., Botzen, W. J. W., & Aerts, J. C. J. H.: Assessing the effectiveness of nature-based solutions and building-level flood risk reduction measures: An open-source coupled Model. Water Resources Research, 62, e2025WR041436, https://doi.org/10.1029/2025WR041436, 2026.

Kalthof, M. W. M. L., de Bruijn, J., de Moel, H., Kreibich, H., and Aerts, J. C. J. H.: Adaptive behavior of farmers under consecutive droughts results in more vulnerable farmers: a large-scale agent-based modeling analysis in the Bhima basin, India, NHESS, https://doi.org/10.5194/nhess-25-1013-2025, 2025.

Building on the shoulders of giants

  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.

FAQ

How is GEB pronounced?

It’s pronounced as "geb" (/ɡɛb/), with the "g" as in "get" or "gate", aligning with how ancient Egyptians would have likely pronounced the name of their god of the Earth: Geb.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
title: "GEB v0.1: a large-scale agent-based socio-hydrological model -- simulating 10 million individual farming households in a fully distributed hydrological model"
authors:
  - family-names: "de Bruijn"
    given-names: "J. A."
  - family-names: "Smilovic"
    given-names: "M."
  - family-names: "Burek"
    given-names: "P."
  - family-names: "Guillaumot"
    given-names: "L."
  - family-names: "Wada"
    given-names: "Y."
  - family-names: "Aerts"
    given-names: "J. C. J. H."
version: 0.1
journal-title: "Geoscientific Model Development"
year: 2023
month: 9
volume: 16
issue: 9
page: "2437-2454"
doi: "10.5194/gmd-16-2437-2023"
url: "https://gmd.copernicus.org/articles/16/2437/2023/"

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 5,334
Total Committers: 19
Avg Commits per committer: 280.737
Development Distribution Score (DDS): 0.296

Commits in past year: 2,964
Committers in past year: 14
Avg Commits per committer in past year: 211.714
Development Distribution Score (DDS) in past year: 0.413

Name Email Commits
Jens de Bruijn j****n@o****m 3757
Tierolf l****f@h****m 754
Maurice m****f@g****m 290
Tim Busker t****l 185
Veerle Bril v****l@v****l 107
T-Sadana t****a@v****l 96
Rafaella r****o@g****m 51
TimBusker 8****r 35
Roy Pontman r****n@v****l 19
Elisa Stefaniak e****a@f****m 12
lisanneva l****t@v****l 6
copilot-swe-agent[bot] 1****t 4
jkiesel1988 j****l@w****e 4
Tierolf l****0@n****r 4
Tierolf l****0@n****r 3
Tierolf l****0@n****r 3
Carolina Ferman c****l@v****l 2
Jens de Bruijn j****n@o****m 1
Guo-icloud 2****6@q****m 1

Committer domains:

Issue and Pull Request metadata

Last synced: 3 days ago

Total issues: 220
Total pull requests: 328
Average time to close issues: 2 months
Average time to close pull requests: 8 days
Total issue authors: 10
Total pull request authors: 11
Average comments per issue: 0.47
Average comments per pull request: 0.33
Merged pull request: 242
Bot issues: 0
Bot pull requests: 18

Past year issues: 53
Past year pull requests: 130
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 16 days
Past year issue authors: 9
Past year pull request authors: 9
Past year average comments per issue: 0.81
Past year average comments per pull request: 0.81
Past year merged pull request: 70
Past year bot issues: 0
Past year bot pull requests: 17

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/geb-model/geb

Top Issue Authors

  • jensdebruijn (159)
  • ltierolf (20)
  • WMLKalthof (18)
  • TimBusker (12)
  • T-Sadana (5)
  • Huazhi-Li (2)
  • roy-pontman (1)
  • jkiesel1988 (1)
  • keul (1)
  • vcbril (1)

Top Pull Request Authors

  • jensdebruijn (159)
  • ltierolf (67)
  • TimBusker (33)
  • dependabot[bot] (18)
  • WMLKalthof (13)
  • romijnservaas (12)
  • vcbril (9)
  • rafaellaglo (6)
  • T-Sadana (5)
  • Royp-hydro (4)
  • foxeswithdata (2)

Top Issue Labels

  • enhancement (39)
  • bug (21)
  • documentation (2)
  • performance (2)
  • Upscaling (1)
  • invalid (1)

Top Pull Request Labels

  • dependencies (18)
  • python:uv (17)
  • github_actions (1)

Package metadata

proxy.golang.org: github.com/GEB-model/GEB

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/GEB-model/GEB#section-documentation
  • Licenses: gpl-3.0
  • Latest release: v0.1.1 (published over 3 years ago)
  • Last Synced: 2026-08-12T13:04:37.837Z (1 day ago)
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
proxy.golang.org: github.com/geb-model/geb

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/geb-model/geb#section-documentation
  • Licenses: gpl-3.0
  • Latest release: v0.1.1 (published over 3 years ago)
  • Last Synced: 2026-08-12T13:05:17.632Z (1 day ago)
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
pypi.org: geb

GEB simulates the environment (e.g., hydrology, floods), the individual people, households and orginizations as well as their interactions at both small and large scale.

  • Homepage:
  • Documentation: https://docs.geb.sh
  • Licenses: GPL-3.0-only
  • Latest release: 0.0.1 (published about 2 years ago)
  • Last Synced: 2026-08-12T13:04:37.347Z (1 day ago)
  • Versions: 34
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 175 Last month
  • Rankings:
    • Dependent packages count: 10.637%
    • Downloads: 15.074%
    • Average: 28.538%
    • Dependent repos count: 59.903%
  • Maintainers (2)
pypi.org: geb-model

GEB simulates the environment, the individual behaviour of people, households and organizations - including their interactions - at small and large scale.

  • Homepage:
  • Documentation: https://geb-model.readthedocs.io/
  • Licenses: GNU General Public License v3 (GPLv3)
  • Latest release:
  • Last Synced: 2026-08-12T13:05:17.022Z (1 day ago)
  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 479 Last month
  • Rankings:
    • Dependent packages count: 10.471%
    • Average: 34.71%
    • Dependent repos count: 58.949%
  • Maintainers (1)

Dependencies

.github/workflows/docs.yml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • actions/upload-artifact v2 composite
  • ammaraskar/sphinx-problem-matcher master composite
  • peaceiris/actions-gh-pages v3 composite
.github/workflows/pytest.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
pyproject.toml pypi
  • dask >=2023.3.0
  • deap *
  • geopandas >=0.14
  • honeybees @git+https://github.com/jensdebruijn/honeybees
  • hydromt-sfincs @git+https://github.com/Deltares/hydromt_sfincs
  • numba *
  • numpy *
  • openpyxl *
  • pandas *
  • pybind11 *
  • pyyaml *
  • rasterio *
  • rioxarray >=0.15
  • tbb *
  • xarray *
.github/workflows/ty-check.yml actions
  • actions/checkout v4 composite
uv.lock pypi
  • 378 dependencies
.github/workflows/ruff-check.yml actions
  • actions/checkout v4 composite
  • astral-sh/ruff-action v3 composite
.github/workflows/ruff-format.yml actions
  • actions/checkout v4 composite
  • astral-sh/ruff-action v3 composite
.github/workflows/publish.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/upload-artifact v4 composite
  • astral-sh/attest-action v0.0.5 composite
.github/actions/check-docs-changes/action.yml actions
.github/workflows/auto-approve-docs.yml actions
  • ./.github/actions/check-docs-changes * composite
  • actions/checkout v4 composite
.github/workflows/docs_test.yml actions
  • actions/checkout v4 composite

Score: 13.98447665971107