.. image:: https://github.com/timcera/tsblender/actions/workflows/pypi-package.yml/badge.svg
:alt: Tests
:target: https://github.com/timcera/tsblender/actions/workflows/pypi-package.yml
:height: 20
.. image:: https://img.shields.io/coveralls/github/timcera/tsblender
:alt: Test Coverage
:target: https://coveralls.io/r/timcera/tsblender?branch=master
:height: 20
.. image:: https://img.shields.io/pypi/v/tsblender.svg
:alt: Latest release
:target: https://pypi.python.org/pypi/tsblender/
:height: 20
.. image:: https://img.shields.io/pypi/l/tsblender.svg
:alt: BSD-3 clause license
:target: https://pypi.python.org/pypi/tsblender/
:height: 20
.. image:: https://img.shields.io/pypi/dd/tsblender.svg
:alt: tsblender downloads
:target: https://pypi.python.org/pypi/tsblender/
:height: 20
.. image:: https://img.shields.io/pypi/pyversions/tsblender
:alt: PyPI - Python Version
:target: https://pypi.org/project/tsblender/
:height: 20
tsblender - Quick Guide
=======================
The tsblender is a pure python re-write of the Time Series PROCessor (TSPROC).
When finished it will be a superset of TSPROC functionality and a more robust
and flexible tool for time series analysis.
The tsblender is almost a drop-in replacement for TSPROC. It is currently
a super-set of TSPROC functionality, while missing only the DIGITAL_FILTER and
MOVING_MINIMUM processing blocks. Existing TSPROC control and input files can
be used without modification except as noted previously.
The documentation for TSPROC can be used to understand tsblender and build the
control and input files. The TSPROC documentation is available at:
https://pubs.usgs.gov/tm/tm7c7/
The tsblender works with PEST, PEST++, and PEST-HP suites of programs. These
are used to optimize model parameters and to perform uncertainty analysis on
model predictions. Information on PEST and related programs can be found at:
http://www.pesthomepage.org/ and https://github.com/usgs/pestpp.
USGS TSPROC
-----------
The USGS TSPROC is a Time Series PROCessor that uses a configuration file to
describe the tasks the data scientist or modeler wants to accomplish.
The USGS TSPROC is based upon part of the Surface Water Utilities Package
developed by John Doherty, Watermark Numerical Computing. The Surface Water
Utilities package was created to support optimization of model parameters using
the Parameter ESTimation (PEST) suite of programs. PEST was also developed by
John Doherty.
USGS TSPROC was rewritten in a project led by Steve Westenbroek, of the
Wisconsin USGS. It is written in Fortran 90 and "C" and is available from
the USGS at:
:TSPROC Main site: https://wi.water.usgs.gov/models/tsproc/
:TSPROC Documentation: https://pubs.usgs.gov/tm/tm7c7/
:TSPROC Development: https://github.com/smwesten-usgs/tsproc
Requirements
------------
* python 3.8 or higher
Installation
------------
Should be as easy as running ``pip install tsblender`` or ``conda install -c
conda-forge -c timcera tsblender`` at any command line.
Usage - Command Line
--------------------
Just run 'tsblender --help' to get a list of subcommands::
usage: tsblender [-h]
{run, about) ...
positional arguments:
{run, about}
about
Display version number and system information.
run
Run a tsblender script file.
optional arguments:
-h, --help show this help message and exit
Progress
========
ONLY in tsblender
-----------------
+------------------------+
| tsblender Block Name |
+========================+
| GET_SERIES_GSFLOW_GAGE |
+------------------------+
| GET_SERIES_CSV |
+------------------------+
| GET_SERIES_HSPFBIN |
+------------------------+
| GET_SERIES_XLSX |
+------------------------+
| COPY |
+------------------------+
| MOVE |
+------------------------+
| PLOT |
+------------------------+
There is a new feature in tsblender to "roll up" multiple blocks into a single
block. This is done to simplify the control file, to reduce mistakes that can
come from repetition, and to make the control file easier to read and
understand. Not all blocks can be rolled up depending on how they are
configured. The blocks that can't be rolled up are: EXCEEDENCE_TIME,
FLOW_DURATION, GET_MUL_*, HYDROLOGIC_INDICES, LIST_OUTPUT, PLOT, SETTINGS, and
WRITE_PEST_FILES.
Rolled up example of GET_SERIES_WDM::
START GET_SERIES_WDM
CONTEXT input
NEW_SERIES_NAME obs01 sim01
FILE obs.wdm sim.wdm
DSN 1001
DATE_1 2000-01-01
DATE_2 2000-12-31
END GET_SERIES_WDM
Would un-roll within tsblender to the following::
START GET_SERIES_WDM
CONTEXT input
NEW_SERIES_NAME obs01
FILE obs.wdm
DSN 1001
DATE_1 2000-01-01
DATE_2 2000-12-31
END GET_SERIES_WDM
START GET_SERIES_WDM
CONTEXT input
NEW_SERIES_NAME sim01
FILE sim.wdm
DSN 1001
DATE_1 2000-01-01
DATE_2 2000-12-31
END GET_SERIES_WDM
In Progress
-----------
The following table shows the progress of the implementation of the TSPROC
blocks in 'tsblender'.
+------------------------+--------+-----------+
| TSPROC Block Name | tsproc | tsblender |
+========================+========+===========+
| DIGITAL_FILTER | X | |
+------------------------+--------+-----------+
| ERASE_ENTITY | X | X |
+------------------------+--------+-----------+
| EXCEEDENCE_TIME | X | X |
+------------------------+--------+-----------+
| FLOW_DURATION | X | X |
+------------------------+--------+-----------+
| GET_SERIES_SSF | X | X |
+------------------------+--------+-----------+
| GET_SERIES_STATVAR | X | X |
+------------------------+--------+-----------+
| GET_SERIES_PLOTGEN | X | X |
+------------------------+--------+-----------+
| GET_SERIES_TETRAD | X | |
+------------------------+--------+-----------+
| GET_SERIES_UFORE_HYDRO | X | X |
+------------------------+--------+-----------+
| GET_SERIES_WDM | X | X |
+------------------------+--------+-----------+
| HYDRO_EVENTS | X | X |
+------------------------+--------+-----------+
| HYDRO_PEAKS | X | |
+------------------------+--------+-----------+
| HYDROLOGIC_INDICES | X | X |
+------------------------+--------+-----------+
| LIST_OUTPUT | X | X |
+------------------------+--------+-----------+
| MOVING_MINIMUM | X | |
+------------------------+--------+-----------+
| NEW_SERIES_UNIFORM | X | X |
+------------------------+--------+-----------+
| NEW_TIME_BASE | X | X |
+------------------------+--------+-----------+
| PERIOD_STATISTICS | X | X |
+------------------------+--------+-----------+
| REDUCE_TIME_SPAN | X | X |
+------------------------+--------+-----------+
| SERIES_BASE_LEVEL | X | X |
+------------------------+--------+-----------+
| SERIES_CLEAN | X | X |
+------------------------+--------+-----------+
| SERIES_COMPARE | X | X |
+------------------------+--------+-----------+
| SERIES_DIFFERENCE | X | X |
+------------------------+--------+-----------+
| SERIES_DISPLACE | X | X |
+------------------------+--------+-----------+
| SERIES_EQUATION | X | X |
+------------------------+--------+-----------+
| SERIES_STATISTICS | X | X |
+------------------------+--------+-----------+
| SETTINGS | X | X |
+------------------------+--------+-----------+
| USGS_HYSEP | X | X |
+------------------------+--------+-----------+
| V_TABLE_TO_SERIES | X | X |
+------------------------+--------+-----------+
| VOLUME_CALCULATION | X | X |
+------------------------+--------+-----------+
| WRITE_PEST_FILES | X | X |
+------------------------+--------+-----------+
Deprecated in tsblender
-----------------------
The GET_MUL_SERIES_* blocks are redundant in 'tsblender' and can be replaced by
rolled up versions of the GET_SERIES_* blocks. They are implemented full in
tsblender, but discouraged for use in new scripts.
+----------------------------+--------+-----------+
| TSPROC Block Name | tsproc | tsblender |
+============================+========+===========+
| GET_MUL_SERIES_GSFLOW_GAGE | X | X |
+----------------------------+--------+-----------+
| GET_MUL_SERIES_PLOTGEN | X | X |
+----------------------------+--------+-----------+
| GET_MUL_SERIES_SSF | X | X |
+----------------------------+--------+-----------+
| GET_MUL_SERIES_STATVAR | X | X |
+----------------------------+--------+-----------+
Raw data
{
"_id": null,
"home_page": null,
"name": "tsblender",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "baseflow, cli-app, hydrology, parameter-estimation, python, time-series, tsproc",
"author": null,
"author_email": "Tim Cera <tim@cerazone.net>",
"download_url": "https://files.pythonhosted.org/packages/10/cc/da0dd7eeecf721d23626e3e6e4245cc301660e9e490e8689fca088f20781/tsblender-103.2.1.tar.gz",
"platform": null,
"description": ".. image:: https://github.com/timcera/tsblender/actions/workflows/pypi-package.yml/badge.svg\n :alt: Tests\n :target: https://github.com/timcera/tsblender/actions/workflows/pypi-package.yml\n :height: 20\n\n.. image:: https://img.shields.io/coveralls/github/timcera/tsblender\n :alt: Test Coverage\n :target: https://coveralls.io/r/timcera/tsblender?branch=master\n :height: 20\n\n.. image:: https://img.shields.io/pypi/v/tsblender.svg\n :alt: Latest release\n :target: https://pypi.python.org/pypi/tsblender/\n :height: 20\n\n.. image:: https://img.shields.io/pypi/l/tsblender.svg\n :alt: BSD-3 clause license\n :target: https://pypi.python.org/pypi/tsblender/\n :height: 20\n\n.. image:: https://img.shields.io/pypi/dd/tsblender.svg\n :alt: tsblender downloads\n :target: https://pypi.python.org/pypi/tsblender/\n :height: 20\n\n.. image:: https://img.shields.io/pypi/pyversions/tsblender\n :alt: PyPI - Python Version\n :target: https://pypi.org/project/tsblender/\n :height: 20\n\ntsblender - Quick Guide\n=======================\nThe tsblender is a pure python re-write of the Time Series PROCessor (TSPROC).\nWhen finished it will be a superset of TSPROC functionality and a more robust\nand flexible tool for time series analysis.\n\nThe tsblender is almost a drop-in replacement for TSPROC. It is currently\na super-set of TSPROC functionality, while missing only the DIGITAL_FILTER and\nMOVING_MINIMUM processing blocks. Existing TSPROC control and input files can\nbe used without modification except as noted previously.\n\nThe documentation for TSPROC can be used to understand tsblender and build the\ncontrol and input files. The TSPROC documentation is available at:\nhttps://pubs.usgs.gov/tm/tm7c7/\n\nThe tsblender works with PEST, PEST++, and PEST-HP suites of programs. These\nare used to optimize model parameters and to perform uncertainty analysis on\nmodel predictions. Information on PEST and related programs can be found at:\nhttp://www.pesthomepage.org/ and https://github.com/usgs/pestpp.\n\nUSGS TSPROC\n-----------\nThe USGS TSPROC is a Time Series PROCessor that uses a configuration file to\ndescribe the tasks the data scientist or modeler wants to accomplish.\n\nThe USGS TSPROC is based upon part of the Surface Water Utilities Package\ndeveloped by John Doherty, Watermark Numerical Computing. The Surface Water\nUtilities package was created to support optimization of model parameters using\nthe Parameter ESTimation (PEST) suite of programs. PEST was also developed by\nJohn Doherty.\n\nUSGS TSPROC was rewritten in a project led by Steve Westenbroek, of the\nWisconsin USGS. It is written in Fortran 90 and \"C\" and is available from\nthe USGS at:\n\n:TSPROC Main site: https://wi.water.usgs.gov/models/tsproc/\n:TSPROC Documentation: https://pubs.usgs.gov/tm/tm7c7/\n:TSPROC Development: https://github.com/smwesten-usgs/tsproc\n\nRequirements\n------------\n* python 3.8 or higher\n\nInstallation\n------------\nShould be as easy as running ``pip install tsblender`` or ``conda install -c\nconda-forge -c timcera tsblender`` at any command line.\n\nUsage - Command Line\n--------------------\nJust run 'tsblender --help' to get a list of subcommands::\n\n\n usage: tsblender [-h]\n {run, about) ...\n\n positional arguments:\n {run, about}\n\n about\n Display version number and system information.\n run\n Run a tsblender script file.\n\n optional arguments:\n -h, --help show this help message and exit\n\nProgress\n========\nONLY in tsblender\n-----------------\n\n +------------------------+\n | tsblender Block Name |\n +========================+\n | GET_SERIES_GSFLOW_GAGE |\n +------------------------+\n | GET_SERIES_CSV |\n +------------------------+\n | GET_SERIES_HSPFBIN |\n +------------------------+\n | GET_SERIES_XLSX |\n +------------------------+\n | COPY |\n +------------------------+\n | MOVE |\n +------------------------+\n | PLOT |\n +------------------------+\n\nThere is a new feature in tsblender to \"roll up\" multiple blocks into a single\nblock. This is done to simplify the control file, to reduce mistakes that can\ncome from repetition, and to make the control file easier to read and\nunderstand. Not all blocks can be rolled up depending on how they are\nconfigured. The blocks that can't be rolled up are: EXCEEDENCE_TIME,\nFLOW_DURATION, GET_MUL_*, HYDROLOGIC_INDICES, LIST_OUTPUT, PLOT, SETTINGS, and\nWRITE_PEST_FILES.\n\nRolled up example of GET_SERIES_WDM::\n\n START GET_SERIES_WDM\n CONTEXT input\n NEW_SERIES_NAME obs01 sim01\n FILE obs.wdm sim.wdm\n DSN 1001\n DATE_1 2000-01-01\n DATE_2 2000-12-31\n END GET_SERIES_WDM\n\nWould un-roll within tsblender to the following::\n\n START GET_SERIES_WDM\n CONTEXT input\n NEW_SERIES_NAME obs01\n FILE obs.wdm\n DSN 1001\n DATE_1 2000-01-01\n DATE_2 2000-12-31\n END GET_SERIES_WDM\n\n START GET_SERIES_WDM\n CONTEXT input\n NEW_SERIES_NAME sim01\n FILE sim.wdm\n DSN 1001\n DATE_1 2000-01-01\n DATE_2 2000-12-31\n END GET_SERIES_WDM\n\nIn Progress\n-----------\nThe following table shows the progress of the implementation of the TSPROC\nblocks in 'tsblender'.\n\n +------------------------+--------+-----------+\n | TSPROC Block Name | tsproc | tsblender |\n +========================+========+===========+\n | DIGITAL_FILTER | X | |\n +------------------------+--------+-----------+\n | ERASE_ENTITY | X | X |\n +------------------------+--------+-----------+\n | EXCEEDENCE_TIME | X | X |\n +------------------------+--------+-----------+\n | FLOW_DURATION | X | X |\n +------------------------+--------+-----------+\n | GET_SERIES_SSF | X | X |\n +------------------------+--------+-----------+\n | GET_SERIES_STATVAR | X | X |\n +------------------------+--------+-----------+\n | GET_SERIES_PLOTGEN | X | X |\n +------------------------+--------+-----------+\n | GET_SERIES_TETRAD | X | |\n +------------------------+--------+-----------+\n | GET_SERIES_UFORE_HYDRO | X | X |\n +------------------------+--------+-----------+\n | GET_SERIES_WDM | X | X |\n +------------------------+--------+-----------+\n | HYDRO_EVENTS | X | X |\n +------------------------+--------+-----------+\n | HYDRO_PEAKS | X | |\n +------------------------+--------+-----------+\n | HYDROLOGIC_INDICES | X | X |\n +------------------------+--------+-----------+\n | LIST_OUTPUT | X | X |\n +------------------------+--------+-----------+\n | MOVING_MINIMUM | X | |\n +------------------------+--------+-----------+\n | NEW_SERIES_UNIFORM | X | X |\n +------------------------+--------+-----------+\n | NEW_TIME_BASE | X | X |\n +------------------------+--------+-----------+\n | PERIOD_STATISTICS | X | X |\n +------------------------+--------+-----------+\n | REDUCE_TIME_SPAN | X | X |\n +------------------------+--------+-----------+\n | SERIES_BASE_LEVEL | X | X |\n +------------------------+--------+-----------+\n | SERIES_CLEAN | X | X |\n +------------------------+--------+-----------+\n | SERIES_COMPARE | X | X |\n +------------------------+--------+-----------+\n | SERIES_DIFFERENCE | X | X |\n +------------------------+--------+-----------+\n | SERIES_DISPLACE | X | X |\n +------------------------+--------+-----------+\n | SERIES_EQUATION | X | X |\n +------------------------+--------+-----------+\n | SERIES_STATISTICS | X | X |\n +------------------------+--------+-----------+\n | SETTINGS | X | X |\n +------------------------+--------+-----------+\n | USGS_HYSEP | X | X |\n +------------------------+--------+-----------+\n | V_TABLE_TO_SERIES | X | X |\n +------------------------+--------+-----------+\n | VOLUME_CALCULATION | X | X |\n +------------------------+--------+-----------+\n | WRITE_PEST_FILES | X | X |\n +------------------------+--------+-----------+\n\nDeprecated in tsblender\n-----------------------\nThe GET_MUL_SERIES_* blocks are redundant in 'tsblender' and can be replaced by\nrolled up versions of the GET_SERIES_* blocks. They are implemented full in\ntsblender, but discouraged for use in new scripts.\n\n +----------------------------+--------+-----------+\n | TSPROC Block Name | tsproc | tsblender |\n +============================+========+===========+\n | GET_MUL_SERIES_GSFLOW_GAGE | X | X |\n +----------------------------+--------+-----------+\n | GET_MUL_SERIES_PLOTGEN | X | X |\n +----------------------------+--------+-----------+\n | GET_MUL_SERIES_SSF | X | X |\n +----------------------------+--------+-----------+\n | GET_MUL_SERIES_STATVAR | X | X |\n +----------------------------+--------+-----------+\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Drop-in replacement for TSPROC that is a utility for inverse modeling with PEST.",
"version": "103.2.1",
"project_urls": {
"bitbucket": "https://bitbucket.org/timcera/tsblender/src/main/",
"documentation": "https://timcera.bitbucket.io/tsblender/docs/index.html#tsblender-documentation",
"github": "https://github.com/timcera/tsblender"
},
"split_keywords": [
"baseflow",
" cli-app",
" hydrology",
" parameter-estimation",
" python",
" time-series",
" tsproc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e49c66b0617a9f727c8d3592533420ad749f2771346468c4e8b1baf287922cf1",
"md5": "d638f1ba7174ef1e0127c97da6d8fa4d",
"sha256": "ff7ecc55ecb0edc21baf8e262eef85cbb4616c245c413a3466707e0859a99199"
},
"downloads": -1,
"filename": "tsblender-103.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d638f1ba7174ef1e0127c97da6d8fa4d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 92958,
"upload_time": "2024-06-24T06:18:57",
"upload_time_iso_8601": "2024-06-24T06:18:57.039141Z",
"url": "https://files.pythonhosted.org/packages/e4/9c/66b0617a9f727c8d3592533420ad749f2771346468c4e8b1baf287922cf1/tsblender-103.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "10ccda0dd7eeecf721d23626e3e6e4245cc301660e9e490e8689fca088f20781",
"md5": "3ccd4613d3628cc1120535ca0b3ab99c",
"sha256": "8dc4d97a8d4ff3e56d7faa2d8cf4edcb312cf9b1cff7637871153d50e4a42b2a"
},
"downloads": -1,
"filename": "tsblender-103.2.1.tar.gz",
"has_sig": false,
"md5_digest": "3ccd4613d3628cc1120535ca0b3ab99c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 79259881,
"upload_time": "2024-06-24T06:19:01",
"upload_time_iso_8601": "2024-06-24T06:19:01.577301Z",
"url": "https://files.pythonhosted.org/packages/10/cc/da0dd7eeecf721d23626e3e6e4245cc301660e9e490e8689fca088f20781/tsblender-103.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-24 06:19:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "timcera",
"github_project": "tsblender",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tsblender"
}
JSON
