Skip to main content

Drop-in replacement for TSPROC that is a utility for inverse modeling with PEST.

Project description

Tests Test Coverage Latest release BSD-3 clause license tsblender downloads PyPI - Python Version

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.

This is not complete and is still under development.

TSPROC

TSPROC is a Time Series PROCessor that uses a configuration file to describe the tasks the data scientist or modeler wants to accomplish.

Initial TSPROC development was by John Doherty, Watermark Numerical Computing. It was part of the Surface Water Utilities package that was created to support optimization of model parameters using the Parameter ESTimation (PEST) suite of programs. PEST was also developed by John Doherty.

TSPROC is written in Fortran 90 and “C” and is available from the USGS at:

Main site:

https://wi.water.usgs.gov/models/tsproc/

Documentation:

https://pubs.usgs.gov/tm/tm7c7/

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

This version of tsblender is INCOMPLETE.

The following blocks are only implemented in ‘tsblender’ and not in ‘tsproc’.

TSPROC Block Name

tsproc

tsblender

GET_SERIES_GSFLOW_GAGE

X

GET_SERIES_CSV

X

GET_SERIES_HSPFBIN

X

GET_SERIES_XLSX

X

COPY

X

MOVE

X

PLOT

X

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

The GET_MUL_SERIES_* blocks are redundant in ‘tsblender’ and can be replaced by rolled up versions of the GET_SERIES_* blocks.

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

Project details


Download files

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

Source Distribution

tsblender-103.1.0.tar.gz (78.9 MB view hashes)

Uploaded Source

Built Distribution

tsblender-103.1.0-py3-none-any.whl (30.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page