TSTool / Command / WeightTraces

Overview
Command Editor
Command Syntax
Examples
Troubleshooting
See Also

Overview

The WeightTraces command creates a new time series as a weighted sum of time series ensemble traces, for example as produced by a CreateEnsembleFromOneTimeSeries command. If any trace contains missing data for a point, the resulting time series value will also be missing. Note that this approach may not be appropriate for some analyses – the user should evaluate the implications of whether the weighted result appropriately reflects the (in)dependence of input data.

Command Editor

The command is available in the following TSTool menu:

Commands / Ensemble Processing

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

WeightTraces Command Editor (see also the full-size image)

Command Syntax

The command syntax is as follows:

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

Command Parameters

Parameter	Description	Default
`EnsembleID` required	The ensemble identifier indicating time series to be processed (e.g., from a `CreateEnsembleFromOneTimeSeries` command). Time series matching the years specified by the Weights parameter will be processed.	None – must be specified.
`NewTSID` required	The time series identifier for the new time series that is created. This typically uses the same information as the original time series, with an added scenario.	None – must be specified.
`Alias` required	The alias to assign to the time series, as a literal string or using the special formatting characters listed by the command editor. The alias is a short identifier used by other commands to locate time series for processing, as an alternative to the time series identifier (TSID).	None – must be specified.
`SpecifyWeightsHow`	Weights are currently only applied as AbsoluteWeights (in the future an option may be added to normalized weights to 1.0 accounting for missing data in the traces).	Must be `AbsoluteWeights`.
`Weights` required	Specify pairs of trace year and weights (0-1.0), used to create the new time series. Trace years must be manually entered because at the time that the command is edited, time series have not yet been queried. The weights do not need to add to 1. Example data are: `1995,.5,1998,.3,2005,.2`	None – must be specified.

Examples

See the automated tests.

A sample commands file is as follows:

# Create annual traces from a time series shifted to the current year
# The original time series is read from HydroBase
# 
# (1995-1998) ALAMOSA RIVER ABOVE JASPER, CO  USGS  Streamflow  Day
08235350.USGS.Streamflow.Day~HydroBase
CreateEnsemble(TSID="08235350.USGS.Streamflow.Day",TraceLength=1Year,EnsembleID="Ensemble_Jasper",EnsembleName="ALAMOSA RIVER ABOVE JASPER, CO",ReferenceDate="2008-01-01",ShiftDataHow=ShiftToReference)
WeightTraces(Alias=”WeightedTS”,EnsembleID="Ensemble_Jasper",SpecifyWeightsHow="AbsoluteWeights",Weights="1997,.5,1998,.4,1999,.1",NewTSID="08235350.USGS.Streamflow.Day.weighted")
WriteDateValue(OutputFile="Results/WeightTraces_out.dv")

The results from the commands are shown in the following graph:

Results of the WeightTraces Command (see also the full-size image)

Troubleshooting

See the main TSTool Troubleshooting documentation.