TSTool - Laserfiche WebLink

Home Browse Search

TSTooI Documentation date is then interpolated to the screen pixels, as integers. In most cases, the high-precision date/time parts are irrelevant because they default to zero. However, in some cases the precision can impact plots significantly. For example, when plotting daily and monthly data on the same graph, the monthly data will be plotted ignoring the day whereas the daily values correspond days 1 to 31. The ability to plot monthly data mid-month or end-of--month has not been implemented. The TSView Time Series Viewing Tools appendix provides examples of plots. The date/time precision may be very important when performing an analysis or converting between time series file formats. For example, a file may contain 6Hour data using a maximum hour of 24 (e.g., 6, 12, 18, 24). When reading this data, TSTooI will convert the hour 24 values to hour 0 of the next day. Consequently, the hour and day of the original data will seemingly be shifted, even though the data are actually consistent. Also, because TSTooI is a general tool, it assumes that the date/time information for data corresponds to the instantaneous time at which the data value applies, or the interval-ending time for which the data value applies. Rigorous handling of instantaneous, mean, and accumulated values based on data type is being phased in. Currently, however, an understanding of the data must be used when deciding how to use certain TSTooI features (e.g., to decide on which side of a date/time bars should be plotted on a graph). 2.3 Time Series Commands and Processing Sequence Although TSTooI can be run in batch mode (see Chapter 3 -Getting Started), you should be able to perform all time series viewing and manipulation within the GUI. Commands are used to read, manipulate, and output time series. Commands are processed sequentially from the first to the last 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 TSTooI (before version S.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. TSTooI commands fall into three main categories: 1. time series identifiers and aliases (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), 2. general commands, which are used to set properties like the period for output, and, 3. 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. Atypical user starts learning TSTooI 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: Introduction - 5