TSTool / Command / Blend

Overview
Command Editor
Command Syntax
Examples
Troubleshooting
See Also

Overview

The Blend command blends one time series into another, extending the first time series period if necessary. This is typically used for combining time series for a station that has been renamed or to blend historic and real-time data. The second (independent time series) will ALWAYS override the first time series. See also the SetFromTS and Add commands. The Blend command ensures that single data values are used whereas Add will add values if more than one value is available at the same date/time. The SetFromTS does not extend the period.

Command Editor

The command is available in the following TSTool menu:

Commands / Manipulate Time Series

The following dialog is used to edit the command and illustrates the syntax of the command.

Blend Command Editor (see full-size image)

Command Syntax

The command syntax is as follows:

Blend(Parameter="Value",...)

Command Parameters

Parameter	Description	Default
`TSID` required	The time series identifier or alias for the time series to be modified.	None – must be specified.
`IndependentTSID` required	The time series identifier or alias for the time series to be blended to the first time series.	None – must be specified.
`BlendMethod`	The method used to blend the data, one of: `BlendAtEnd` - the main time series will have the other time series attached to the end of its period.	None – must be specified. Currently only `BlendAtEnd` is recognized.

Examples

See the automated tests.

A sample command file to blend two time series from the State of Colorado’s HydroBase database is as follows:

# 08236000 - ALAMOSA RIVER ABOVE TERRACE RESERVOIR
08236000.DWR.Streamflow.Month~HydroBase
# 08236500 - ALAMOSA RIVER BELOW TERRACE RESERVOIR
08236500.DWR.Streamflow.Month~HydroBase
Blend(TSID=”08236000.DWR.Streamflow.Month”,IndependentTSID=”08236500.DWR.Streamflow.Month”,BlendMethod=”BlendAtEnd”)

Troubleshooting

See the main TSTool Troubleshooting documentation.