TSTool Campbell Cloud Plugin / Introduction
Introduction
TSTool is a powerful software tool that automates time series processing and product generation. It was originally developed for the State of Colorado to process data for river basin modeling and has since been enhanced to work with many data sources including:
- United States Geological Survey (USGS) web service and file formats
- Natural Resources Conservation Service (NRCS) web services
- Regional Climate Center (RCC) Applied Climate Information Service (ACIS) web services
- US Army Corps of Engineers DSS data files
- others
TSTool is maintained by the Open Water Foundation, which also enhances the software based on project needs.
- See the latest TSTool Documentation to learn about core TSTool features.
- See the TSTool Download website for the most recent software versions and documentation.
- See the Campbell Cloud Plugin download page.
TSTool use with Campbell Cloud Web Services
Campbell Cloud Web Services provide access to data that are maintained in the Campbell Cloud system. See the following resources:
The Campbell Cloud datastore documentation describes how TSTool integrates with Campbell Cloud.
The ReadCampbellCloud command can be used to read time series,
in addition to time series identifiers that are generated from the main TSTool interface.
The following examples showing how to query battery voltage (BattVoltage) time series and the resulting time series graph.
TSTool Main Interface (see full-size image)
TSTool Graph for a Historical Period (see full-size image)
Campbell Cloud data measurement intervals and timestamps vary depending on the station configuration and sensors that are used.
For example, the following illustrate Campbell Aspen 10 station battery voltage (BattVoltage) data for several stations.
Note that the graph appears to show a 10-minute interval for data, which are instantaneous samples.
TSTool Graph for Battery Voltage Data (see full-size image)
However, a closer examination of the tabular data shows that the timestamps for each value have regular 10-minute spacing, but the second and sub-second values are not zero, as shown in the following table.
TSTool Table for Battery Voltage Data (see full-size image)
The following graph illustrates Aspen 10 accumulated precipitation (TotalAccumulation) for several stations.
Note that the graph appears to show a 5-minute interval for data, which are total accumulation as of the timestamp.
TSTool Graph for Accumulated Precitation Data (see full-size image)
A closer examination of the tabular data confirms that the timestamps for each value have regular 5-minute spacing, and the second and sub-second values are zero, which is indicative of a computed value.
The nuances of data requires that software that consumes the data is able to handle Campbell Cloud conventions. See the Campbell Cloud DataStore documentation for more details about data conventions.
TSTool Table for a Accumulated Precipitation Data (see full-size image)