Laserfiche WebLink
Examples of Use TSTool Documentation <br />6.4 Time Series Product Examples <br /> <br />Time series products are described in the TSView Time Series Viewing Tools appendix. In summary, a <br />time series product file uses time series identifiers to indicate data to be processed, and includes other <br />properties (e.g., titles) to configure a graph. TSTool can process time series products in a number of <br />ways, as illustrated by the following examples. <br /> <br />6.4.1 Time Series Product - Using TSTool to Display Graphs from an Application <br /> <br />TSTool primarily is used as an interactive tool or to process command files in batch mode. However, it is <br />also possible to run TSTool with a command file, no ma in graphical user interface, and still display only <br />specific graphs. For example, TSTool can be called from an application to display a graph by reading <br />data from a recognized database or file format. This takes advantage of TSTool’s features rather than <br />adding additional features to the application. The fo llowing example illustrates how to display a graph of <br />precipitation and streamflow data in a single graph, using data from the State of Colorado’s HydroBase <br />database. TSTool should be started using a command line similar to: <br /> <br />tstool –commands example.tstool –nomaingui <br /> <br />Additionally, the HydroBase database to be used shoul d be configured in the TSTool configuration file <br />(see the Installation and Configuration Appendix ). In this run mode the main GUI is never made <br />visible. Because the interactive main interface is disabled, the normal HydroBase login dialog is not <br />shown; therefore, the HydroBase information must be defined in the configuration information. <br /> <br />Although it is possible to display several graphs at the same time, it is currently assumed that only one <br />graph will be shown. Closing the graph will close TSTool. The command file can be complex but in <br />many cases will be simple because an application is calling TSTool to display a single graph. The <br />following example shows a typical command file for this run mode: <br /> <br /># Example command file to run TSTool without showing the main GUI <br /># but showing a plot to the screen. When the plot window closes, TSTool will <br /># exit without prompting. TSTool should be called using: <br /># <br /># TSTool -commands ThisFile -nomaingui <br /># <br /># This is useful for displaying plots from applications that only need to use <br /># TSTool in a supporting role. <br /># <br /># Process a time series product description file and display a plot window <br /># to the screen. <br />ProcessTSProduct(TSProductFile="test.tsp",RunMode=GUIAndBatch,View=True) <br /> <br />Examples - 12 92