Skip to content
Anthony Aufdenkampe edited this page Jan 14, 2022 · 10 revisions

Goals for Hydrologic Simulation Program–Python (HSP2)

Author: Jason Love, RESPEC December 20, 2017

Members of the RESPEC team developed the Hydrological Simulation Program - FORTRAN (HSPF) model over 40 years ago, and since that time, it has been used globally to support water-resource planning and management.

The Hydrologic Simulation Program–Python (HSP2) model developed by RESPEC as part of an internally funded research and development (R&D) project uses modern technology to improve upon its predecessor HSPF model. The development of HSP2 results in a model that:

  • retains all pertinent HSPF functionality (currently HSP2 supports the major hydrology modules),
  • provides a migration path for legacy HSPF applications,
  • removes unnecessary static aspects of the model to represent a dynamic world,
  • is independent of operating system and hardware,
  • allows for maintenance and enhancement to occur more readily,
  • and is freely available as an open-source model.

In short, HSP2 improves upon HSPF and ensures that a tool is available to assist in developing watershed-based approaches for protecting and restoring our waterbodies throughout the world.

The Tutorials are written in interactive Jupyter Notebooks (http://jupyter.org/). Jupyter Notebooks allow us to create and and share documents that contain live code, equations, visualizations and narrative text. This capability allows us to efficiently develop reproducible model applications through data cleaning and transformation, numerical simulation with HSP2 and linked models, statistical modeling, data visualization, machine learning, and much more. JupyterLab is the next generation user interface for Project Jupyter and will soon be released. It offers all the familiar building blocks of the classic Jupyter Notebook (notebook, terminal, text editor, file browser, rich outputs, etc.) in a flexible and powerful user inteface that can be extended through third party extensions that access public APIs. This provides a great foundation for future development.

It is anticipated that as we gather user feedback and gain support the remainder of the HSPF model will be converted into HSP2. We believe the flexibility of HSP2 and the ease in which new code can be added will promote a whole new era of code enhancement and model integration. In addition to completing the conversion of the HSPF water quality code, a major need at this point in time is to continue model validation over a larger community of users and diversity of model applications and the development of tools and user interfaces to facilitate the development of HSP2 model applications from scratch. Please review the license agreement and follow the typical process within GitHub for submitting issues, forking the repository, making changes, and issuing pull requests so we can review and integrate changes into the master code.

An introduction to HSP2 video is also available on You Tube at https://youtu.be/aeLScKsP1Wk. For additional HSP2 training or project based work utilizing HSP2 please contact Jason Love Jason.Love@respec.com.

Welcome to the HSP2 Project

Explore the other pages of this Wiki to learn: