Project File:Channel Routing – Optional

From Gsshawiki
Jump to: navigation, search

3.7.1 Required Inputs

The following cards are REQUIRED for the simulation of channel routing.

Card Argument Description
DIFFUSIVE_WAVE
none Specifies explicit diffusive-wave 1-D channel routing.
CHAN_EXPLIC
none Specifies explicit diffusive-wave 1-D channel routing. Performs same function as DIFFUSIVE_WAVE.
CHANNEL_INPUT  "filename.cif"
file name Input ASCII file containing channel network connectivity and cross-sectional information for each link/node.
STREAM_CELL  "filename.gst"
file name Input ASCII file containing channel/grid connectivity information.
OUTLET_HYDRO  "filename.otl"
file name Output ASCII file containing discharge (m3 s-1) unless QOUT_CFS flag is specified (ft3 s-1)
SECTION_TABLE  "filename.ext"
file name Input ASCII file containing cross-section information for irregular, break-point channel cross-sections. REQUIRED if look-up table cross-sections are specified in the CHANNEL_INPUT file.


3.7.2 Initial Condition and Boundary Condition - Optional

Card Argument Description
EXPLIC_BACKWATER  "filename.ext"
file name Save explicit channel routing end of run values of channel depth (m) and discharge (m3 s-1) for each cell.
EXPLIC_HOTSTART  "filename.ext"
file name Start explicit channel calculations using the values of channel depth and flow in the named file.
WRITE_CHAN_HOTSTART  "filename"
file name Save explicit channel routing end of run values of channel depth (m) and discharge (m3 s-1) for each cell. Depths and discharges will be saved in separate files. Depths will be saved in a file with name "filename" with extension .dht. Discharges will be saved in a file with name "filename" with extension .qht.
READ_CHAN_HOTSTART  "filename"
file name Start explicit channel calculations using the values of channel depth and flow in the named file. Depths should be in a file with the name "filename" with extension .dht. Discharges should be in a file with the name "filename" and with extension .qht.
OVERBANK_FLOW
none Allow water in channel to flow back onto overland flow plane when stream elevation is above top of bank and the adjacent overland cell elevation.
OVERBANK_MAX_DV
float Fraction of stream water above TOB that can exit the channel during a single time step when the OVERBANK_FLOW card is specified. Defualt value is 0.01.
OVERLAND_BACKWATER
none Include backwater effects on overland when stream water surface elevation or TOB is greater than overland flow surface elevation without allowing water in channel to flow back onto overland.
CHAN_POINT_INPUT
file name Input ASCII file containing the point source input location, discharge, and concentrations.
MAX_COURANT_NUMBER
float Value to limit maximum fractional change in channel volume for stability. Default is 0.04.
HEAD_BOUND
none Specified head boundary at the channel outlet. Requires BOUND_DEPTH or BOUND_TS card.
BOUND_DEPTH
float Specified static head boundary at the channel outlet (m). Used with HEAD_BOUND card, exclusive to BOUND_TS card.
BOUND_TS
time series name Name of the time series used for the specified channel boundary in the TIME_SERIES_FILE. Used with HEAD_BOUND card, exclusive to BOUND_DEPTH card.
CHANNEL_MOMENTUM
float Use the momentum formulation for channel flow in version 7.14 and higher. The value specified is the time step limitation coefficient, between the value of 0.0 and 1.0. Higher values increase speed. Lower values increase stability. The default value is 0.2.

3.7.3 Stream Losses/Gains - Optional

3.7.3.1 General

Card Argument Units Description
STREAM_LOSS
none none Card is used to specify that stream losses be computed when the WATER_TABLE card is not included in the project file.

3.7.3.2 Parameters

Used with WATER_TABLE or STREAM_LOSS card. These parameters may also be distributed along the channel by assigning in the CHAN_INPUT file.

Card Argument Units Description
K_RIVER  ##.##
real cm hr-1 Uniform hydraulic conductivity of streambed material. REQUIRES WATER_TABLE or STREAM_LOSS. May also be distributed in CHAN_INPUT file.
M_RIVER  ##.##
real cm Uniform thickness of streambed material. Requires WATER_TABLE or STREAM_LOSS. May also be distributed in CHAN_INPUT file.

3.7.4 Optional Output

Card Argument Description
IN_HYD_LOCATION  "filename.ihl"
table name Input ASCII file specifying link/node pairs to write out time series data specified by OUT_HYD_LOCATION, OUT_DEP_LOCATION, or OUT_CON_LOCATION.
OUT_HYD_LOCATION  "filename.ohl"
filename Filename to output time series discharge data (m3 s-1 or ft3 s-1) at points specified in IN_HYD_LOCATION. REQUIRED if IN_HYD_LOCATION was specified.
OUT_DEP_LOCATION  "filename.odl"
filename Filename to output channel depths (m) every HYD_FREQ time steps at locations specified in the IN_HYD_LOCATION file.
IN_SED_LOC  "filename.isl"
table name Input ASCII file containing a list of internal link/node locations where the user wants to save sediment hydrographs. Format identical to IN_HYD_LOC option. REQUIRES SOIL_EROSION.
OUT_SED_LOC  "filename.osl"
filename Filename to output sediment flux hydrographs every HYD_FREQ time steps at internal catchment locations specified in the IN_SED_LOC file. REQUIRED if SOIL_EROSION and IN_SED_LOC card are specified.
IN_GWFLUX_LOCATION  "filename.igf"
table name Input ASCII file specifying link/node pairs to write out time series of stream/groundwater exchange flux in the file OUT_GWFLUX_LOCATION.
OUT_HYD_LOCATION  "filename.ogf"
filename Filename to output time series stream/groundwater exchange flux data (m2 s-1 or ft3 s-1) at points specified in IN_GWFLUX_LOCATION. REQUIRED if IN_GWFLUX_LOCATION was specified.
STRICT_JULIAN_DATE
none Specifies all time series data use strict Julian format.
CHAN_DEPTH  "filename.cdp"
filename Filename to output link/node data of channel depth (m) every MAP_FREQ time steps.
CHAN_STAGE  "filename.cds"
filename Filename to output link/node data of channel stage (m) every MAP_FREQ time steps.
CHAN_DISCHARGE  "filename.cdq"
filename Filename to output link/node data of channel discharge (m3 s-1) every MAP_FREQ time steps.
CHAN_VELOCITY  "filename.cdv"
filename Filename to output link/node data of channel velocity (m s-1) every MAP_FREQ time steps.
LAKE_OUTPUT    "filename.lel"
filename Filename to output reservoir elevation (m) and volume (m3) for each reservoir in the order listed in the .cif file every MAP_FREQ time steps.


GSSHA User's Manual

3 Project File
3.1     Required Inputs
3.2     Mapping Table – Optional
3.3     Overland Flow – Required
3.4     Interception – Optional
3.5     Rainfall Input and Options – Required
3.6     Infiltration – Optional
3.7     Channel Routing – Optional
3.8     Continuous Simulations – Optional
3.9     Saturated Groundwater Flow – Optional
3.10     Soil Erosion – Optional
3.11     Constituent Transport – Optional
3.12     Subsurface Drainage Network – Optional
3.13     Output Files – Required