Skip to main content

Utilities to work with Hydrological Simulation Program - FORTRAN (HSPF) models.

Project description Latest release hspf_utils license

hspf_utils - Quick Guide

The hspf_utils is a command line script and Python library of utilities to work with the Hydrological Simulation Program - FORTRAN (HSPF). Uses pandas ( or numpy ( for any heavy lifting.


  • tstoolbox - Time-series toolbox; collected and installed by ‘pip’ or ‘easy_install’ command.
  • hspfbintoolbox - Utility to extract time-series from HSFP binary output files; collected and installed by ‘pip’ or ‘easy_install’ command.


Should be as easy as running pip install hspf_utils or easy_install hspf_utils at any command line.

Usage - Command Line

Just run ‘hspf_utils –help’ to get a list of subcommands:

usage: hspf_utils [-h] {about,detailed,summary,mapping,parameters} ...

positional arguments:
    about               Display version number and system information.
    detailed            Develops a detailed water balance.
    summary             Develops a summary water balance.
    mapping             Develops a csv file appropriate for joining to a GIS
    parameters          Develops a table of parameter values.

optional arguments:
  -h, --help            show this help message and exit

For the subcommands that output data it is printed to the screen and you can then redirect to a file.

Usage - API

You can use all of the command line subcommands as functions. The function signature is identical to the command line subcommands. The return is always a PANDAS DataFrame. Input can be a CSV or TAB separated file, or a PANDAS DataFrame and is supplied to the function via the ‘input_ts’ keyword.

Simply import hspf_utils:

from hspf_utils import hspf_utils

# Then you could call the functions

# Once you have a PANDAS DataFrame you can use that as input to other
# hspf_utils functions.
ntsd = hspf_utils.aggregate(statistic='mean', agg_interval='daily', input_ts=ntsd)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for hspf-utils, version 5.1.1
Filename, size File type Python version Upload date Hashes
Filename, size hspf_utils-5.1.1.tar.gz (12.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page