TSTool_DatastoreReference_10-21-00

Appendix: HEC-DSS Input Type 2009-01-14 Overview HEC-DSS input type refers to the United States Ar my Corps of Engineers’ Hydrologic Engineering Center (HEC) Data Storage System (DSS). Refer to the following web sites for more information: http://www.hec.usace.army.mil (main web site) http://www.hec.usace.army.mil/softw are/legacysoftware/hec-dss_pc -dos/documentation/overview.pdf (HEC-DSS User’s Guide and Utility Program Manuals overview) HEC-DSS Files and Standard Time Series Properties The standard time series identifier used with TSTool and other software is of the form: Location.DataSource.DataType.Interval.Scenario~InputType~PathToFile The implementation of the identifier for HEC-DSS files is of the form: Apart:Bpart.HEC-DSS.Cpart.Epart.Fpart~HEC-DSS~PathToFile HEC-DSS time series identifier information is take n from the A-F “pathname parts” used to identify HEC-DSS time series. The following assignments are made: • The location part of the identifier is set to the A-part , a colon, and the B-part. This retains the original HEC-DSS location information. The colon and period characters cannot be used in the original HEC-DSS A- and B- parts because they conflic t with the identifier implementation described above. Instead, it is recommended that dash es, underscores, and other delimiting characters are used within the parts if the HEC-DSS da ta will be used extensively with TSTool. • The data source part of the identifier by default is set to HEC-DSS to indicate that “HEC-DSS” is the provider of the data. In the future this could be used to store the data source (data provider) such as “USGS”, “NWS”, etc., if such information could be obtained from the HEC-DSS time series pathname or supplemental data. • The data type is set to the C-part. In HEC-DSS, th is is referred to as the “parameter”. In HEC-DSS the term “type” is used to indicate whether a time series is instantaneous, mean, or accumulated. The period character cannot be used in the original HEC-DSS C-part when used with TSTool. • The data interval is set to the E-part. The period character cannot be used in the original HEC- DSS E-part when used with TSTool. Currently the irregular interval is not supported, but will be added in the future. • The scenario is set to the F-part. The period character cannot be used in the original HEC-DSS E-part when used with TSTool. • The data units are determined from time series information. • The D-part is initially used to assign the time series period, but is reset with information from the time series data records, if available. The D-part dates are of the form DDMonYYYY or DDMMYYYY – DDMonYYYY . A single date indicates the start of a data block in the HEC-DSS data management scheme (see the HEC-DSS documentation referenced above). Two dates indicates the starting and ending data blocks for a condensed catalog (list of time series); however, in this case the ending date Appendix – HEC-DSS Input Type - 1 31