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 (http://pandas.pydata.org/) or numpy (http://numpy.scipy.org) for any heavy lifting.
Requirements
hspfbintoolbox - Utility to extract time-series from HSFP binary output files; collected and installed by ‘pip’ or ‘easy_install’ command.
Installation
Should be as easy as running pip install hspf_utils or conda install -c conda-forge 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,detailed,summary,mapping,parameters}
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
layer.
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:
import hspf_utils
# Then you could call the functions
ntsd = hspf_utils.summary("test.hbn", uci="test.uci")
1 maintainer
Metadata
1 maintainer
Release files for hspf-utils 6.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hspf_utils-6.1.3.tar.gz | 17.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hspf_utils-6.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.1 MB
Release files / hspf_utils-6.1.3.tar.gz
| Download URL | hspf_utils-6.1.3.tar.gz |
|---|---|
| Size | 17.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e1e82c960b99e18149ff0f0a1f0174251626421df7b519600b547b6154dbebbf
|
|
BLAKE2b-256 checksum How to use checksums |
d855862febf2aa4c5ad5e9e6bf6a5b66ade00cbaa8263d0903366d9c9b2f19bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 11, 2026.
Transparency logRelease files / hspf_utils-6.1.3-py3-none-any.whl
| Download URL | hspf_utils-6.1.3-py3-none-any.whl |
|---|---|
| Size | 69.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ade97e09626fd90079af8d011f8d5ef20d74800b559d633e0d431d8f102848d4
|
|
BLAKE2b-256 checksum How to use checksums |
a2879dab8b644da0f3b0ab6a07bd99cd7972f2d3d1606bc5ef81bfd941c8834c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 11, 2026.
Transparency log
