TSTool / Command / ReadHecDss
ReadHecDss command reads time series from a HEC-DSS file.
See the HEC-DSS Input Type Appendix for information
about how time series properties are assigned using HEC-DSS file data.
Current limitations for the command include:
- Irregular time series cannot be read.
- HEC-DSS uses times through
2400. However, TSTool will convert this to
0000of the next day. Year, month, and day data are not impacted.
The following dialog is used to edit the command and illustrates the syntax of the command. In the future, it is envisioned that choices for A – F parts will be made available using data from the file.
ReadHecDss Command Editor (see also the full-size image)
The command syntax is as follows:
|The name of the HEC-DSS input file to read, surrounded by double quotes to protect whitespace and special characters. Can be specified with
||None – must be specified.|
||The A part (basin name) to match, using
||The B part (location) to match, using
||The C part (parameter) to match, using
||The E part (interval) to match, using
||The F part (scenario) to match, using
||The HEC-DSS pathname for a time series, as specified in the HEC-DSS documentation. Currently wildcards are not allowed. If specified, this will be used instead of the A-F parameters. Can be specified with
||Starting date/time to read data, in precision consistent with data. Can be specified with
||Read all data.|
||Ending date/time to read data, in precision consistent with data. Can be specified with
||Read all data.|
||The location to assign for the time series identifier. Use
||Alias to assign to the output time series. See the
||None is assigned. However, if the location contains periods that are in conflict with time series identifier conventions, the alias is set to the identifier with periods, and the periods are replaced with spaces in the full time series identifier.|
See the automated tests.
A sample command file is as follows: