Skip to content

TSTool / Command / NewPatternTimeSeries


Overview

The NewPatternTimeSeries command creates a new time series containing a repeating pattern of numbers. This command is useful for generating data to test other commands.

Command Editor

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

NewPatternTimeSeries

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

Command Syntax

The command syntax is as follows:

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

The following older command syntax is updated to the above syntax when a command file is read:

TS Alias = NewPatternTimeSeries(Parameter=Value,…)

Command Parameters

Parameter                    Description Default                           
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). Can be specified using processor ${Property}. None – must be specified.
NewTSID
required
The time series identifier to be assigned to the new time series, which is useful to avoid confusion with the original time series. Can be specified using processor ${Property}. None – must be specified.
IrregularInterval Interval to use to populate irregular time series (e.g., 1Hour, Month), necessary because data need to be assigned somehow. None – must be specified for irregular time series.
Description Description for the time series. Can be specified using processor ${Property}. None.
SetStart
required
Start date/time to set data. Can be specified using processor ${Property}. None – must be specified.
SetEnd
required
End date/time to set data. Can be specified using processor ${Property}. None – must be specified.
Units Units for the data values. Can be specified using processor ${Property}. None.
MissingValue Value to use to indicate missing data values. -999 is the default for historical reasons; however, NaN (not a number) is being phased in and should be specified if possible. Time series can be missing and be flagged. Can be specified using processor ${Property}. -999
PatternValues
required
Data values, separated by commas. Missing values can be omitted (e.g., indicate with adjacent commas). None – must be specified.
PatternFlags Short strings to assign to the values (used to annotate graphs and other output) separated by commas. Missing flags can be omitted (e.g., indicate with adjacent commas). No flags are assigned.

Examples

See the automated tests.

The following example command file illustrates how to create a pattern time series for testing:

NewPatternTimeSeries(Alias=”ts1”,NewTSID="ts1..Streamflow.Day",Description="Test data",SetStart="1950-01-01",SetEnd="1951-03-12",Units="CFS",PatternValues="5,10,12,13,75")
WriteDateValue(OutputFile=",Example_NewPatternTimeSeries_out.dv")

Troubleshooting

See Also