CSDMS 2021: Changing Landscapes and Seascapes: Modeling for Discovery, Decision Making, and Communication

Component-based Hydrologic Modeling: Getting Started with the TopoFlow 3.6 Python Package

Scott Peckham

University of Colorado, United States

TopoFlow is a plug-and-play, spatial hydrologic model distributed as an open-source Python package. The current version includes numerous hydrologic process components (all BMI-compliant), an extensive set of utilities for data preparation, river network delineation, visualization and basic calibration, the EMELI model coupling framework, sample data and a set of Jupyter notebooks for learning about the capabilities. The total package consists of around 90,000 lines of efficient code that uses NumPy and runs in Python 3.*. In this clinic, we will first cover some background information, install the package and then work through several Jupyter notebooks to explore the functionality.

Please acknowledge the original contributors when you are using this material. If there are any copyright issues, please let us know ( and we will respond as soon as possible.

Of interest for:
  • Terrestrial Working Group
  • Education and Knowledge Transfer (EKT) Working Group
  • Cyberinformatics and Numerics Working Group
  • Hydrology Focus Research Group
  • Modeling Platform Interoperability Initiative
  • River Network Modeling Initiative