WMS:GSSHA Job Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(23 intermediate revisions by 3 users not shown)
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'' – Useful for simulating multiple rainfall events in a series.
**'''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'' – Most complete method to simulate soil water movement in the unsaturated zone.
**'''Edit Parameters...''' – Opens the [[#Richard's Parameters Dialog|''Richard's Parameters'' dialog]].
*''Green + Ampt multi-layer'' – Used for modeling varying soil conditions through different layers.
*''Soil moisture depth (m)'' – Tells how deep the moisture penetrates. A decimal depth value in meters.
*''Top layer depth (m)'' – Tells how deep the top layer of soil is. 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'' – Maximum upper zone tension water (mm)
**''UZFWM'' – Maximum upper zone free water (mm)
**''LZTWM'' – Maximum lower zone tension water (mm)
**''LZFSM'' – Maximum lower zone free water, secondary  (mm)
**''LZFPM'' – Maximum lower zone free water, primary (mm)
**''UZK'' – Upper zone recession coefficient
**''LZPK'' – Lower zone recession coefficient, primary
**''LZSK'' – Lower zone recession coefficient, secondary
**''ZPERC'' – Minimum percolation rate coefficient
**''REXP'' – Percolation equation exponent
**''PRFREE'' – Percent percolating directly to lower zone free water (percent in decimal)
**''SIDE'' – Portion of the baseflow which does not go to the stream (percent in decimal)
*''State Variables'' section
**''UZTWC'' – Upper zone tension water contents
**''UZFWC'' – Upper zone free water contents
**''LZTWC'' – Lower zone tension water contents
**''LZFSC'' – Lower zone free primary zone contents
**''LZFPC'' – Lower zone free supplemental zone contents


===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'' – Fraction between 0.0 and 1.0 (dimensionless).
*Richard's Formulation for Soil Moisture Redistribution and Groundwater Processes
*''D THETA Max'' – The maximum allowable water content change in any finite difference cell during a single time-step. A positive decimal value. Default is 0.025.
*''C Option'' – Sets the curves used to define the relationships between water content and soil suction, pressure, and water content and hydraulic conductivity. A drop-down with the following options:
**"Brooks" – Method for estimating relative hydraulic activity.
**"Havercamp" – Method for calculating relative hydraulic activity.
*''K Option'' – The method used to calculate inter-cell hydraulic conductivities. Choose from the drop-down with the following options:
**"Geometric" – Geometric average.
**"Arithmetic" – Arithmetic weighting of values.
*''Upper Option'' – Method used to determine the hydraulic conductivity at the soil surface during ponded water conditions. A drop-down with the following options:
**"Normal" – Specifies that the normal cell-centered value of hydraulic conductivity be used.
**"Green Ampt" – Specifies that the saturated hydraulic conductivity of the soil in the cell be used.
**"Average" – Specifies that an average of the two other options be used.
*''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
*'''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'' – Only surface runoff calculations are performed.
*Long-Term Simulation of ET, Soil Moisture Redistribution (using hydrometeorological data)
*''Diffusive Wave'' – Clicking '''Edit Parameters...''' brings up the [[WMS:GSSHA Channel Routing#GSSHA Channel Routing Parameters Dialog|''GSSHA Channel Routing Parameters'' dialog]].
*[[WMS:GSSHA Contaminants|Contaminant Transport]]
*''MESH'' – Method of channel routing computation.
*[[WMS:GSSHA Nutrients|Nutrients]]
*Storm/Tile Drains
*Stochastic – use this option to write stochastic parameter files
*Link CE-QUAL-W2 Output – use this option to write files linking CE-QUAL-W2 output to GSSHA
*[[WMS:GSSHA Manage Files|Manage Files]] – use to manage the paths and filenames of all GSSHA input/output files


==Related Topics==
==Other Parameters==
* [[WMS:GSSHA|GSSHA Overview]]
{{anchor|Other Options}}The other parameters section is not labelled and has the following options:
* [[WMS:GSSHA Output Control|GSSHA Output Control]]
*''Groundwater'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Groundwater#GSSHA Groundwater Dialog|''GSSHA Groundwater'' dialog]].
* [[WMS:GSSHA Precipitation|GSSHA Precipitation]]
*''Soil erosion'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Overland Soil Erosion#Overland Soil Erosion Dialog|''Overland soil erosion'' dialog]].
*''Long term simulation'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:Long Term Simulation Dialog|''Long Term Simulation'' dialog]].
*''Snowmelt options'' – Click '''Edit parameters...''' to bring up the [[WMS:GSSHA Snowmelt Options Dialog|''GSSHA Snowmelt Options'' dialog]].
*''Contaminant transport'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Contaminants|''GSSHA Contaminants'' dialog]].
*''Nutrients'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Nutrients|''Nutrients'' dialog]].
*''Storm/tile drain'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Storm Drain|''Storm/tile drain'' dialog]].
*''Stochastic'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Batch Mode/Stochastics Dialog|''GSSHA Batch Mode/Stochastics'' dialog]].
*''Calibrate'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:GSSHA Automated Calibration#|''Parameters'' dialog]].
*''Link CE-QUAL-W2 Output'' – Turn on to link [[WMS:CE-QUAL-W2|CE-QUAL-W2]] output.
*''Manage files'' – Turn on and click '''Edit parameters...''' to bring up the [[WMS:Save GSSHA Project File|''Save GSSHA Project File'' dialog]].


{{GSSHAMain


|PLinks=
{{GSSHA Wiki}}
* [http://gsshawiki.com/index.php?title=Overview:Overview Overview]
{{WMSMain}}
** [http://gsshawiki.com/index.php?title=Overview:Modeling_process Modeling Process]
 
|GUMLinks=
* [http://gsshawiki.com/index.php?title=Model_Construction:Building_a_Basic_GSSHA_Simulation Building a Basic GSSHA Simulation]
 
}}


[[Category:GSSHA|J]]
[[Category:GSSHA|J]]
[[Category:GSSHA Dialogs]]
[[Category:GSSHA Dialogs|Job]]
[[Category:WMS Job Control|GSSHA]]

Latest revision as of 16:37, 25 July 2024


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 – Useful for simulating multiple rainfall events in a series.
  • Richard's infiltration – Most complete method to simulate soil water movement in the unsaturated zone.
  • Green + Ampt multi-layer – Used for modeling varying soil conditions through different layers.
  • Soil moisture depth (m) – Tells how deep the moisture penetrates. A decimal depth value in meters.
  • Top layer depth (m) – Tells how deep the top layer of soil is. 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 – Maximum upper zone tension water (mm)
    • UZFWM – Maximum upper zone free water (mm)
    • LZTWM – Maximum lower zone tension water (mm)
    • LZFSM – Maximum lower zone free water, secondary (mm)
    • LZFPM – Maximum lower zone free water, primary (mm)
    • UZK – Upper zone recession coefficient
    • LZPK – Lower zone recession coefficient, primary
    • LZSK – Lower zone recession coefficient, secondary
    • ZPERC – Minimum percolation rate coefficient
    • REXP – Percolation equation exponent
    • PRFREE – Percent percolating directly to lower zone free water (percent in decimal)
    • SIDE – Portion of the baseflow which does not go to the stream (percent in decimal)
  • State Variables section
    • UZTWC – Upper zone tension water contents
    • UZFWC – Upper zone free water contents
    • LZTWC – Lower zone tension water contents
    • LZFSC – Lower zone free primary zone contents
    • LZFPC – Lower zone free supplemental zone contents

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 – Fraction between 0.0 and 1.0 (dimensionless).
  • D THETA Max – The maximum allowable water content change in any finite difference cell during a single time-step. A positive decimal value. Default is 0.025.
  • C Option – Sets the curves used to define the relationships between water content and soil suction, pressure, and water content and hydraulic conductivity. A drop-down with the following options:
    • "Brooks" – Method for estimating relative hydraulic activity.
    • "Havercamp" – Method for calculating relative hydraulic activity.
  • K Option – The method used to calculate inter-cell hydraulic conductivities. Choose from the drop-down with the following options:
    • "Geometric" – Geometric average.
    • "Arithmetic" – Arithmetic weighting of values.
  • Upper Option – Method used to determine the hydraulic conductivity at the soil surface during ponded water conditions. A drop-down with the following options:
    • "Normal" – Specifies that the normal cell-centered value of hydraulic conductivity be used.
    • "Green Ampt" – Specifies that the saturated hydraulic conductivity of the soil in the cell be used.
    • "Average" – Specifies that an average of the two other options be used.
  • 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:

  • No routing – Only surface runoff calculations are performed.
  • Diffusive Wave – Clicking Edit Parameters... brings up the GSSHA Channel Routing Parameters dialog.
  • MESH – Method of channel routing computation.

Other Parameters

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