WMS:GSSHA Output Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(27 intermediate revisions by 3 users not shown)
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 data sets 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.   


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.


[[Image:Dialog_GSSHA_Output_Control.png]]
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".


==Gridded Datasets==
Because there are so many gridded datasets that GSSHA can output, they are separated into two categories: 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'' – Displays channel depth in channel cells if channel routing is performed.
*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'' – Soil volumetric water content Turn on if using an infiltration option with soil moisture redistribution.
*Groundwater Elevations (Head)
*''Groundwater elevations'' – Top elevation of groundwater (head elevation).
*''Volume suspended sediment''
*''Incremental groundwater recharge'' – Turn on to output the groundwater recharge rate over time.
*Sediment Flux – maximum flux on the overland flow plane''
*''Cumulative groundwater recharge'' – Turn on to output the total groundwater recharge for the simulation.
*Net Sediment Transfer – erosion/deposition on the overland flow plane''
*''Suspended sediment concentration'' – Volume of suspended sediments
*Flood (max) Depth – values in each grid cell may occur at different time steps
*''Sediment flux'' – Maximum flux on the overland flow plane. Turn on to see flux.
''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. Turn on to see amounts.
*''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-)
Common nutrient contaminants that can be accounted for in the model.
*Nitrate (NO3-)
*''Nitrite (NO2-)'' – Widely used compound used throughout the chemical and pharmaceutical industries
*Ammonium (NH4+)
*''Nitrate (NO3-)'' – A compound of nitrogen and oxygen naturally found in air, soil, water, and some food.
*Organic Nitrogen
*''Ammonium (NH4+)'' – Modified form of ammonia with an extra hydrogen atom.
*Organic Phosphorus
*''Organic nitrogen'' – Nitrogen compounds found in nature.
*Dissolved Phosphorus
*''Organic phosphorus'' – Naturally occurring phosphorus.
*Algae
*''Dissolved phosphorus'' – The amount of phosphorus in water.
*Carbonaceous BOD
*''Algae'' – Microscopic organisms that live in aquatic environments and use photosynthesis to produce energy from sunlight
*Dissolved Oxygen
*''Carbonaceous BOD'' – Represents oxygen demand associated with biodegradation of organic constituents of a wastewater.
*''Dissolved oxygen'' – The amount of free oxygen in water


==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 for time steps created by the write frequency. The files are written in a format unique to GSSHA.  
*Channel Depth
 
*Channel Flow
*''Channel depth'' – Creates output file for channel depth.
*Channel Velocity (average)
*''Channel flow'' – Creates output file for channel flow.
*Sediment Flux
*''Channel velocity (avg)'' – Creates output file for average channel velocity.
*''Net Sediment Transfer''
*''Sediment flux'' – Creates output file for the sediment flux changes.
*Flood (max) Depth
*''Net sediment transfer'' – Creates output file for the net sediment transfer amounts.
*Water Surface Elevation
*''Flood (max) depth'' – Creates output file for the maximum flood depth.
*Pipe Flow
*''Water surface elevation'' –  Creates output file for the water surface elevation.
*Pipe Node Depths
*''Pipe flow'' – Creates output file for the pipe flow amounts.
*Pipe Node Inflow/Outflow
*''Pipe node depths'' – Creates output file for the pipe node depths.
*Nitrite (NO2-)
*''Pipe node inflow/outflow'' – Creates output file for the pipe node inflow/outflow amounts.
*Nitrate (NO3-)
*''Nitrite (NO2-)'' – Creates output file for the nitrite (NO2-) amounts.
*Ammonium (NH4+)
*''Nitrate (NO3-)'' – Creates output file for the nitrate (NO3-) amounts.
*Organic Nitrogen
*''Ammonium (NH4+)'' – Creates output file for the ammonium (NH4+) amounts.
*Organic Phosphorus
*''Organic nitrogen'' – Creates output file for the organic nitrogen amounts.
*Dissolved Phosphorus
*''Organic phosphorus'' – Creates output file for the organic phosphorus amounts.
*Algae
*''Dissolved phosphorus'' – Creates output file for the dissolved phosphorus amounts.
*CBOD
*''Algae'' – Creates output file for the algae amounts.
*Dissolved Oxygen
*''CBOD'' – Creates output file for the CBOD amounts.
''WMS does not currently write the cards and file names associated with these output options to the GSSHA *.prj file.''
*''Dissolved oxygen'' – Creates output file for the dissolved oxygen amounts.


==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.
==Related Topics==
*''Strict Julian dates'' &ndash; Write all dates to output files using [https://en.wikipedia.org/wiki/Julian_calendar strict Julian dates].
* [[WMS:GSSHA Job Control|GSSHA Job Control]]
*''Output contaminants'' &ndash; Output contaminant information.
* [[WMS:GSSHA|GSSHA Overview]]
* [[WMS:GSSHA Read Solution|GSSHA Read Solution]]
 
{{GSSHAMain


|PLinks=
* [http://gsshawiki.com/index.php?title=Post-Processing:Post-Processing Post-Processing]
** [http://gsshawiki.com/index.php?title=Post-Processing:Output_control Output Control]


|GUMLinks=
{{GSSHA Wiki}}
* [http://gsshawiki.com/index.php?title=Output:Output Output]
{{WMSMain}}


}}
[[Category:GSSHA|O]]
[[Category:GSSHA Dialogs|Out]]
[[Category:Exporting Data|gssha]]
[[Category:External Links]]

Latest revision as of 18:30, 25 July 2024


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 – Displays channel depth in channel cells if channel routing is performed.
  • Cumulative infiltration depth – Turn on if using an infiltration option.
  • Infiltration rate – Turn on if using an infiltration option.
  • Surface soil moisture – Soil volumetric water content Turn on if using an infiltration option with soil moisture redistribution.
  • Groundwater elevations – Top elevation of groundwater (head elevation).
  • Incremental groundwater recharge – Turn on to output the groundwater recharge rate over time.
  • Cumulative groundwater recharge – Turn on to output the total groundwater recharge for the simulation.
  • Suspended sediment concentration – Volume of suspended sediments
  • Sediment flux – Maximum flux on the overland flow plane. Turn on to see flux.
  • Net sediment transfer – Erosion/deposition on the overland flow plane. Turn on to see amounts.
  • 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

Common nutrient contaminants that can be accounted for in the model.

  • Nitrite (NO2-) – Widely used compound used throughout the chemical and pharmaceutical industries
  • Nitrate (NO3-) – A compound of nitrogen and oxygen naturally found in air, soil, water, and some food.
  • Ammonium (NH4+) – Modified form of ammonia with an extra hydrogen atom.
  • Organic nitrogen – Nitrogen compounds found in nature.
  • Organic phosphorus – Naturally occurring phosphorus.
  • Dissolved phosphorus – The amount of phosphorus in water.
  • Algae – Microscopic organisms that live in aquatic environments and use photosynthesis to produce energy from sunlight
  • Carbonaceous BOD – Represents oxygen demand associated with biodegradation of organic constituents of a wastewater.
  • Dissolved oxygen – The amount of free oxygen in water

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 for time steps created by the write frequency. The files are written in a format unique to GSSHA.

  • Channel depth – Creates output file for channel depth.
  • Channel flow – Creates output file for channel flow.
  • Channel velocity (avg) – Creates output file for average channel velocity.
  • Sediment flux – Creates output file for the sediment flux changes.
  • Net sediment transfer – Creates output file for the net sediment transfer amounts.
  • Flood (max) depth – Creates output file for the maximum flood depth.
  • Water surface elevation – Creates output file for the water surface elevation.
  • Pipe flow – Creates output file for the pipe flow amounts.
  • Pipe node depths – Creates output file for the pipe node depths.
  • Pipe node inflow/outflow – Creates output file for the pipe node inflow/outflow amounts.
  • Nitrite (NO2-) – Creates output file for the nitrite (NO2-) amounts.
  • Nitrate (NO3-) – Creates output file for the nitrate (NO3-) amounts.
  • Ammonium (NH4+) – Creates output file for the ammonium (NH4+) amounts.
  • Organic nitrogen – Creates output file for the organic nitrogen amounts.
  • Organic phosphorus – Creates output file for the organic phosphorus amounts.
  • Dissolved phosphorus – Creates output file for the dissolved phosphorus amounts.
  • Algae – Creates output file for the algae amounts.
  • CBOD – Creates output file for the CBOD amounts.
  • Dissolved oxygen – Creates output file for the dissolved oxygen amounts.

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.