Skip to content

TSTool / Command / CopyEnsemble


Overview

The CopyEnsemble command creates a copy of an ensemble, copying all time series in the ensemble and assigning a new identifier to the result. The copy is an exact copy except that the ensemble identifier is different (the TSIDs for each ensemble time series should also specified to be unique).

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.

CopyEnsemble command editor

CopyEnsemble Command Editor (see full-size image)

Command Syntax

The command syntax is as follows:

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

Command Parameters

Parameter                 Description Default                           
EnsembleID
required
The ensemble to copy. None – must be specified.
NewEnsembleID
required
The ensemble identifier for the new ensemble None – must be specified.
NewEnsembleName The name for the new ensemble. Blank.
NewTSID A new time series identifier to assign to time series in the new ensemble. This is useful to avoid confusion with the original time series. Use the Edit button to edit the time series identifier parts. The data interval and sequence number will be determined from the original time series. Copy the original time series TSID.

Examples

See the automated tests.

A sample command file to read a time series from the State of Colorado’s HydroBase database, create an ensemble from the time series, and make a copy is as follows:

# 09019500 - COLORADO RIVER NEAR GRANBY
09019500.USGS.Streamflow.Day~HydroBase
CreateEnsemble(TSID="09019500.USGS.Streamflow.Day",TraceLength=1Year,EnsembleID="Ensemble_1",EnsembleName="Test Ensemble",ReferenceDate="2008-01-01",ShiftDataHow=ShiftToReference)
CopyEnsemble(NewEnsembleID="Ensemble_2",NewEnsembleName="Test ensemble 2",NewTSID="09019500.USGS.Streamflow..copy",EnsembleID="Ensemble_1")

Troubleshooting

See the main TSTool Troubleshooting documentation.

See Also