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: 1 day ago
JSON representation
Repository metadata
- Host: GitHub
- URL: https://github.com/geb-model/geb
- Owner: GEB-model
- License: gpl-3.0
- Created: 2022-07-11T09:56:53.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-11-06T15:45:08.000Z (1 day ago)
- Last Synced: 2026-11-07T08:02:52.382Z (1 day ago)
- Language: Python
- Homepage: https://docs.geb.sh/
- Size: 79.6 MB
- Stars: 16
- Watchers: 3
- Forks: 6
- Open Issues: 94
- Releases: 42
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Citation: CITATION.cff
- Zenodo: .zenodo.json
- Agents: AGENTS.md
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.
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
- 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).
- Langevin, Christian D., et al. Documentation for the MODFLOW 6 groundwater flow model. No. 6-A55. US Geological Survey, 2017.
- 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.
- 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.
- Joshi, Jaideep, et al. "Plant-FATE-Predicting the adaptive responses of biodiverse plant communities using functional-trait evolution." EGU General Assembly Conference Abstracts. 2022.
- 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"
authors:
- family-names: "de Bruijn"
given-names: "Jens"
- family-names: "Kalthof"
given-names: "Maurice"
- family-names: "Bril"
given-names: "Veerle"
- family-names: "Tierolf"
given-names: "Lars"
- family-names: "Sadana"
given-names: "Tarun"
- family-names: "Stefaniak"
given-names: "Elisa"
- family-names: "Busker"
given-names: "Tim"
- family-names: "Oliveira"
given-names: "Rafaella"
- family-names: "Carral"
given-names: "Carolina"
- family-names: "Pontman"
given-names: "Roy"
- family-names: "van Amelsvoort"
given-names: "Lisanne"
- family-names: "Kiesel"
given-names: "Joshua"
preferred-citation:
type: article
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."
doi: "10.5194/gmd-16-2437-2023"
journal: "Geoscientific Model Development"
month: 9
start: 2437
end: 2454
title: "GEB a large-scale agent-based socio-hydrological model -- simulating 10 million individual farming households in a fully distributed hydrological model"
issue: 9
volume: 16
year: 2023
url: "https://gmd.copernicus.org/articles/16/2437/2023/"
Owner metadata
- Name: GEB-model
- Login: GEB-model
- Email: jens.de.bruijn@vu.nl
- Kind: organization
- Description:
- Website:
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/152297940?v=4
- Repositories: 1
- Last ynced at: 2026-11-06T16:13:30.027Z
- Profile URL: https://github.com/GEB-model
GitHub Events
Total
- Create event: 239
- Delete event: 230
- Fork event: 2
- Issue comment event: 72
- Issues event: 187
- Member event: 4
- Pull request event: 247
- Pull request review comment event: 347
- Pull request review event: 183
- Push event: 2027
- Release event: 5
- Watch event: 5
Last Year
- Create event: 142
- Delete event: 146
- Fork event: 2
- Issue comment event: 18
- Issues event: 43
- Pull request event: 73
- Pull request review comment event: 271
- Pull request review event: 126
- Push event: 1012
- Release event: 2
Committers metadata
Last synced: 2 days ago
Total Commits: 5,408
Total Committers: 19
Avg Commits per committer: 284.632
Development Distribution Score (DDS): 0.299
Commits in past year: 2,344
Committers in past year: 14
Avg Commits per committer in past year: 167.429
Development Distribution Score (DDS) in past year: 0.43
| Name | Commits | |
|---|---|---|
| Jens de Bruijn | j****n@o****m | 3789 |
| Tierolf | l****f@h****m | 768 |
| Maurice | m****f@g****m | 291 |
| Tim Busker | t****l | 185 |
| Veerle Bril | v****l@v****l | 110 |
| T-Sadana | t****a@v****l | 103 |
| Rafaella | r****o@g****m | 54 |
| TimBusker | 8****r | 42 |
| Roy Pontman | r****n@v****l | 23 |
| Elisa Stefaniak | e****a@f****m | 12 |
| Lisanne van Amelsvoort | l****t@v****l | 8 |
| copilot-swe-agent[bot] | 1****t | 4 |
| jkiesel1988 | j****l@w****e | 4 |
| Tierolf | l****0@n****r | 4 |
| Carolina Ferman | c****l@v****l | 3 |
| Tierolf | l****0@n****r | 3 |
| Tierolf | l****0@n****r | 3 |
| Jens de Bruijn | j****n@o****m | 1 |
| Guo-icloud | 2****6@q****m | 1 |
Committer domains:
- vu.nl: 5
- qq.com: 1
- oulook.com: 1
- node241.cm.cluster: 1
- node242.cm.cluster: 1
- node240.cm.cluster: 1
- foxeswithdata.com: 1
Issue and Pull Request metadata
Last synced: 2 days ago
Total issues: 371
Total pull requests: 737
Average time to close issues: 3 months
Average time to close pull requests: 4 days
Total issue authors: 10
Total pull request authors: 18
Average comments per issue: 0.67
Average comments per pull request: 0.24
Merged pull request: 613
Bot issues: 0
Bot pull requests: 25
Past year issues: 158
Past year pull requests: 415
Past year average time to close issues: 22 days
Past year average time to close pull requests: 5 days
Past year issue authors: 10
Past year pull request authors: 15
Past year average comments per issue: 0.79
Past year average comments per pull request: 0.36
Past year merged pull request: 349
Past year bot issues: 0
Past year bot pull requests: 24
Top Issue Authors
- jensdebruijn (244)
- ltierolf (47)
- TimBusker (26)
- WMLKalthof (24)
- T-Sadana (15)
- jkiesel1988 (5)
- Huazhi-Li (4)
- vcbril (3)
- roy-pontman (2)
- keul (1)
Top Pull Request Authors
- jensdebruijn (354)
- ltierolf (161)
- TimBusker (62)
- vcbril (30)
- WMLKalthof (26)
- T-Sadana (26)
- dependabot[bot] (24)
- romijnservaas (12)
- roy-pontman (10)
- rafaellaglo (9)
- Copilot (6)
- jkiesel1988 (5)
- FC-Caro (4)
- Lisanneva (3)
- foxeswithdata (2)
Top Issue Labels
- enhancement (92)
- bug (57)
- Disk space (6)
- Upscaling (4)
- Nice to have (3)
- performance (2)
- invalid (2)
- Forecasts (2)
- documentation (2)
- Usability (1)
- RAM (1)
- Future-bug (1)
- question (1)
Top Pull Request Labels
- dependencies (24)
- python:uv (23)
- github_actions (1)
Package metadata
- Total packages: 4
-
Total downloads:
- pypi: 743 last-month
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 46
- Total maintainers: 2
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-11-06T07:42:55.413Z (2 days 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-11-06T07:42:55.576Z (2 days 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://geb.readthedocs.io/
- Licenses: GNU General Public License v3 (GPLv3)
- Latest release: 0.4 (published 2 months ago)
- Last Synced: 2026-11-06T03:46:12.280Z (2 days ago)
- Versions: 37
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 264 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: 1.0.0a8 (published about 2 years ago)
- Last Synced: 2026-11-06T03:46:11.891Z (2 days 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
- 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
- actions/checkout v2 composite
- actions/setup-python v2 composite
- 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 *
- actions/checkout v4 composite
- 378 dependencies
- actions/checkout v4 composite
- astral-sh/ruff-action v3 composite
- actions/checkout v4 composite
- astral-sh/ruff-action v3 composite
- 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 * composite
- actions/checkout v4 composite
- actions/checkout v4 composite
- actions/checkout v4 composite
- astral-sh/setup-uv v5 composite
- actions/checkout v4 composite
- citation-file-format/cffconvert-github-action 2.0.0 composite
Score: 14.249171079775143