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

From Gsshawiki
Jump to: navigation, search
(β†’β€Ž3.12.2 Optional Output)
 
 
(8 intermediate revisions by one other user not shown)
Line 1: Line 1:
βˆ’
==3.12.1 Required Output==
+
==3.13.1 Required Output==
  
 
{| class="thin" width=700px
 
{| class="thin" width=700px
Line 10: Line 10:
 
|}
 
|}
  
βˆ’
==3.12.2 Optional Output==
+
==3.13.2 Optional Output==
  
 
{| class="thin" width=700px
 
{| class="thin" width=700px
Line 29: Line 29:
 
| <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. Requires '''SOIL_EROSION'''.
+
| <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. 
 +
  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.   
+
| <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>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_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''' time steps at locations specified in '''OVERLAND_WSE_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''' time steps.
Line 40: Line 50:
 
|-  
 
|-  
 
| <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''' time steps 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>IN_GWFLUX_LOCATION  "filename.igf"</pre> || ''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'''.
 +
|-
 +
| <pre>OUT_GWFLUX_LOCATION  "filename.ogf"</pre> || ''file name'' || File name to ouput stream groundwater exchange flus (m<sup>2</sup> s<sup>-1</sup>) 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'''.
 
|-
 
|-
 
| <pre>OUT_CON_LOCATION  "filename.ocl"</pre> || ''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'''.
 
| <pre>OUT_CON_LOCATION  "filename.ocl"</pre> || ''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'''.
 
|-
 
|-
βˆ’
| <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_LOC''' 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>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>STRICT_JULIAN_DATE</pre> || ''none'' || All time series data are output with strict Julian date.
 
| <pre>STRICT_JULIAN_DATE</pre> || ''none'' || All time series data are output with strict Julian date.
 
|-  
 
|-  
Line 53: Line 67:
 
| <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>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>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_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'''.
Line 60: Line 74:
 
|}
 
|}
  
βˆ’
==3.12.3 Optional Output Maps ==
+
==3.13.3 Optional Output Maps ==
  
 
{| class="thin" width=700px
 
{| class="thin" width=700px

Latest revision as of 16:52, 24 June 2013

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.  
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.
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.
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


Retrieved from ""