Names a DSS file. Optionally provides an index for the DSS file.
[Index =] Name of existing DSS file. Examples:
/home/data/river.dss
1=/home/data/river.dss
Gage
Specifies name, location, and elevation of a gage
String, Coordinate Pair, elevation in meters. Elevation is optional and used only for lapse computations.
WEBB 95d10'06W 35d35'12
Path
Specifies DSS path name for gage
[Index:] Valid DSS path name with optional D and E parts.
Examples:
//LOC/PRECIP-CUM//IR-MONTH/OBS/
1:/BASIN/LOC/PRECIP-CUM///OBS/
Timezone
Specifies the time zone for the precipitation time series, determining an offset time from UTC
Three-letter time zone ID, Y or N (indicating whether daylight saving time is observed.)
EST N
Radius
Ignored keyword in HEC-MetVue
Disable
Disables a gage
No value. If a disable: line is present in a gage block, the gage is ignored.
Text
Label information for gage.
Character string. Can extend over more than one line.
Datum
Geographic datum for coordinates of gage location
NAD27 (default for HRAP and SHG)
NAD83
WGS84 (default for UTM)
Additional notes on setting gage parameters in the control file:
A gage must be named before any descriptors can be associated with it. Gage data should be entered with the gage line first, followed in any order by a path line, a time zone line, and optional disable, datum, and text lines.
Coordinates for gage locations can be given in the same formats as the grid limits.
Coordinates must be specified in lat/lon (DMS or decimal degrees accepted).
At least one DSS input file must be specified with a DSSFile line.
If more than one DSS file is to be used, each must be identified with an index.
If only one DSS file is used, an index can be used, but is not required.
If one un-indexed DSS file is named, path names must not include indices.
If indexed DSS files are used, the first path name listed must include a file index; after the first path is named, any following paths without an associated index will be associated with the last index used.
If the E part of a gage’s DSS path is omitted and the output is of type PER-CUM, HEC-MetVue will look for an E part that matches the output time step. If the output type is INST-VAL, an E part must be specified.
For HRAP and SHG grids, if a gage’s definition in the control file does not contain a DATUM line, its longitude and latitude will be assumed to be in NAD27 coordinates.
For UTM grids, if a gage’s definition in the control file does not contain a DATUM line, its longitude and latitude will be assumed to be in WGS84 coordinates.
NAD27 and NAD83 are not defined outside the US. In UTM grids, if a gage outside the US is given a NAD27 datum, its location will be undefined and the gage will be disabled. NAD83 coordinates will be assumed to be identical to WGS84 coordinates for UTM grids.
Valid time zone codes are listed in the table below. For each gage the user must specify a time zone and whether daylight savings time is observed.