TSTool_UserManual_10-21-00 - Laserfiche WebLink

TSTool Documentation Introduction - 11 08235350.USGS.Streamflow.Month~HydroBase 2. Read or c reate t ime s eries. TSTool recognizes that certain commands should read or create a new time series and will perform the appropriate action. For example, in the above example, the time series identifier 08235350.USGS.Streamflow.Month~HydroBase indicates t hat the corresponding time series should be read from a HydroBase database . The input type in the identifier (information after the ~) is used to determine how to read the time series. By default, the entire time series will be read unless the SetInputPer iod() or SetOutputPeriod() commands have been specified . a. Read data. If the input type, and if needed, input name, are specified in the identifier, they are used to read the data . Time series properties such as units are assigned . b. Compute d ata l imits. T he time series data limits are computed because they may be needed later for filling. This information includes the long -term monthly averages. These limits are referred to as the original data limits. c. Save time series in processor. The time series that are read or created are managed by the processor, using the TSID and alias. The time series can then be manipulated by other commands, as per the following step. 3. Manipulate time series or other data . Commands that manipulate time series (fill, add, etc .) do not automatically read the time series or make another copy. Instead, time series that are in memory are located using the TSID or alias and are manipulated as per the command functionality . The following example illustrates how the time series ide ntified by 08235350.USGS.Streamflow.Month has its data values modified by adding the data from the time series identified by 08236000.USGS.Streamflow.Month. # Example commands 08235350.USGS.Streamflow.Month~HydroBase 08236000.DWR .Streamflow.Month~HydroBas e A dd(TSID=”08235350.USGS.Streamflow.Month ”,HandleMissingHow=IgnoreMissing,TSList =SpecifiedTSID,AddTSID=”08236000.DWR.Streamflow.Month ”) 08235350.USGS.Streamflow.Month~HydroBase To locate a time series so that it can be modified, TSTool first checks the alias of time series (those that have been read or created in previous commands) against the current time series of interest (TSID=”0 8235350.USGS.Streamflow.Month ”), assuming that this string is an alias . If the alias is not found, it checks the full iden tifier of known time series against the current time series of interest. In this example, time series 08235350.USGS.Streamflow.Month was read in the first step and is therefore found as a match for the identifier. Similarly, the second time series in the command (08236000.USGS.Streamflow.Month ) is found and is used to process the command, resulting in a modification of the first time series. Sequential manipulations of the same time series can occur (e.g., fill by one method, then fill by another). TSTo ol commands generally use the TSList parameter to locate time series in memory, where the default value depends on the command. For example, TSList=AllTS will process all time series . For commands that require a single input time series, TSTool often wil l default to TSList=LastMatchingTSID , which finds the first time series prior to the current command. I t is possible to create more than one time series with the same identifier while allowing localized processing of each time series . For example, the ti me series identified by 08235350.USGS.Streamflow.Month~HydroBase is read twice, once to be acted on by the A dd() command, and once with no manipulation (e.g., to compare the "before" and "after"). 23