WMS:GSSHA Output Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 1: Line 1:
The ''Output Control'', accessible from the ''Job Control'' dialog, is where most of the output options for a GSSHA simulation are set. GSSHA can write out two types of datasets: grid based and link/node (point) based. All of these datasets will be read in to WMS, if they exist, as part of a GSSHA solution.   
{{TOC right}}
[[File:Dialog_GSSHA_Output_Control.png|thumb|right|360 px|''GSSHA Output Control'' dialog.]]
The ''GSSHA Output Control'' dialog is accessible by clicking '''Output Control...''' in the [[WMS:GSSHA Job Control|''Job Control'' dialog]]. Most of the output options for a GSSHA simulation are set in this dialog. GSSHA can write out two types of datasets: grid based and link/node (point) based. All of these datasets will be imported into to WMS, if they exist, as part of a GSSHA solution.   


[[File:Dialog_GSSHA_Output_Control.png|thumb|360 px|''GSSHA Output Control'' dialog.]]
At the bottom of the dialog are the following buttons:
*'''Help''' – Opens this article in a web browser.
*'''OK''' – Saves all changes and exits the ''GSSHA Output Control'' dialog.
*'''Cancel''' – Discards all changes and exits the ''GSSHA Output Control'' dialog.
 
Each section of the dialog is discussed below.


==Gridded Datasets==
==Gridded Datasets==
Because there are so many gridded datasets that GSSHA can output, they are separated into two categories: ''General'' and ''Nutrients – Overland''.
The ''Gridded datasets'' section includes a drop-down for selecting the ''data type'' and a list section where options can be turned on or off. Because there are so many gridded datasets that GSSHA can output, they are separated into two categories. The ''Data type'' drop-down allows for selecting between the two options: "General" and "Nutrients – Overland".
 
===General===
===General===
*Distributed Rainfall Intensity
*''Distributed rainfall intensity'' – Turn on to output distributed rainfall intensity data.
*Surface Depth – Depth of water on the overland flow plane
*''Surface depth'' – Turn on to output depth of water on the overland flow plane.
*Cumulative Infiltration Depth – If an infiltration option is turned on
*''Cumulative infiltration depth'' – Turn on if using an infiltration option.
*Infiltration Rate – If an infiltration option is turned on
*''Infiltration rate'' – Turn on if using an infiltration option.
*Surface Soil Moisture – If an infiltration option with soil moisture redistribution is turned on
*''Surface soil moisture'' – Turn on if using an infiltration option with soil moisture redistribution.
*Groundwater Elevations (Head)
*''Groundwater elevations'' – Head
*''Volume suspended sediment''
*''Incremental groundwater recharge'' –
*Sediment Flux – Maximum flux on the overland flow plane''
*''Cumulative groundwater recharge'' –
*Net Sediment Transfer – Erosion/deposition on the overland flow plane''
*''Suspended sediment concentration'' –
*Flood (max) Depth – Values in each grid cell may occur at different time steps
*''Sediment flux'' – Maximum flux on the overland flow plane
''WMS does not currently write the cards and file names associated with these output options to the GSSHA *.prj file.''
*''Net sediment transfer'' – Erosion/deposition on the overland flow plane
*''Flood (max) depth'' – Values in each grid cell may occur at different time steps
*''Snow water equivalent'' – Turn on to output the volumetric water equivalent from snow.


===Nutrients – Overland===
===Nutrients - Overland===
*Nitrite (NO2-)
*''Nitrite (NO2-)''
*Nitrate (NO3-)
*''Nitrate (NO3-)''
*Ammonium (NH4+)
*''Ammonium (NH4+)''
*Organic Nitrogen
*''Organic nitrogen''
*Organic Phosphorus
*''Organic phosphorus''
*Dissolved Phosphorus
*''Dissolved phosphorus''
*Algae
*''Algae''
*Carbonaceous BOD
*''Carbonaceous BOD''
*Dissolved Oxygen
*''Dissolved oxygen''


==Link/Node Datasets==
==Link/Node Datasets==
Link/node datasets report values at the nodes along the links of the GSSHA stream/channel network. The files are written in a format unique to GSSHA.
The ''Link/Node datasets'' section contains a list of output options that report values at the nodes along the links of the GSSHA stream/channel network. The files are written in a format unique to GSSHA.  
*Channel Depth
 
*Channel Flow
*''Channel depth''
*Channel Velocity (average)
*''Channel flow''
*Sediment Flux
*''Channel velocity (avg)''
*''Net Sediment Transfer''
*''Sediment flux''
*Flood (max) Depth
*''Net sediment transfer''
*Water Surface Elevation
*''Flood (max) depth''
*Pipe Flow
*''Water surface elevation''
*Pipe Node Depths
*''Pipe flow''
*Pipe Node Inflow/Outflow
*''Pipe node depths''
*Nitrite (NO2-)
*''Pipe node inflow/outflow''
*Nitrate (NO3-)
*''Nitrite (NO2-)''
*Ammonium (NH4+)
*''Nitrate (NO3-)''
*Organic Nitrogen
*''Ammonium (NH4+)''
*Organic Phosphorus
*''Organic nitrogen''
*Dissolved Phosphorus
*''Organic phosphorus''
*Algae
*''Dissolved phosphorus''
*CBOD
*''Algae''
*Dissolved Oxygen
*''CBOD''
''WMS does not currently write the cards and file names associated with these output options to the GSSHA *.prj file.''
*''Dissolved oxygen''


==Write Frequency==
==Write Frequency==
Specify how often to write output values to the grid and the link/node output files. GSSHA will output data for a gridded dataset after the first computational time step and then using the specified write frequency. For example, a 2 hour simulation with a time step of 30 seconds and a write frequency of 30 minutes will produce output at 30 seconds, 30 minutes 30 seconds, 60 minutes 30 seconds, and so on. Data for link/node datasets are output before the first computation time step (initial values) and then according to the specified write frequency. Using the previous example link/node data sets are written at 0 seconds, 30 minutes 0 seconds, 60 minutes 0 seconds, and so on.
The ''Write frequency'' section allows for specifying how often to write output values to the grid and the link/node output files. GSSHA will output data for a gridded dataset after the first computational time step and then using the specified write frequency. For example, a 2 hour simulation with a time step of 30 seconds and a write frequency of 30 minutes will produce output at 30 seconds, 30 minutes 30 seconds, 60 minutes 30 seconds, and so on. Data for link/node datasets are output before the first computation time step (initial values) and then according to the specified write frequency. Using the previous example, link/node data sets are written at 0 seconds, 30 minutes 0 seconds, 60 minutes 0 seconds, and so on.


==Gridded Dataset Output Format==
==Gridded Dataset Output Format==
*Binary
The ''Gridded dataset output format'' section allows for selection of the file format for the output files.
*ARC/INFO® ASCII
*''Binary'' – Outputs files in an encoded binary format.
*GRASS ASCII
*''ARC/INFO<sup>®</sup> ASCII'' &ndash; Outputs files in an ARC/INFO ASCII text format. Can be viewed with any text editor.
*XMDF
*''GRASS ASCII'' &ndash; Outputs files in a GRASS ASCII text format. Can be viewed with any text editor.
*''XMDF'' &ndash; Outputs files in the [[XMDF]] format.


==Hydrograph==
==Hydrograph==
GSSHA will output the outlet hydrograph to the *.otl file using the specified write frequency. Even though GSSHA performs all computations using metric units, it is possible to have GSSHA output flows to the outlet hydrograph file in either metric or English units.
The ''Hydrograph'' section allows specifying the write frequency and output units for outlet hydrographs. GSSHA will output the outlet hydrograph to the OTL file using the specified write frequency. Even though GSSHA performs all computations using metric units, it is possible to have GSSHA output flows to the outlet hydrograph file in either metric or English units.


==Other==
==Other==
*Suppress Screen Printing &ndash; This option will not show output at each computational time step while GSSHA is running, but can significantly reduce the runtime required for a GSSHA simulation. This option can also be selected in the ''GSSHA Run Options'' dialog.
The ''Other'' section contains a number of options that can be turned on or off:
*Strict Julian Dates &ndash; Write all dates to output files using strict Julian dates.
*''Suppress screen printing'' &ndash; Suppresses the output of runtime data from GSSHA at each time step, significantly reducing the overall run time required for a GSSHA simulation. This option can also be selected in the [[WMS:GSSHA#GSSHA Run Options|''GSSHA Run Options'' dialog]].
*''Suppress long term simulation printing'' &ndash; Suppresses the output of runtime data from GSSHA at each time step during a long term simulation, significantly reducing the overall run time.
*''Strict Julian dates'' &ndash; Write all dates to output files using [https://en.wikipedia.org/wiki/Julian_calendar strict Julian dates].
*''Output contaminants'' &ndash; Output contaminant information.




Line 75: Line 89:
[[Category:GSSHA Dialogs|Out]]
[[Category:GSSHA Dialogs|Out]]
[[Category:Exporting Data|gssha]]
[[Category:Exporting Data|gssha]]
[[Category:External Links]]

Revision as of 18:09, 17 May 2019


GSSHA Output Control dialog.

The GSSHA Output Control dialog is accessible by clicking Output Control... in the Job Control dialog. Most of the output options for a GSSHA simulation are set in this dialog. GSSHA can write out two types of datasets: grid based and link/node (point) based. All of these datasets will be imported into to WMS, if they exist, as part of a GSSHA solution.

At the bottom of the dialog are the following buttons:

  • Help – Opens this article in a web browser.
  • OK – Saves all changes and exits the GSSHA Output Control dialog.
  • Cancel – Discards all changes and exits the GSSHA Output Control dialog.

Each section of the dialog is discussed below.

Gridded Datasets

The Gridded datasets section includes a drop-down for selecting the data type and a list section where options can be turned on or off. Because there are so many gridded datasets that GSSHA can output, they are separated into two categories. The Data type drop-down allows for selecting between the two options: "General" and "Nutrients – Overland".

General

  • Distributed rainfall intensity – Turn on to output distributed rainfall intensity data.
  • Surface depth – Turn on to output depth of water on the overland flow plane.
  • Cumulative infiltration depth – Turn on if using an infiltration option.
  • Infiltration rate – Turn on if using an infiltration option.
  • Surface soil moisture – Turn on if using an infiltration option with soil moisture redistribution.
  • Groundwater elevations – Head
  • Incremental groundwater recharge
  • Cumulative groundwater recharge
  • Suspended sediment concentration
  • Sediment flux – Maximum flux on the overland flow plane
  • Net sediment transfer – Erosion/deposition on the overland flow plane
  • Flood (max) depth – Values in each grid cell may occur at different time steps
  • Snow water equivalent – Turn on to output the volumetric water equivalent from snow.

Nutrients - Overland

  • Nitrite (NO2-)
  • Nitrate (NO3-)
  • Ammonium (NH4+)
  • Organic nitrogen
  • Organic phosphorus
  • Dissolved phosphorus
  • Algae
  • Carbonaceous BOD
  • Dissolved oxygen

Link/Node Datasets

The Link/Node datasets section contains a list of output options that report values at the nodes along the links of the GSSHA stream/channel network. The files are written in a format unique to GSSHA.

  • Channel depth
  • Channel flow
  • Channel velocity (avg)
  • Sediment flux
  • Net sediment transfer
  • Flood (max) depth
  • Water surface elevation
  • Pipe flow
  • Pipe node depths
  • Pipe node inflow/outflow
  • Nitrite (NO2-)
  • Nitrate (NO3-)
  • Ammonium (NH4+)
  • Organic nitrogen
  • Organic phosphorus
  • Dissolved phosphorus
  • Algae
  • CBOD
  • Dissolved oxygen

Write Frequency

The Write frequency section allows for specifying how often to write output values to the grid and the link/node output files. GSSHA will output data for a gridded dataset after the first computational time step and then using the specified write frequency. For example, a 2 hour simulation with a time step of 30 seconds and a write frequency of 30 minutes will produce output at 30 seconds, 30 minutes 30 seconds, 60 minutes 30 seconds, and so on. Data for link/node datasets are output before the first computation time step (initial values) and then according to the specified write frequency. Using the previous example, link/node data sets are written at 0 seconds, 30 minutes 0 seconds, 60 minutes 0 seconds, and so on.

Gridded Dataset Output Format

The Gridded dataset output format section allows for selection of the file format for the output files.

  • Binary – Outputs files in an encoded binary format.
  • ARC/INFO® ASCII – Outputs files in an ARC/INFO ASCII text format. Can be viewed with any text editor.
  • GRASS ASCII – Outputs files in a GRASS ASCII text format. Can be viewed with any text editor.
  • XMDF – Outputs files in the XMDF format.

Hydrograph

The Hydrograph section allows specifying the write frequency and output units for outlet hydrographs. GSSHA will output the outlet hydrograph to the OTL file using the specified write frequency. Even though GSSHA performs all computations using metric units, it is possible to have GSSHA output flows to the outlet hydrograph file in either metric or English units.

Other

The Other section contains a number of options that can be turned on or off:

  • Suppress screen printing – Suppresses the output of runtime data from GSSHA at each time step, significantly reducing the overall run time required for a GSSHA simulation. This option can also be selected in the GSSHA Run Options dialog.
  • Suppress long term simulation printing – Suppresses the output of runtime data from GSSHA at each time step during a long term simulation, significantly reducing the overall run time.
  • Strict Julian dates – Write all dates to output files using strict Julian dates.
  • Output contaminants – Output contaminant information.