hspfbintoolbox

A Python script and library of functions to read Hydrological Simulation Program Fortran (HSPF) binary files and print to screen.
https://github.com/timcera/hspfbintoolbox

Category: Hydrosphere
Sub Category: Freshwater and Hydrology

Keywords

cli hydrology python simulation

Keywords from Contributors

data-management watershed storm stormwater stormwater-management-model

Last synced: about 5 hours ago
JSON representation

Repository metadata

Command line script and Python package to read time-series from the Hydrological Simulation Program - FORTRAN (HSPF) binary output.

• Host: GitHub
• URL: https://github.com/timcera/hspfbintoolbox
• Owner: timcera
• License: bsd-3-clause
• Created: 2014-12-14T07:34:53.000Z (almost 12 years ago)
• Default Branch: develop
• Last Pushed: 2026-11-10T00:58:42.000Z (5 days ago)
• Last Synced: 2026-11-14T14:32:59.185Z (about 5 hours ago)
• Topics: cli, hydrology, python, simulation
• Language: Python
• Homepage:
• Size: 16.3 MB
• Stars: 9
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Releases: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE.txt
  • Authors: AUTHORS.rst

README.rst

          .. image:: https://github.com/timcera/hspfbintoolbox/actions/workflows/pypi-package.yml/badge.svg
    :alt: Tests
    :target: https://github.com/timcera/hspfbintoolbox/actions/workflows/pypi-package.yml
    :height: 20

.. image:: https://img.shields.io/coveralls/github/timcera/hspfbintoolbox
    :alt: Test Coverage
    :target: https://coveralls.io/r/timcera/hspfbintoolbox?branch=master
    :height: 20

.. image:: https://img.shields.io/pypi/v/hspfbintoolbox.svg
    :alt: Latest release
    :target: https://pypi.python.org/pypi/hspfbintoolbox/
    :height: 20

.. image:: http://img.shields.io/pypi/l/hspfbintoolbox.svg
    :alt: BSD-3 clause license
    :target: https://pypi.python.org/pypi/hspfbintoolbox/
    :height: 20

.. image:: https://img.shields.io/pypi/pyversions/hspfbintoolbox
    :alt: PyPI - Python Version
    :target: https://pypi.org/project/hspfbintoolbox/
    :height: 20

Documentation for hspfbintoolbox
================================
The ``hspfbintoolbox`` is a Python script and library of functions to read
Hydrological Simulation Program Fortran (HSPF) binary files and print to
screen.  The time series can then be redirected to file, or piped to other
command line programs like ``tstoolbox``.

Requirements
------------

* python 3.10 or later

* tstoolbox - utilities to process time-series

Installation
------------
pip
~~~
.. code-block:: bash

    pip install hspfbintoolbox

conda
~~~~~
.. code-block:: bash

    conda install -c conda-forge hspfbintoolbox


Usage - Command Line
--------------------
Just run 'hspfbintoolbox --help' to get a list of subcommands:

 catalog
          Prints out a catalog of data sets in the binary file.

 extract
          Prints out data to the screen from a HSPF binary output file.

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 hspfbintoolbox::

    import hspfbintoolbox

    # Then you could call the functions
    ntsd = hspfbintoolbox.extract('tests/test.hbn', 'yearly', ',905,,AGWS')

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

        

---

Owner metadata

• Name: Tim Cera
• Login: timcera
• Email: tim@cerazone.net
• Kind: user
• Description: Florida Professional Engineer working in water resources. I program to support data analysis and model simulations.
• Website: https://timcera.bitbucket.io/
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/297142?u=98f35811432817f10222cb6334f64ceef78802b4&v=4
• Repositories: 98
• Last ynced at: 2026-11-09T12:06:18.157Z
• Profile URL: https://github.com/timcera

---

GitHub Events

Total

• Create event: 2
• Delete event: 5
• Issue comment event: 1
• Pull request event: 6
• Push event: 19

Last Year

• Delete event: 2
• Pull request event: 2
• Push event: 10

---

Committers metadata

Last synced: about 19 hours ago

Name	Email	Commits
Tim Cera	t****m@c****t	227
dependabot[bot]	4****]	11
DeepSource Bot	b****t@d****o	2
thomas jobes	t****s@s****m	1
sourcery-ai[bot]	5****]	1
Timothy Cera	t****a@n****v	1
Tim Cera	t****a@s****m	1
Sourcery AI		1

Committer domains:

• sjrwmd.com: 2
• noaa.gov: 1
• deepsource.io: 1
• cerazone.net: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/timcera/hspfbintoolbox

---

---

---

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 230 last-month
• Total dependent packages: 1
• Total dependent repositories: 4
• Total versions: 42
• Total maintainers: 1

---

Dependencies

Score: 9.740497924041666