Skip to content

TSTool / Command / NewEnsemble

Overview

The NewEnsemble command creates a new ensemble and optionally inserts 1+ existing time series. For example, use the command to create an ensemble that includes multiple scenarios. Although it is typical that an ensemble contains time series at the same location, it is also possible to use ensembles to group time series at different locations (e.g., to group all time series for stations in a county).

It is envisioned that time series added to the ensemble can optionally be copied and the period changed, in order to isolate the data from the original time series. However, currently the time series from the main processor list are simply associated with the ensemble. Consequently, if other commands change the time series (for example free the time series), the ensemble will reflect the changes. Overcoming this issue will require design changes that need to be evaluated.

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.

NewEnsemble command editor

NewEnsemble Command Editor (see full-size image)

Command Syntax

The command syntax is as follows:

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

Command Parameters

Parameter                Description Default                           
TSList Indicates the list of time series to be processed, one of:
  • AllMatchingTSID – all time series that match the TSID (single TSID or TSID with wildcards) will be processed.
  • AllTS – all time series before the command.
  • EnsembleID – all time series in the ensemble will be processed (see the EnsembleID parameter).
  • FirstMatchingTSID – the first time series that matches the TSID (single TSID or TSID with wildcards) will be processed.
  • LastMatchingTSID – the last time series that matches the TSID (single TSID or TSID with wildcards) will be processed.
  • SelectedTS – the time series are those selected with the SelectTimeSeries command.
 AllTS
TSID The time series identifier or alias for the time series to be processed, using the * wildcard character to match multiple time series. Can be specified using ${Property}. Required if TSList=*TSID
EnsembleID The ensemble to be processed, if processing an ensemble. Can be specified using ${Property}. Required if TSList=*EnsembleID
NewEnsembleID
required		 The new ensemble identifier. Can be specified using ${Property}. None – must be specified.
NewEnsembleName The name for the new ensemble. Can be specified using ${Property}. Blank.
InputStart The date/time to start transferring data from the time series. Envisioned as future enhancement. Can be specified using ${Property}. Use all data.
InputEnd The date/time to end transferring data from the time series. Envisioned as future enhancement. Can be specified using ${Property}. Use all data.
CopyTimeSeries Copy the time series to the ensemble rather than using time series in the main time series list. This protects the data in the ensemble from general processing commands. Envisioned as future enhancement. Associate time series in the main time series list with the new ensemble.

Examples

See the automated tests.

A sample command file to create an ensemble from user-defined time series is as follows:

# Test creating an ensemble from year interval time series
NewPatternTimeSeries(Alias=”ts1”,NewTSID="ts1..Flow.Year",SetStart="1960",SetEnd="2000",Units="ACFT",PatternValues="1,2,5,8,,20")
NewPatternTimeSeries(Alias=”ts2”,NewTSID="ts2..Flow.Year",SetStart="1950",SetEnd="2005",Units="ACFT",PatternValues="2,4,10,16,,40")
NewEnsemble(TSList=AllTS,NewEnsembleID="TestEnsemble",NewEnsembleName="Test Ensemble")

Troubleshooting

See the main TSTool Troubleshooting documentation.

See Also