Lumped Models (LuMod) for Hydrology

LuMod is an easy to use set of Lumped Models for hydrological simulation in Python language.

Compared with other source codes that pretend to be fast, LuMod was created to facilitate the modeling and the results processing. Moreover, some features of LuMod are compiled with numba to increase simulation speed.

Documentation

Full documentation and examples are available here: LuMod-Docs

Installation is available from PyPI: LuMod project

If you are not familiar with Python, try our Web Application: LuMod-App

Key Features

LuMod incorporates well know hydrological models with different structures:

• MILC: One layer Lumped version of the MISDc model adapted for continous daily simulation.
• HYMOD: Rainfall-Runoff Model based on the Probability-Distributed Model concept that runs at daily timestep.
• HBV: Modified version of the Hydrologiska Byråns Vattenbalansavdelning (HBV) model.
• GR4J: Well known daily rain-runoff model that depends of four parameters.
• GR2M: Monthly rain-runoff model that depends of two parameters.
• GR1A: One parameter annual rain-runoff model.
• MonteCarlo: Random-based simulation for parameters optimization and uncertainty analysis.

Quick installation

The easier way to install LuMod is using PyPI:

pip install lumod

Basic Example

LuMod was thought to be easy to use and compatible with libraries dedicated to DataScience, so it works with Pandas and Matplotlib to facilitate the analysis of simulations.

# Import modules
import lumod
from lumod import tools

# Load example data
info, forcings = lumod.load_example(2)

# Create a model
parameters = {"x1": 500, "x3": 200}  # define some parameters
model = lumod.models.GR4J(area=info.area, lat=info.lat, params=parameters)
print(model)

# Run your model
simulations = model.run(forcings, x2=3.0) # modify parameter x2 before start

# Validate your model
tools.plots.model_evaluation(forcings.prec, forcings.qt, simulations.qt)

Citation

Coming Soon

Author

Main Developer

Saúl Arciniega Esparza, Ph.D., Full Time Associate Professor at the Faculty of Engineering at the National Autonomous University of Mexico, working on the Hydrogeology Group.

LinkedIn | Twitter | ResearchGate

Collaborators

Christian Birkel, Ph.D., Full Time Professor and Researcher at the Departament of Geography at University of Costa Rica, and leader of the Observatory of Water and Global Change (OACG).

Facebook | ResearchGate

Acknowledgments

Funding

The National Council of Science and Technology (CONACYT), the Leverhulme Trust and the German Academic Exchange Service (DAAD) are thanked for partial funding of this work.