HydroCNHS User Manual

The Hydrological model for Coupled Natural-Human Systems (HydroCNHS) is an open-source Python package supporting four Application Programming Interfaces (APIs) that enable users to integrate their human decision models, which can be programmed with the agent-based modeling (ABM) concept, into the HydroCNHS.

Manual contributors: Chung-Yi Lin & Ali Ghaffari

Contents:

• Installation
• 101 classroom
  • Watershed/Basin
  • Subbasin
  • Semi-distributed hydrological model
  • Rainfall-runoff process modeling
  • Routing & Routing outlets
  • A water system in node-link structure
  • Design a water system with the supporting APIs
• Input/Output
  • Inputs
  • Outputs
  • Daily climate data
  • Model configuration file
  • ABM modules
• Build a hydrological model
  • Step 1: Create a model configuration file
  • Step 2: Complete a model configuration file
  • Step 3: Run a calibration
  • Step 4: Run a simulation
• Integrate an ABM
  • Step 1: Create a model configuration file
  • Step 2: Complete a model configuration file
  • Step 3: Program ABM module (.py)
  • Step 4: Run a calibration
  • Step 5: Run a simulation
• Data collector
• Calibration
  • Calibration with the genetic algorithm (GA)
  • Converter
• Advanced ABM coding tips
  • Enhancing computational speed
  • Logging
• HydroCNHS package
  • HydroCNHS.abm module
  • HydroCNHS.abm_script module
  • HydroCNHS.data_collector module
  • HydroCNHS.hydrocnhs module
  • HydroCNHS.indicators module
  • HydroCNHS.model_builder module
  • HydroCNHS.routing module
  • HydroCNHS.util module
  • HydroCNHS.visual module
  • Module contents
  • Subpackages

How to cite?

Lin, C. Y., Yang, Y. C. E., & Wi S. (2022). HydroCNHS: A Python Package of Hydrological Model for Coupled Natural Human Systems, Journal of Water Resources Planning and Management, 148(12), 6022005.

Related studies

Lin, C. Y., & Yang, Y. E. (2022). The effects of model complexity on model output uncertainty in co-evolved coupled natural-human systems. Earth’s Future, e2021EF002403.

Indices and tables

• Index

• Module Index

• Search Page