Difference between revisions of "Project File:Output Files – Required"

From Gsshawiki
Jump to: navigation, search
(3.13.2 Optional Output)
(3.13.3 Optional Output Maps)
Line 115: Line 115:
 
| <pre>MAX_SED_FLUX  [value]</pre> || ''filename or folder'' || Filename to output link/node data sets of total sediment flux (running) (cm<sup>3</sup>/s) every '''MAP_FREQ''' minutes.  REQUIRES '''SOIL_EROSION'''.
 
| <pre>MAX_SED_FLUX  [value]</pre> || ''filename or folder'' || Filename to output link/node data sets of total sediment flux (running) (cm<sup>3</sup>/s) every '''MAP_FREQ''' minutes.  REQUIRES '''SOIL_EROSION'''.
 
|-  
 
|-  
 +
| <pre>NET_SED_VOLUME  [value]</pre> || ''filename or folder'' || Filename to output maps the net erosion (negative) and depostion (positive) in each cell (m<sup>3) every '''MAP_FREQ''' minutes.  REQUIRES '''SOIL_EROSION'''.
 +
|-
 
| <pre>GW_OUTPUT  [value]</pre> || ''filename or folder'' || Filename to output '''MAP_TYPE''' maps of groundwater head (m) every '''MAP_FREQ''' minutes.  REQUIRES '''WATER_TABLE'''. If '''MAP_TYPE'''=0, then [value] is a folder name and output files are called "value\gw_head.####.asc" **
 
| <pre>GW_OUTPUT  [value]</pre> || ''filename or folder'' || Filename to output '''MAP_TYPE''' maps of groundwater head (m) every '''MAP_FREQ''' minutes.  REQUIRES '''WATER_TABLE'''. If '''MAP_TYPE'''=0, then [value] is a folder name and output files are called "value\gw_head.####.asc" **
 
|-  
 
|-  

Revision as of 21:55, 21 February 2014

3.13.1 Required Output

Card Argument Description
SUMMARY  "filename.sum"
file name Output file summarizing information on options selected, inputs read, simulation results, mass conservation, and warnings generated during the simulation.
OUTLET_HYDRO  "filename.otl"
file name Output file containing time series discharge at the catchment outlet. (m3/s default or, ft3/s if QOUT_CFS card is specified)

3.13.2 Optional Output

Card Argument Description
QOUT_CFS
none Specifies outflow hydrograph ordinates in ft3/s. The default is m3/s.
QUIET
none Suppress printing of information to the screen each time step.
SUPER_QUIET
none Suppress all printing of information to the screen. Useful in calibration mode.
IN_HYD_LOCATION  "filename.ihl"
file name Name of input ASCII file containing the link/node pairs to write out hydrograph ordinates to the file specified by OUT_HYD_LOCATION.
OUT_HYD_LOCATION  "filename.ohl"
file name File name to output discharge (m3/s or ft3/s) every HYD_FREQ time steps, at locations specified in IN_HYD_LOCATION. REQUIRED if IN_HYD_LOCATION was specified.
OUT_DEP_LOCATION  "filename.odl"
file name File name to output time channel depths (m) every HYD_FREQ minutes at locations specified in the IN_HYD_LOCATION file.
OUTLET_SED_FLUX  "filename.osl"
file name File name to output outlet sediment flux (m3 s-1) every HYD_FREQ minutes at the watershed outlet. The columns in this file are: time, wash load flux (m3/s) for each wash size sediment, sand load flux (m3/s) for each wash load sediment from the overland plus an additional column for the sand deposited in the channel when the event begins.
 Requires SOIL_EROSION.  
OUTLET_SED_TSS  "filename.oss"
file name File name to output outlet TSS (mg L-1) every HYD_FREQ minutes at the watershed outlet. The columns in this file are: time, and TSS(mg/L) at the outlet.
 Requires SOIL_EROSION.  
IN_SED_LOC  "filename.isl"
file name Input file name containing link/node pairs to write sediment hydrograph to the file specified by OUT_SED_LOC. Requires SOIL_EROSION and CHAN_EXPLIC or DIFFUSIVE_WAVE.
OUT_SED_LOC  "filename.osl"
file name File name to output sediment flux (m3 s-1) every HYD_FREQ minutes at internal catchment locations specified in the IN_SED_LOCATION file. REQUIRED if SOIL_EROSION and IN_SED_LOC card are specified. The columns in this file are: time, wash load flux (m3/s) for each wash size sediment, sand load flux (m3/s) for each wash load sediment from the overland plus an additional column for the amount deposited in the channel when the event begins.
OUT_TSS_LOC  "filename.tss"
file name File name to output sediment concentration (mg L-1) every HYD_FREQ minutes at internal catchment locations specified in the IN_SED_LOCATION file. The columns in this file are: time, TSS (mg/L) for each specified location.
OVERLAND_DEPTH_LOCATION  "filename.odi"
file name Name of input ASCII file containing the number and location (row col) of cells to ouput values of overland depth (m) every HYD_FREQ time steps in the OVERLAND_DEPTHS file. The first line of the file is the number of locations "N" , followed by one line for each "N" pairs of row and column of the ouput cells.
OVERLAND_DEPTHS  "filename.odo"
file name File name to output overland depths (m) every HYD_FREQ time steps at locations specified in OVERLAND_DEPTH_LOCATION.
OVERLAND_WSE_LOCATION  "filename.owi"
file name Name of input ASCII file containing the number and location (row col) of cells to ouput values of overland water surface elevations (WSE), in (m), every HYD_FREQ time steps in the OVERLAND_WSE file. The first line of the file is the number of pairs "N", followed by one line for each "N" pairs of row and column of the ouput cells.
OVERLAND_WSE  "filename.owo"
file name File name to output overland water surface elevations (m) every HYD_FREQ time steps at locations specified in OVERLAND_WSE_LOCATION.
IN_THETA_LOCATION  "filname.itl"
table name Name of input ASCII file that contains locations of cells to output moisture data every HYD_FREQ time steps.
OUT_THETA_LOCATION  "filename.otl"
file name Filename to output time series moisture data every HYD_FREQ time steps at cells specified in IN_THETA_LOCATION.
OUT_WELL_LOCATION  "filename.igw"
file name Name of input ASCII file containing location of observation wells. Values of groundwater head at each location in the file specified in OUT_WELL_LOCATION will be output every HYD_FREQ time steps in the GW_WELL_LEVEL file.
GW_WELL_LEVEL  "filename.ogw"
file name File name to output groundwater heads every HYD_FREQ time steps at locations specified in OUT_WELL_LOCATION.
IN_GWFLUX_LOCATION  "filename.igf"
file name Name of input ASCII file containing the link/node pairs to write out stream/groundwater exchange flux ordinates to the file specified by OUT_GWFLUX_LOCATION.
OUT_GWFLUX_LOCATION  "filename.ogf"
file name File name to ouput stream groundwater exchange flus (m2 s-1) at locations specified in IN_GWFLUX_LOCATION file every HYD_FREQ minutes. Requires CHAN_EXPLIC or DIFFUSIVE_WAVE, CHAN_CON_TRANS, and IN_GWFLUX_LOCATION.
OUT_CON_LOCATION  "filename.ocl"
file name File name to ouput constituent concentrations (ppb) at locations specified in IN_HYD_LOC file every HYD_FREQ minutes. Requires CHAN_EXPLIC or DIFFUSIVE_WAVE, CHAN_CON_TRANS, and IN_HYD_LOCATION.
OUT_MASS_LOCATION  "filename.oml"
file name File name to ouput constituent mass flux (g s-1) at locations specified in IN_HYD_LOCACTION file every HYD_FREQ minutes. Requires CHAN_EXPLIC or DIFFUSIVE_WAVE, CHAN_CON_TRANS, and IN_HYD_LOCATION.
STRICT_JULIAN_DATE
none All time series data are output with strict Julian date.
OPTIMIZE  "filename.opt"
filename Filename to output optimization information: peak discharge and discharge volumes at the watershed outlet and at any points specified in the IN_HYD_LOCATION file for each storm event.
OPTIMIZE_SED  
Card used to specify to output sediment data for optimization, peak discharge and discharge volume, instead of flow. Can be used with the OPTIMIZE card or in automated calibration mode.
PROJECT_PATH  
directory path Card used to specify the directory to put all default output files. Default is directory where GSSHA is executed from. If you use this card, all path names in your project file should be relative to the path specified with the PROJECT_PATH card.
REPLACE_PARAMS  "filename.in"
filename File containing the names and formats of variables to be replaced in the input files when operating in replacement mode. Must be used with REPLACE_VALS.
REPLACE_VALS  "filename.in"
filename File containing the values of variables in the REPLACE_PARAMS file. Used when operating in replacement mode. Must be used with REPLACE_PARAMS.

3.13.3 Optional Output Maps

Card Argument Description
MAP_FREQ  ##
integer Frequency (minutes) that output time-series maps are written to. REQUIRED only if output maps are specified.
MAP_TYPE  ##
integer Specifies the format of output maps:

0 Arc/Info ASCII maps. 1 WMS maps, ASCII (default). 2 WMS maps, binary. 4 XMDF maps (input and output). REQUIRED only if MAP_FREQ is required.

DISCHARGE  [value]
filename or folder Filename or folder to output MAP_TYPE maps of the overland discharge (m3/s) every MAP_FREQ time steps.
DEPTH  [value]
file name or folder Filename or folder to output MAP_TYPE maps of overland flow depth (m) every MAP_FREQ minutes. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\depth.####.asc" **
INF_DEPTH  [value]
filename or folder Filename or folder to output MAP_TYPE maps of cumulative infiltrated depth (m) every MAP_FREQ minutes. REQUIRES infiltration option. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\inf_dep.####.asc" **
SURF_MOIST  [value]
filename or folder Filename or folder to output MAP_TYPE maps of soil surface volumetric water content every MAP_FREQ minutes. REQUIRES infiltration option. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\smoist.####.asc" **
RATE_OF_INFIL  [value]
file or folder Filename or folder to output MAP_TYPE maps of infiltration rate (cm/h) every MAP_FREQ minutes. REQUIRES infiltration option. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\infil.####.asc" **
DIS_RAIN  [value]
filename or folder Filename or folder to output MAP_TYPE maps of spatially distributed rainfall rate (mm/h) every MAP_FREQ minutes. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\rain.####.asc" **
CHAN_DEPTH  [value]
filename or folder Filename to output link/node data sets of channel depth (m) every MAP_FREQ minutes. REQUIRES CHAN_EXPLIC or DIFFUSIVE_WAVE.
CHAN_DISCHARGE  [value]
filename or folder Filename to output link/node data sets of channel discharge (m3/s) every MAP_FREQ minutes. REQUIRES CHAN_EXPLIC or DIFFUSIVE_WAVE.
MAX_SED_FLUX  [value]
filename or folder Filename to output link/node data sets of total sediment flux (running) (cm3/s) every MAP_FREQ minutes. REQUIRES SOIL_EROSION.
NET_SED_VOLUME  [value]
filename or folder Filename to output maps the net erosion (negative) and depostion (positive) in each cell (m3) every MAP_FREQ minutes. REQUIRES SOIL_EROSION.
GW_OUTPUT  [value]
filename or folder Filename to output MAP_TYPE maps of groundwater head (m) every MAP_FREQ minutes. REQUIRES WATER_TABLE. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\gw_head.####.asc" **
GW_RECHARGE_CUM  [value]
filename or folder Filename to output MAP_TYPE maps of cummulative groundwater recharge (cm) every MAP_FREQ minutes. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\gw_head.####.asc" **
GW_RECHARGE_INC  [value]
filename or folder Filename to output MAP_TYPE maps of groundwater recharge (cm) since last map output every MAP_FREQ minutes. If MAP_TYPE=0, then [value] is a folder name and output files are called "value\gw_head.####.asc" **

** if running on a linux/unix machine, then the path uses a forward slash instead of a backward slash.


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