TSTool_User_09-09-00 - Laserfiche WebLink

TSTool Documentation commands using the steps described below. This section describes in detail the processing sequence. See the examples in Chapter 6 — Examples of Use for illustrations of the processing sequence. Note that older versions of TSTool (before version 5.xx.xx) did not allow multi -step manipulation and therefore time series were read and manipulated in one step. This convention had limitations and has been changed to allow multi -step operations on time series, allowing more options for filling and manipulation. Old command files are supported as much as possible but some updates to old command files may be required. TSTool commands fall into three main categories: Time series identifiers (see Section 2.1 — Time Series Objects and Identifiers), which are equivalent to time series "read" commands (where the identifier input type is used to determine which read command to use), General commands, which are used to set properties like the period for output, and, Time series commands, which are used to read and manipulate time series and output results. Commands are processed sequentially and can be repeated as necessary. A typical user starts learning TSTool by performing simple queries and displaying results while gradually utilizing more commands. The current software uses command syntax as follows: Command(Paraml= Valuel,Param2= "Value ",...) Values that may contain spaces or commas are normally surrounded by double quotes. This notation is useful for the following reasons: • The parameter names are included in the command, in order to make the command more readable. • Because the parameter name is included, the parameters can generally be in any order. The command editor dialogs will enforce a default older. • Parameters that have default values can be omitted from the parameter list, shortening commands. • New parameters can be added over time, without requiring parameter order to change in existing commands. The above notation is being used for new commands and older commands are being updated to the new syntax as new software releases are made. Command editor dialogs will update old commands to the new syntax and the processing code will recognize old and new command syntax. The Command Reference illustrates the current command syntax. The following sequence occurs when processing commands: Parse the command. A time series identifier or command is parsed to determine how to execute the command. Example commands are shown below. If the command is a general command, the action is taken and anew command is read in step 1 (general commands can be specified multiple times to change properties throughout a run). If the command results in reading or creating a time series, steps 2 - 4 are executed, as described below. If a command is a time series manipulation command, step 4 is executed. # Example commands 08235350. USGS.Streamflow.Month- HydroBase 08236000. USGS.Streamflow.Month- HydroBase Add( TSID= "08235350.USGS.Streamflow. Month", HandleMissingHow= IgnoreMissing, 27 Introduction - 7