TSTool / Command / NewEnsemble
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.
The following dialog is used to edit the command and illustrates the syntax of the command.
NewEnsemble Command Editor (see also the full-size image)
The command syntax is as follows:
||Indicates the list of time series to be processed, one of:
||The time series identifier or alias for the time series to be processed, using the
||The ensemble to be processed, if processing an ensemble. Can be specified using
|The new ensemble identifier. Can be specified using
||None – must be specified.|
||The name for the new ensemble. Can be specified using
||The date/time to start transferring data from the time series. Envisioned as future enhancement. Can be specified using
||Use all data.|
||The date/time to end transferring data from the time series. Envisioned as future enhancement. Can be specified using
||Use all data.|
||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.|
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")