TSTool / Command / ConvertDataUnits
ConvertDataUnits command converts the data units for a time series (e.g., before output to a file).
Some read and write commands also may allow units to be converted.
See also the
Scale command, which allows units of output to be specified.
The following dialog is used to edit the command and illustrates the syntax of the command.
ConvertDataUnits Command Editor (see also the full-size image)
The Dimension choice should be selected to narrow the list of available units to the appropriate dimension.
Next, select the New Data Units for the time series.
The list of available data units is taken from the information described in the
DATAUNIT file (see the TSTool Installation and Configuration Appendix for more information).
If desired units are not available,
contact the TSTool developers to suggest adding units to the
or edit the command manually after initial creation.
See also the TSTool View / Data Units menu to view the current data units.
The dialog cannot display the current units for the time series because the units are not available until time series are actually processed – commands are edited before processing.
The command syntax is as follows:
||Indicates the list of time series to be processed, one of:
||The time series identifier or alias for the time series to be processed, using the
||The ensemble to be processed, if processing an ensemble. Can be specified using
|The new data units.||None – must be specified.|
See the automated tests.
A sample command file to convert the units of a time series from the State of Colorado’s HydroBase database is as follows:
# 08236000 - ALAMOSA RIVER ABOVE TERRACE RESERVOIR 08236000.DWR.Streamflow.Month~HydroBase ConvertDataUnits(TSList=AllMatchingTSID,TSID="08236000.DWR.Streamflow.Month",NewUnits="CFSD")