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

From Gsshawiki
Jump to: navigation, search
(3.13.3 Optional Output Maps)
(3.13.3 Optional Output Maps)
 
(8 intermediate revisions by the same user not shown)
Line 23: Line 23:
 
| <pre>SUPER_QUIET</pre> || ''none'' || Suppress all printing of information to the screen. Useful in calibration mode.
 
| <pre>SUPER_QUIET</pre> || ''none'' || Suppress all printing of information to the screen. Useful in calibration mode.
 
|-  
 
|-  
 +
|-
 +
| <pre>STRICT_JULIAN_DATE</pre> || ''none'' || All time series data are output with strict Julian date.
 +
|-
 +
| <pre>OPTIMIZE  "filename.opt"</pre> || ''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.
 +
|-
 +
| <pre>OPTIMIZE_SED  </pre> ||  || 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.
 +
|-
 +
| <pre>PROJECT_PATH  </pre> || ''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.
 +
|-
 +
| <pre>REPLACE_PARAMS  "filename.in"</pre> || ''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'''.
 +
|-
 +
| <pre>REPLACE_VALS  "filename.in"</pre> || ''filename'' || File containing the values of variables in the '''REPLACE_PARAMS''' file.  Used when operating in replacement mode.  Must be used with '''REPLACE_PARAMS'''.
 +
|-
 
| <pre>IN_HYD_LOCATION  "filename.ihl"</pre> || ''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'''.  
 
| <pre>IN_HYD_LOCATION  "filename.ihl"</pre> || ''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'''.  
 
|-  
 
|-  
| <pre>OUT_HYD_LOCATION  "filename.ohl"</pre> || ''file name'' || File name to output discharge (m<sup>3</sup>/s or ft<sup>3</sup>/s) every '''HYD_FREQ''' time steps, at locations specified in '''IN_HYD_LOCATION'''.  REQUIRED if '''IN_HYD_LOCATION''' was specified.
+
| <pre>OUT_HYD_LOCATION  "filename.ohl"</pre> || ''file name'' || File name to output discharge (m<sup>3</sup>/s or ft<sup>3</sup>/s) every '''HYD_FREQ''' minutes, at locations specified in '''IN_HYD_LOCATION'''.  REQUIRED if '''IN_HYD_LOCATION''' was specified.
 
|-  
 
|-  
 
| <pre>OUT_DEP_LOCATION  "filename.odl"</pre> || ''file name'' || File name to output time channel depths (m) every '''HYD_FREQ''' minutes at locations specified in the '''IN_HYD_LOCATION''' file.  
 
| <pre>OUT_DEP_LOCATION  "filename.odl"</pre> || ''file name'' || File name to output time channel depths (m) every '''HYD_FREQ''' minutes at locations specified in the '''IN_HYD_LOCATION''' file.  
 
|-
 
|-
| <pre>OUTLET_SED_FLUX  "filename.osl"</pre>|| ''file name'' || File name to output outlet sediment flux (m<sup>3</sup> s<sup>-1</sup>) 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.   
+
| <pre>OUTLET_SED_FLUX  "filename.osl"</pre>|| ''file name'' || File name to output outlet sediment flux (m<sup>3</sup> s<sup>-1</sup>) every '''HYD_FREQ''' minutes at the watershed outlet. The columns in this file are: time, wash load flux (m<sup>3</sup>/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'''.
+
   Requires '''SOIL_EROSION'''.
|-
 
 
|-
 
|-
| <pre>OUTLET_SED_TSS  "filename.oss"</pre>|| ''file name'' || File name to output outlet TSS (mg L<sup>-1</sup>) every '''HYD_FREQ''' minutes at the watershed outlet. The columns in this file are: time, and TSS(mg/L) at the outlet.   
+
| <pre>OUTLET_SED_TSS  "filename.oss"</pre>|| ''file name'' || File name to output outlet TSS (mg L<sup>-1</sup>) every '''HYD_FREQ''' minutes at the watershed outlet. The columns in this file are: time, and TSS(mg L<sup>-1</sup>) at the outlet.   
 
   Requires '''SOIL_EROSION'''.   
 
   Requires '''SOIL_EROSION'''.   
 
|-  
 
|-  
 
| <pre>IN_SED_LOC  "filename.isl"</pre> || ''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'''.   
 
| <pre>IN_SED_LOC  "filename.isl"</pre> || ''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'''.   
 
|-  
 
|-  
| <pre>OUT_SED_LOC  "filename.osl"</pre> || ''file name'' || File name to output sediment flux (m<sup>3</sup> s<sup>-1</sup>) 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.   
+
| <pre>OUT_SED_LOC  "filename.osl"</pre> || ''file name'' || File name to output sediment flux (m<sup>3</sup> s<sup>-1</sup>) 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 (m <sup>3</sup> s<sup>-1</sup>) for each wash size sediment, sand load flux (m <sup>3</sup> s<sup>-1</sup>) for each wash load sediment from the overland plus an additional column for the amount deposited in the channel when the event begins.   
|-
 
 
|-  
 
|-  
 
| <pre>OUT_TSS_LOC  "filename.tss"</pre> || ''file name'' || File name to output sediment concentration (mg L<sup>-1</sup>) 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.   
 
| <pre>OUT_TSS_LOC  "filename.tss"</pre> || ''file name'' || File name to output sediment concentration (mg L<sup>-1</sup>) 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.   
 
|-  
 
|-  
 
+
| <pre>OVERLAND_DEPTH_LOCATION  "filename.odi"</pre> || ''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''' minutes 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.
| <pre>OVERLAND_DEPTH_LOCATION  "filename.odi"</pre> || ''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.
 
 
|-  
 
|-  
| <pre>OVERLAND_DEPTHS  "filename.odo"</pre> || ''file name'' || File name to output overland depths (m) every '''HYD_FREQ''' time steps at locations specified in '''OVERLAND_DEPTH_LOCATION'''.
+
| <pre>OVERLAND_DEPTHS  "filename.odo"</pre> || ''file name'' || File name to output overland depths (m) every '''HYD_FREQ''' minutes at locations specified in '''OVERLAND_DEPTH_LOCATION'''.
 
|-  
 
|-  
 +
| <pre>OVERLAND_WSE_LOCATION  "filename.owi"</pre> || ''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.
 
|-  
 
|-  
| <pre>OVERLAND_WSE_LOCATION  "filename.owi"</pre> || ''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.
+
| <pre>OVERLAND_WSE  "filename.owo"</pre> || ''file name'' || File name to output overland water surface elevations (m) every '''HYD_FREQ''' minutes at locations specified in '''OVERLAND_WSE_LOCATION'''.
 +
|-
 +
| <pre>OVERLAND_Q_CUM_LOCATION "filename.cdl"</pre> || ''file name'' || Name of input ASCII file containing the number and location (row col) of cells to ouput values of cumulative overland (m<sup>3</sup>), every '''HYD_FREQ''' minutes in the '''CUM_DISCHARGE''' 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.
 
|-  
 
|-  
| <pre>OVERLAND_WSE "filename.owo"</pre> || ''file name'' || File name to output overland water surface elevations (m) every '''HYD_FREQ''' time steps at locations specified in '''OVERLAND_WSE_LOCATION'''.
+
| <pre>CUM_DISCHARGE "filename.cds"</pre> || ''file name'' || File name to output cumulative overland discharge (m3) every '''HYD_FREQ''' minutes at locations specified in '''OVERLAND_Q_CUM_LOCATION'''.
 
|-  
 
|-  
| <pre>IN_THETA_LOCATION  "filname.itl"</pre> || ''table name'' || Name of input ASCII file that contains locations of cells to output moisture data every '''HYD_FREQ''' time steps.
+
| <pre>IN_THETA_LOCATION  "filname.itl"</pre> || ''table name'' || Name of input ASCII file that contains locations of cells to output moisture data every '''HYD_FREQ''' minutes.
 
|-  
 
|-  
| <pre>OUT_THETA_LOCATION  "filename.otl"</pre> || ''file name'' || Filename to output time series moisture data every '''HYD_FREQ''' time steps at cells specified in '''IN_THETA_LOCATION'''.
+
| <pre>OUT_THETA_LOCATION  "filename.otl"</pre> || ''file name'' || Filename to output time series moisture data every '''HYD_FREQ''' minutes at cells specified in '''IN_THETA_LOCATION'''.
 
|-  
 
|-  
| <pre>OUT_WELL_LOCATION  "filename.igw"</pre> || ''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.
+
| <pre>OUT_WELL_LOCATION  "filename.igw"</pre> || ''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''' minutes in the '''GW_WELL_LEVEL''' file.
 
|-  
 
|-  
 
| <pre>GW_WELL_LEVEL  "filename.ogw"</pre> || ''file name'' || File name to output groundwater heads every '''HYD_FREQ''' time steps at locations specified in '''OUT_WELL_LOCATION'''.
 
| <pre>GW_WELL_LEVEL  "filename.ogw"</pre> || ''file name'' || File name to output groundwater heads every '''HYD_FREQ''' time steps at locations specified in '''OUT_WELL_LOCATION'''.
Line 68: Line 81:
 
|-
 
|-
 
| <pre>OUT_MASS_LOCATION  "filename.oml"</pre> || ''file name'' || File name to ouput constituent mass flux (g s<sub>-1</sub>) 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'''.
 
| <pre>OUT_MASS_LOCATION  "filename.oml"</pre> || ''file name'' || File name to ouput constituent mass flux (g s<sub>-1</sub>) 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'''.
|-
 
| <pre>STRICT_JULIAN_DATE</pre> || ''none'' || All time series data are output with strict Julian date.
 
|-
 
| <pre>OPTIMIZE  "filename.opt"</pre> || ''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.
 
|-
 
| <pre>OPTIMIZE_SED  </pre> ||  || 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.
 
|-
 
| <pre>PROJECT_PATH  </pre> || ''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.
 
|-
 
| <pre>REPLACE_PARAMS  "filename.in"</pre> || ''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'''.
 
|-
 
| <pre>REPLACE_VALS  "filename.in"</pre> || ''filename'' || File containing the values of variables in the '''REPLACE_PARAMS''' file.  Used when operating in replacement mode.  Must be used with '''REPLACE_PARAMS'''.
 
 
|}
 
|}
  
Line 97: Line 98:
 
REQUIRED only if '''MAP_FREQ''' is required.
 
REQUIRED only if '''MAP_FREQ''' is required.
 
|-  
 
|-  
| <pre>DISCHARGE  [value]</pre> || ''filename or folder'' || Filename or folder to output '''MAP_TYPE''' maps of the overland discharge (m<sup>3</sup>/s) every '''MAP_FREQ''' time steps.
+
| <pre>DISCHARGE  [value]</pre> || ''filename or folder'' || Filename or folder to output '''MAP_TYPE''' maps of the overland discharge (m<sup>3</sup>/s) every '''MAP_FREQ''' minnutes.  Overland flow is replaced with channel flow if the '''OVERLAND_CHAN_DISCHARGE''' card is used.
 +
|-
 +
| <pre>CUM_DISCHARGE_MAP  [value]</pre> || ''filename or folder'' || Filename or folder to output '''MAP_TYPE''' maps of the cumulative overland discharge (m<sup>3</sup>) every '''MAP_FREQ''' time steps.  Overland flow is replaced with channel flow if the '''OVERLAND_CHAN_DISCHARGE''' card is used.
 +
|-
 +
|-
 +
| <pre>OVERLAND_CHAN_DISCHARGE  [value]</pre> || '''' || Replace overland flow with channel flow in '''DISCHARGE''' and '''CUM_DISCHARGE_MAP''' maps.
 
|-  
 
|-  
 
| <pre>DEPTH  [value]</pre> || ''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" **
 
| <pre>DEPTH  [value]</pre> || ''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" **
Line 105: Line 111:
 
| <pre>SURF_MOIST  [value]</pre> || ''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" **
 
| <pre>SURF_MOIST  [value]</pre> || ''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" **
 
|-  
 
|-  
| <pre>RATE_OF_INFIL  [value]</pre> || ''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" **
+
| <pre>RATE_OF_INFIL  [value]</pre> || ''file or folder'' || Filename or folder to output '''MAP_TYPE''' maps of infiltration rate (cm h<sup>-1</sup>) 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" **
 
|-  
 
|-  
| <pre>DIS_RAIN  [value]</pre> || ''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" **
+
| <pre>DIS_RAIN  [value]</pre> || ''filename or folder'' || Filename or folder to output '''MAP_TYPE''' maps of spatially distributed rainfall rate (mm h<sup>-1</sup>) every '''MAP_FREQ''' minutes. If '''MAP_TYPE'''=0, then [value] is a folder name and output files are called "value\rain.####.asc" **
 
|-  
 
|-  
 
| <pre>CHAN_DEPTH  [value]</pre> || ''filename or folder'' || Filename to output link/node data sets of channel depth  (m) every '''MAP_FREQ''' minutes.  REQUIRES '''CHAN_EXPLIC''' or '''DIFFUSIVE_WAVE'''.
 
| <pre>CHAN_DEPTH  [value]</pre> || ''filename or folder'' || Filename to output link/node data sets of channel depth  (m) every '''MAP_FREQ''' minutes.  REQUIRES '''CHAN_EXPLIC''' or '''DIFFUSIVE_WAVE'''.
 
|-  
 
|-  
| <pre>CHAN_DISCHARGE  [value]</pre> || ''filename or folder'' || Filename to output link/node data sets of channel discharge (m<sup>3</sup>/s) every '''MAP_FREQ''' minutes.  REQUIRES '''CHAN_EXPLIC''' or '''DIFFUSIVE_WAVE'''.  
+
| <pre>CHAN_DISCHARGE  [value]</pre> || '''' || Write channel discharge maps (m<sup>3</sup>/s) or '''CUM_DISCHARGE''' maps (m<sup>3) every '''MAP_FREQ''' minutes.  REQUIRES '''CHAN_EXPLIC''' or '''DIFFUSIVE_WAVE''.  
 
|-  
 
|-  
| <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<sup>-1</sup>) 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</sup>) 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</sup>) every '''MAP_FREQ''' minutes.  REQUIRES '''SOIL_EROSION'''.

Latest revision as of 20:18, 20 February 2018

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.
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.
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 minutes, 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-1) 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 (m 3 s-1) for each wash size sediment, sand load flux (m 3 s-1) 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 minutes 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 minutes 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 minutes at locations specified in OVERLAND_WSE_LOCATION.
OVERLAND_Q_CUM_LOCATION  "filename.cdl"
file name Name of input ASCII file containing the number and location (row col) of cells to ouput values of cumulative overland (m3), every HYD_FREQ minutes in the CUM_DISCHARGE 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.
CUM_DISCHARGE  "filename.cds"
file name File name to output cumulative overland discharge (m3) every HYD_FREQ minutes at locations specified in OVERLAND_Q_CUM_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 minutes.
OUT_THETA_LOCATION  "filename.otl"
file name Filename to output time series moisture data every HYD_FREQ minutes 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 minutes 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.

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 minnutes. Overland flow is replaced with channel flow if the OVERLAND_CHAN_DISCHARGE card is used.
CUM_DISCHARGE_MAP  [value]
filename or folder Filename or folder to output MAP_TYPE maps of the cumulative overland discharge (m3) every MAP_FREQ time steps. Overland flow is replaced with channel flow if the OVERLAND_CHAN_DISCHARGE card is used.
OVERLAND_CHAN_DISCHARGE  [value]
' Replace overland flow with channel flow in DISCHARGE and CUM_DISCHARGE_MAP maps.
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-1) 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-1) 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]
' Write channel discharge maps (m3/s) or CUM_DISCHARGE' maps (m3) 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-1) 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