eWaterCycle

Makes it easier to use hydrological models without having intimate knowledge about how to install and run the models.
https://github.com/eWaterCycle/ewatercycle

Category: Hydrosphere
Sub Category: Freshwater and Hydrology

Keywords from Contributors

hydrology ansible ewatercycle bmi csdms phenology

Last synced: about 1 hour ago
JSON representation

Repository metadata

Python package for running hydrological models

• Host: GitHub
• URL: https://github.com/eWaterCycle/ewatercycle
• Owner: eWaterCycle
• License: apache-2.0
• Created: 2018-08-29T15:47:07.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2025-10-10T13:34:51.000Z (24 days ago)
• Last Synced: 2025-10-27T10:41:31.036Z (7 days ago)
• Language: Python
• Homepage: https://ewatercycle.readthedocs.io/en/latest/
• Size: 10.1 MB
• Stars: 38
• Watchers: 5
• Forks: 5
• Open Issues: 62
• Releases: 19
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Citation: CITATION.cff

README.md

curl -o conda-lock.yml https://raw.githubusercontent.com/eWaterCycle/ewatercycle/main/conda-lock.yml
conda install mamba conda-lock -n base -c conda-forge -y
conda-lock install --no-dev -n ewatercycle
conda activate ewatercycle

pip install ewatercycle

pip install ewatercycle-hype ewatercycle-lisflood ewatercycle-marrmot ewatercycle-pcrglobwb ewatercycle-wflow ewatercycle-leakybucket

forcing = ewatercycle.forcing.sources['MarrmotForcing'].generate(...)
model = ewatercycle.models.sources['MarrmotM14'](forcing)
model.setup(...)
model.initialize()
while (model.time < model.end_time):
    model.update()
    value = model.get_value_as_xarray('flux_out_Q')
model.finalize()
ewatercycle.analysis.hydrograph(...)

import ewatercycle.analysis
import ewatercycle.forcing
import ewatercycle.models
import ewatercycle.observation.grdc
from ewatercycle.testing.fixtures import rhine_shape
import shapefile
import xarray as xr

forcing = ewatercycle.forcing.sources['MarrmotForcing'].generate(
    dataset='ERA5',
    start_time='2010-01-01T00:00:00Z',
    end_time='2010-12-31T00:00:00Z',
    shape=rhine_shape()
)

model = ewatercycle.models.sources['MarrmotM14'](version='2020.11', forcing=forcing)

cfg_file, cfg_dir = model.setup(
    threshold_flow_generation_evap_change=0.1,
)

model.initialize(cfg_file)

# flux_out_Q unit conversion factor from mm/day to m3/s
sf = shapefile.Reader(rhine_shape())
area = sf.record(0)['SUB_AREA'] * 1e6 # from shapefile in m2
conversion_mmday2m3s = 1 / (1000 * 24 * 60 * 60)
conversion = conversion_mmday2m3s * area

simulated_discharge = []
while (model.time < model.end_time):
    model.update()
    simulated_discharge.append(
        model.get_value_as_xarray('flux_out_Q')
    )

observations_ds = ewatercycle.observation.grdc.get_grdc_data(
    station_id=6335020,  # Rees, Germany
    start_time=model.start_time_as_isostr,
    end_time=model.end_time_as_isostr,
    column='observation',
)

# Combine the simulated discharge with the observations
sim_da = xr.concat(simulated_discharge, dim='time') * conversion
sim_da.name = 'simulated'
discharge = xr.merge([sim_da, observations_ds["observation"]]).to_dataframe()
discharge = discharge[["observation", "simulated"]].dropna()

ewatercycle.analysis.hydrograph(discharge, reference='observation')

model.finalize()

Citation (CITATION.cff)

# YAML 1.2
---
authors:
  -
    affiliation: "Netherlands eScience Center"
    family-names: Verhoeven
    given-names: Stefan
    orcid: "https://orcid.org/0000-0002-5821-2060"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Drost
    given-names: Niels
    orcid: "https://orcid.org/0000-0001-9795-7981"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Weel
    given-names: Berend
  -
    affiliation: "Netherlands eScience Center"
    family-names: Smeets
    given-names: Stef
    orcid: "https://orcid.org/0000-0002-5413-9038"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Kalverla
    given-names: Peter
    orcid: "https://orcid.org/0000-0002-5025-7862"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Alidoost
    given-names: Fakhereh
    orcid: "https://orcid.org/0000-0001-8407-6472"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Vreede
    given-names: Barbara
    orcid: "https://orcid.org/0000-0002-5023-4601"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Schilperoort
    given-names: Bart
    orcid: "https://orcid.org/0000-0003-4487-9822"
  -
    affiliation: "Delft University of Technology"
    family-names: Hut
    given-names: Rolf
    orcid: "https://orcid.org/0000-0002-5697-5697"
  -
    affiliation: "Delft University of Technology"
    family-names: Aerts
    given-names: Jerom
    orcid: "https://orcid.org/0000-0003-0157-4818"
  -
    affiliation: "Delft University of Technology"
    family-names: Haasnoot
    given-names: David
    orcid: "https://orcid.org/0009-0002-4838-8350"
  -
    affiliation: "Netherlands eScience Center"
    family-names: van Werkhoven
    given-names: Ben
    orcid: "https://orcid.org/0000-0002-7508-3272"
    email: "b.vanwerkhoven@esciencecenter.nl"
  -
    affiliation: "Delft University of Technology"
    family-names: van de Giesen
    given-names: Nick
    orcid: "https://orcid.org/0000-0002-7200-3353"
  -
    affiliation: "Delft University of Technology"
    family-names: Melotto
    given-names: Mark
    orcid: "https://orcid.org/0009-0005-2727-660X"
    email: "markmelotto@tudelft.nl"
cff-version: "1.2.0"
keywords:
  - hydrology
  - bmi
license: "Apache-2.0"
message: "If you use this software, please cite it using these metadata."
repository-code: "https://github.com/eWaterCycle/ewatercycle"
title: eWaterCycle Python package
identifiers:
  - description: Latest version of software
    type: doi
    value: "10.5281/zenodo.5119389"
...

Owner metadata

• Name: eWaterCycle
• Login: eWaterCycle
• Email:
• Kind: organization
• Description:
• Website: http://www.ewatercycle.org
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/12843269?v=4
• Repositories: 74
• Last ynced at: 2024-03-26T20:41:32.902Z
• Profile URL: https://github.com/eWaterCycle

GitHub Events

Total

• Create event: 9
• Release event: 1
• Issues event: 17
• Watch event: 4
• Delete event: 8
• Issue comment event: 71
• Push event: 59
• Pull request review event: 16
• Pull request review comment event: 11
• Pull request event: 17

Last Year

• Create event: 9
• Release event: 1
• Issues event: 16
• Watch event: 3
• Delete event: 8
• Issue comment event: 70
• Push event: 59
• Pull request review event: 16
• Pull request review comment event: 11
• Pull request event: 17

Committers metadata

Last synced: 2 days ago

Committer domains:

• esciencecenter.nl: 5
• tudelft.nl: 1
• gmx.com: 1

Issue and Pull Request metadata

Last synced: 4 days ago

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 243 last-month
• Total dependent packages: 8 (may contain duplicates)
• Total dependent repositories: 0 (may contain duplicates)
• Total versions: 20
• Total maintainers: 5

Dependencies

Score: 12.715296987929191