WMS:GSSHA Job Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(rm related in template)
No edit summary
Line 1: Line 1:
The ''GSSHA Job Control Parameters'' dialog contains options and data for computational processes in a GSSHA simulation are specified. The only required process, which is always included in every GSSHA simulation, is overland flow.
{{TOC right}}
The ''GSSHA Job Control Parameters'' dialog contains options and data for computational processes in a GSSHA simulation. The only required process, which is always included in every GSSHA simulation, is overland flow.


[[Image:Dialog_GSSHA_Job_Control.png|thumb|500 px|''GSSHA Job Control Parameters'' dialog]]
There are five buttons at the bottom of the dialog:
*'''Help''' – Opens this page in a web browser.
*'''Output Control...''' – Opens the [[WMS:GSSHA Output Control|''GSSHA Output Control'' dialog]].
*'''Model Linkage...''' – Opens the [[WMS:GSSHA Model Linkage|''GSSHA Model Linkage'' dialog]].
*'''OK''' – Saves all changes made and exits the ''GSSHA Job Control Parameters'' dialog.
*'''Cancel''' – Discards all changes made and exits the ''GSSHA Job Control Parameters'' dialog.


===Computation Parameters (required)===
[[File:Dialog GSSHA Job Control.png|thumb|none|left|580 px|''GSSHA Job Control Parameters'' dialog]]
*Total Time (min)
**Total time (simulation duration) / time step = total number of time steps. (e.g. 1440 min (total time) / 20 sec (time step) = 4320 computational time steps)


*Time Step (seconds)
==Computation Parameters==
**Choosing an appropriate time step is critical to the success of the simulation. If the time step used is too large then excessive numerical averaging will take place, delaying simulation flows and possibly causing oscillating results. Too small of a time step will take an inordinate amount of time for the simulation to run to completion.
The ''Computation parameters'' section is required and has the following options:
**A time step that is evenly divisible into 60 sec must be chosen, i.e. 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30, or 60 seconds.
*''Total time (min)'' – An integer giving the total duration of the simulation in minutes.  
*''Time step (sec)'' – An integer giving the duration of each time step in the simulation in seconds. The time step must be evenly divisible into 60 seconds (e.g., 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30, or 60 seconds).


===Depth Varying Roughness===
The total number of time steps is determined by dividing the total time by the time step. For example, for a simulation with a total time of 1440 minutes and with a time step of 20 seconds, there would be 4320 total computational time steps. Choosing an appropriate time step is critical to the success of the simulation. If the time step used is too large, excessive numerical averaging will take place, delaying simulation flows and possibly causing oscillating results. Too small of a time step causes the simulation to take an inordinate amount of time to run to completion.
There is an option in the ''GSSHA Job Control'' dialog to define a depth-varying overland flow roughness mapping table, as shown below:


:[[Image:GsshaDepthVaryingRoughnessJobControl.png|thumb|none|left|500 px|GSSHA depth varying roughness option in the job control dialog]]
==Overland Flow==
The ''Overland flow'' section has the following options:
*''Computation method'' – A drop-down with the following options:
**"Explicit" – Completes most quickly, but is the least robust method.
**"ADE" – Alternating Direction Explicit method.
**"ADE-PC" – Alternating Direction Explicit Predictor-Corrector method. Completes most slowly, but is the most robust.
*''Interception'' – Turn on to specify the rainfall interception parameters using the [[WMS:GSSHA Mapping Tables#Interception|''Interception'' map table]].
*''Initial depth'' – If turned on, requires a continuous map of initial surface water depths, which WMS does not currently write.
*''Retention depth'' – Turn on to specify the surface water retention depth using the [[WMS:GSSHA Mapping Tables#Retention|''Retention'' map table]].
*''Area reduction'' – If turned on, requires  a table listing areal reduction of retention depth, which WMS does not currently write.
*''Depth varying roughness'' – If turned on, allows defining of a depth-varying overland flow [[WMS:GSSHA Mapping Tables#Roughness|''Roughness'' map table]]. If this option is turned on, a depth-varying overland flow [[WMS:GSSHA Mapping Tables#Roughness Exp|''Roughness exponent'']] must also be defined.


If this option is defined, define a mapping table specifying a depth-varying overland flow roughness exponent. This parameter is used in addition to the roughness mapping table, as shown below:
==Outlet Information==
The ''Outlet information'' section has the following options:
*''Column'' – An integer automatically computed by WMS representing the total number of columns in each raster map. Not user editable.
*''Row'' – An integer automatically computed by WMS representing the total number of rows in each raster map. Not user editable.
*''Slope'' – The slope of the cell containing the watershed outlet. This must be a positive decimal number.


:[[Image:GsshaDepthVaryingRoughnessIndexMap.png|thumb|none|left|500 px|GSSHA depth varying roughness table in the mapping table editor]]
==Evapotranspiration==
The ''Evapotranspiration'' section has the following options:
*''No evaporation'' – Select to not calculate any evapotranspiration.
*''Deardorff method'' – Select to calculate evapotranspiration using the Deardorff formula.
*''Penman method'' – Select to calculate evapotranspiration using the Penman-Montieth formula.
**''Seasonal resist.'' – Turn on to calculate canopy stomatal resistance of the canopy to transpiration at noon (s/m).


===Overland Flow===
==Infiltration==
*Overland Flow Computation Method '''(required)'''
The ''Infiltration'' section has the following options:
**The Explicit method is the fastest but least-robust method; the ADE-PC is the slowest, most-robust method
*''No infiltration'' – Select to not calculate any infiltration.
*''Green + Ampt with soil moisture redistribution'' –
**'''Help''' – Opens the [https://gsshawiki.com/Infiltration:Parameter_Estimates Infiltration:Parameter Estimates] page on the GSSHA Wiki.
**'''Sacramento Model...''' – Opens the [[#SAC-SMA Model Dialog|''SAC-SMA Model'' dialog]].
*''Richard's infiltration'' –
**'''Edit Parameters...''' – Opens the [[#Richard's Parameters Dialog|''Richard's Parameters'' dialog]].
*''Green + Ampt multi-layer'' –
*''Soil moisture depth (m)'' – A decimal depth value in meters.
*''Top layer depth (m)'' – A decimal depth value in meters.


*Overland Flow Modifiers '''(optional)'''
===SAC-SMA Model Dialog===
**Rainfall Interception – Specify the interception parameters using the Interception map table
[[File:WMS GSSHA SAC-SMA Model Dialog.png|thumb|right|300px|The GSSHA ''SAC-SMA Model'' dialog.]]
**Initial Surface Water Depth – Requires a continuous map of initial depths, which WMS does not currently write
This dialog is only accessible when ''Long term simulation'' is turned on in the other parameters section of the ''GSSHA Job Control Parameters'' dialog. When that option is turned on, select ''Green + Ampt with soil moisture redistribution'' in the Infiltration section and click '''Sacramento Model...'''.
**Surface Water Retention Depth – Specify the retention depth using the Retention map table
**Areal Reduction of Retention Depth – WMS does not currently write the data that GSSHA requires for this option


===Outlet Information (required)===
The ''SAC-SMA Model'' dialog has the following options:
*Outlet Cell Location (row, column) – WMS automatically computes these values
*''Define Sacramento''
*Outlet Slope
*''Parameters'' section
**''IDT''
**''UZTWM''
**''UZFWM''
**''LZTWM''
**''LZFSM''
**''LZFPM''
**''UZK''
**''LZPK''
**''LZSK''
**''ZPERC''
**''REXP''
**''PRFREE''
**''SIDE''
*''State Variables'' section
**''UZTWC''
**''UZFWC''
**''LZTWC''
**''LZFSC''
**''LZFPC''


===Evapotranspiration (optional)===
At the bottom are three buttons:
*Deardorff Formulation
*'''Help''' – Opens this section on this page in a web browser.
*Penman-Montieth Formulation
*'''OK''' – Saves all changes made and exits the ''SAC-SMA Model'' dialog.
*'''Cancel''' – Discards all changes made and exits the ''SAC-SMA Model'' dialog.


===Infiltration (optional)===
===Richard's Parameters Dialog===
*Green & Ampt
[[File:WMS GSSHA Richards Parameters Dialog.png|thumb|right|180px|The GSSHA ''Richard's Parameters'' dialog.]]
*Green & Ampt with Soil Moisture Redistribution
The ''Richard's Paramters'' dialog has the following options:
*Green & Ampt with a Long-Term Sacramento Soil Moisture Redistribution Function
*''Weight'' – A decimal value.
*Richard's Formulation for Soil Moisture Redistribution and Groundwater Processes
*''D THETA Max'' – A decimal value.
*''C Option'' – A drop-down with the following options:
**"Brooks" –
**"Havercamp" –
*''K Option'' – A drop-down with the following options:
**"Geometric" –
**"Arithmetic" –
*''Upper Option'' – A drop-down with the following options:
**"Normal" –
**"Green Ampt" –
**"Average" –
*''Max Iteration'' – An integer value for the maximum number of iteration.
*''Max num. cells'' – An integer value for the maximum number of cells.


===Channel/Stream Flow Routing (optional)===
At the bottom are two buttons:
*Diffusive Wave
*'''OK''' – Saves all changes made and exits the ''Richard's Paramters'' dialog.
*MESH – This option is for advanced users and is not fully supported in WMS. It is recommended to use the ''Diffusive Wave'' option instead.
*'''Cancel''' – Discards all changes made and exits the ''Richard's Paramters'' dialog.


===Other Processes/Options (optional)===
==Channel Routing Computation Scheme==
*[[WMS:GSSHA Groundwater|Groundwater (Subsurface)]]
The ''Channel routing computation scheme'' section has the following options:
*[[WMS:GSSHA Overland Soil Erosion|Soil Erosion]]
*''No routing'' –
*Long-Term Simulation of ET, Soil Moisture Redistribution (using hydrometeorological data)
*''Diffusive Wave'' – Clicking '''Edit Parameters...''' brings up the [[#GSSHA Channel Routing Parameters Dialog|''GSSHA Channel Routing Parameters'' dialog]].
*[[WMS:GSSHA Contaminants|Contaminant Transport]]
*''MESH'' –
*[[WMS:GSSHA Nutrients|Nutrients]]
 
*Storm/Tile Drains
===GSSHA Channel Routing Parameters Dialog===
*Stochastic – Use this option to write stochastic parameter files
[[File:WMS GSSHA Channel Routing Parameters Dialog.png|thumb|right|280px|The ''GSSHA Channel Routing Parameters' dialog.]]
*Link CE-QUAL-W2 Output – Use this option to write files linking CE-QUAL-W2 output to GSSHA
The ''GSSHA Channel Routing Parameters'' dialog is accessed by selecting ''Diffusive wave'' in the ''Channel routing computation scheme'' section of the ''GSSHA Job Control Parameters'' dialog, then clicking '''Edit Parameters...'''. It has the following options:
*[[WMS:GSSHA Manage Files|Manage Files]] – Used to manage the paths and filenames of all GSSHA input/output files
*Top section
**''Minimum flow'' – A decimal value in cms.
**''Allow overbank flow'' –
**''Allow overland backwater'' –
**''Outlet head BC'' – A decimal value in meters.
**''Create hot start file'' – Turn on to create a hot start file.
**''Start from hot start file'' – Turn on to specify a hot start file.
*''Channel erosion'' section
**''Sediment porosity'' – A decimal value.
**''Water temperature'' – A decimal value in degrees Celsius.
**''Sand size'' – A decimal value in millimeters.
*''Contaminant transport'' section
**''Compute contaminant transport'' –
**''Decay coefficient'' – A decimal value per day.
**''Dispersion coefficient'' &ndash; A decimal value in m<sup>2</sup> per second.
**''Initial concentration'' &ndash; A decimal value in milligrams per liter.
 
At the bottom are three buttons:
*'''Help''' &ndash; Opens this section on this page in a web browser.
*'''OK''' &ndash; Saves all changes made and exits the ''GSSHA Channel Routing Parameters'' dialog.
*'''Cancel''' &ndash; Discards all changes made and exits the ''GSSHA Channel Routing Parameters'' dialog.
{{-}}
==Other Parameters==
The other parameters section is not labelled and has the following options:
*''Groundwater'' &ndash; Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Groundwater#GSSHA Groundwater Dialog|''GSSHA Groundwater'' dialog]].
*''Soil erosion'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''Overland soil erosion'' dialog.
*''Long term simulation'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''Long Term Simulation'' dialog.
*''Snowmelt options'' &ndash; Click '''Edit parameters...''' to bring up the ''GSSHA Snowmelt Options'' dialog.
*''Contaminant transport'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''GSSHA Contaminants'' dialog.
*''Nutrients'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''Nutrients'' dialog.
*''Storm/tile drain'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''Storm/tile drain'' dialog.
*''Stochastic'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''GSSHA Batch Mode/Stochastics'' dialog.
*''Calibrate'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''Parameters'' dialog.
*''Link CE-QUAL-W2 Output'' &ndash; Turn on to link CE-QUAL-W2 output.
*''Manage files'' &ndash; Turn on and click '''Edit parameters...''' to bring up the ''Save GSSHA Project File'' dialog.





Revision as of 01:26, 27 April 2019


The GSSHA Job Control Parameters dialog contains options and data for computational processes in a GSSHA simulation. The only required process, which is always included in every GSSHA simulation, is overland flow.

There are five buttons at the bottom of the dialog:

  • Help – Opens this page in a web browser.
  • Output Control... – Opens the GSSHA Output Control dialog.
  • Model Linkage... – Opens the GSSHA Model Linkage dialog.
  • OK – Saves all changes made and exits the GSSHA Job Control Parameters dialog.
  • Cancel – Discards all changes made and exits the GSSHA Job Control Parameters dialog.
GSSHA Job Control Parameters dialog

Computation Parameters

The Computation parameters section is required and has the following options:

  • Total time (min) – An integer giving the total duration of the simulation in minutes.
  • Time step (sec) – An integer giving the duration of each time step in the simulation in seconds. The time step must be evenly divisible into 60 seconds (e.g., 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30, or 60 seconds).

The total number of time steps is determined by dividing the total time by the time step. For example, for a simulation with a total time of 1440 minutes and with a time step of 20 seconds, there would be 4320 total computational time steps. Choosing an appropriate time step is critical to the success of the simulation. If the time step used is too large, excessive numerical averaging will take place, delaying simulation flows and possibly causing oscillating results. Too small of a time step causes the simulation to take an inordinate amount of time to run to completion.

Overland Flow

The Overland flow section has the following options:

  • Computation method – A drop-down with the following options:
    • "Explicit" – Completes most quickly, but is the least robust method.
    • "ADE" – Alternating Direction Explicit method.
    • "ADE-PC" – Alternating Direction Explicit Predictor-Corrector method. Completes most slowly, but is the most robust.
  • Interception – Turn on to specify the rainfall interception parameters using the Interception map table.
  • Initial depth – If turned on, requires a continuous map of initial surface water depths, which WMS does not currently write.
  • Retention depth – Turn on to specify the surface water retention depth using the Retention map table.
  • Area reduction – If turned on, requires a table listing areal reduction of retention depth, which WMS does not currently write.
  • Depth varying roughness – If turned on, allows defining of a depth-varying overland flow Roughness map table. If this option is turned on, a depth-varying overland flow Roughness exponent must also be defined.

Outlet Information

The Outlet information section has the following options:

  • Column – An integer automatically computed by WMS representing the total number of columns in each raster map. Not user editable.
  • Row – An integer automatically computed by WMS representing the total number of rows in each raster map. Not user editable.
  • Slope – The slope of the cell containing the watershed outlet. This must be a positive decimal number.

Evapotranspiration

The Evapotranspiration section has the following options:

  • No evaporation – Select to not calculate any evapotranspiration.
  • Deardorff method – Select to calculate evapotranspiration using the Deardorff formula.
  • Penman method – Select to calculate evapotranspiration using the Penman-Montieth formula.
    • Seasonal resist. – Turn on to calculate canopy stomatal resistance of the canopy to transpiration at noon (s/m).

Infiltration

The Infiltration section has the following options:

  • No infiltration – Select to not calculate any infiltration.
  • Green + Ampt with soil moisture redistribution
  • Richard's infiltration
  • Green + Ampt multi-layer
  • Soil moisture depth (m) – A decimal depth value in meters.
  • Top layer depth (m) – A decimal depth value in meters.

SAC-SMA Model Dialog

The GSSHA SAC-SMA Model dialog.

This dialog is only accessible when Long term simulation is turned on in the other parameters section of the GSSHA Job Control Parameters dialog. When that option is turned on, select Green + Ampt with soil moisture redistribution in the Infiltration section and click Sacramento Model....

The SAC-SMA Model dialog has the following options:

  • Define Sacramento
  • Parameters section
    • IDT
    • UZTWM
    • UZFWM
    • LZTWM
    • LZFSM
    • LZFPM
    • UZK
    • LZPK
    • LZSK
    • ZPERC
    • REXP
    • PRFREE
    • SIDE
  • State Variables section
    • UZTWC
    • UZFWC
    • LZTWC
    • LZFSC
    • LZFPC

At the bottom are three buttons:

  • Help – Opens this section on this page in a web browser.
  • OK – Saves all changes made and exits the SAC-SMA Model dialog.
  • Cancel – Discards all changes made and exits the SAC-SMA Model dialog.

Richard's Parameters Dialog

The GSSHA Richard's Parameters dialog.

The Richard's Paramters dialog has the following options:

  • Weight – A decimal value.
  • D THETA Max – A decimal value.
  • C Option – A drop-down with the following options:
    • "Brooks" –
    • "Havercamp" –
  • K Option – A drop-down with the following options:
    • "Geometric" –
    • "Arithmetic" –
  • Upper Option – A drop-down with the following options:
    • "Normal" –
    • "Green Ampt" –
    • "Average" –
  • Max Iteration – An integer value for the maximum number of iteration.
  • Max num. cells – An integer value for the maximum number of cells.

At the bottom are two buttons:

  • OK – Saves all changes made and exits the Richard's Paramters dialog.
  • Cancel – Discards all changes made and exits the Richard's Paramters dialog.

Channel Routing Computation Scheme

The Channel routing computation scheme section has the following options:

GSSHA Channel Routing Parameters Dialog

The GSSHA Channel Routing Parameters' dialog.

The GSSHA Channel Routing Parameters dialog is accessed by selecting Diffusive wave in the Channel routing computation scheme section of the GSSHA Job Control Parameters dialog, then clicking Edit Parameters.... It has the following options:

  • Top section
    • Minimum flow – A decimal value in cms.
    • Allow overbank flow
    • Allow overland backwater
    • Outlet head BC – A decimal value in meters.
    • Create hot start file – Turn on to create a hot start file.
    • Start from hot start file – Turn on to specify a hot start file.
  • Channel erosion section
    • Sediment porosity – A decimal value.
    • Water temperature – A decimal value in degrees Celsius.
    • Sand size – A decimal value in millimeters.
  • Contaminant transport section
    • Compute contaminant transport
    • Decay coefficient – A decimal value per day.
    • Dispersion coefficient – A decimal value in m2 per second.
    • Initial concentration – A decimal value in milligrams per liter.

At the bottom are three buttons:

  • Help – Opens this section on this page in a web browser.
  • OK – Saves all changes made and exits the GSSHA Channel Routing Parameters dialog.
  • Cancel – Discards all changes made and exits the GSSHA Channel Routing Parameters dialog.


Other Parameters

The other parameters section is not labelled and has the following options:

  • Groundwater – Turn on and click Edit parameters... to bring up the GSSHA Groundwater dialog.
  • Soil erosion – Turn on and click Edit parameters... to bring up the Overland soil erosion dialog.
  • Long term simulation – Turn on and click Edit parameters... to bring up the Long Term Simulation dialog.
  • Snowmelt options – Click Edit parameters... to bring up the GSSHA Snowmelt Options dialog.
  • Contaminant transport – Turn on and click Edit parameters... to bring up the GSSHA Contaminants dialog.
  • Nutrients – Turn on and click Edit parameters... to bring up the Nutrients dialog.
  • Storm/tile drain – Turn on and click Edit parameters... to bring up the Storm/tile drain dialog.
  • Stochastic – Turn on and click Edit parameters... to bring up the GSSHA Batch Mode/Stochastics dialog.
  • Calibrate – Turn on and click Edit parameters... to bring up the Parameters dialog.
  • Link CE-QUAL-W2 Output – Turn on to link CE-QUAL-W2 output.
  • Manage files – Turn on and click Edit parameters... to bring up the Save GSSHA Project File dialog.