Skip to content

TSTool / Command / SetPropertyFromTimeSeries


Overview

The SetPropertyFromTimeSeries command sets the value of a processor property, using time series properties as input. The property will be available to subsequent commands that support using ${Property} notation in parameters, for example to specify filenames more dynamically or use with If commands. This command should not be confused with the SetTimeSeriesProperty command, which sets a property on specific time series. Parameters are provided to select the time series; however, currently, the property name cannot be dynamically changed (for example by using ${Property} for the property name).

Command Editor

The command is available in the following TSTool menu:

  • Commands / General - Running and Properties

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

SetPropertyFromTimeSeries command editor

SetPropertyFromTimeSeries Command Editor (see full-size image)

Command Syntax

The command syntax is as follows:

SetPropertyFromTimeSeries(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 modified.
  • AllTS – all time series before the command.
  • EnsembleID – all time series in the ensemble will be modified.
  • FirstMatchingTSID – the first time series that matches the TSID (single TSID or TSID with wildcards) will be modified.
  • LastMatchingTSID – the last time series that matches the TSID (single TSID or TSID with wildcards) will be modified.
  • SelectedTS – the time series are those selected with the SelectTimeSeries command.
AllTS
TSID The time series identifier or alias for the time series to process, using the * wildcard character to match multiple time series. Can be specified using processor ${Property}. Required if TSList=*TSID
EnsembleID The ensemble to be modified, if processing an ensemble. Can be specified using processor ${Property}. Required if
TSList= EnsembleID
PropertyName
required
The property name. None – must be specified.
PropertyValue
required
The value of the property, set using a combination of text, the time series % specifiers, ${ts:Property} for custom time series properties, and ${Property}. None – must be specified.

Examples

See the automated tests.

Troubleshooting

See the main TSTool Troubleshooting documentation.

See Also