Metadata-Version: 2.4
Name: hspf_utils
Version: 6.1.1
Summary: Command line script and Python library to develop water balance from HSPF models
Author-email: Tim Cera <tim@cerazone.net>
License: BSD-3-Clause
Project-URL: bitbucket, https://bitbucket.org/timcera/hspf_utils/src/main/
Project-URL: documentation, https://timcera.bitbucket.io/hspf_utils/docs/index.html#hspf_utils-documentation
Project-URL: github, https://github.com/timcera/hspf_utils
Keywords: cli,cli-application,command line,hspf,hydrologic,hydrology,python,script,simulation,time-series
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: cltoolbox>=2.0.0
Requires-Dist: dateparser
Requires-Dist: hspfbintoolbox
Requires-Dist: numpy
Requires-Dist: pandas[excel]
Requires-Dist: pint
Requires-Dist: pint-pandas
Requires-Dist: pydantic
Requires-Dist: scipy
Requires-Dist: tabulate
Requires-Dist: typing-extensions
Dynamic: license-file

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

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

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

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

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

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")
