User:Mburton/HydroGeoSphere Materials Dialog: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 1: Line 1:
__NOINDEX__
__NOINDEX__
{{Current development}}
{{Current development}}
HydroGeoSphere's Materials dialog is accessed by right-clicking on the simulation in the Project Explorer and selecting Materials from the menu. The left side of the dialog contains a table with columns for the name, the domain, and the zone. Each domain contains various inputs to define parameters, which appear on the right side of the Materials dialog.
HydroGeoSphere's ''Materials'' dialog is accessed by right-clicking on the simulation in the Project Explorer and selecting '''Materials''' from the menu. The left side of the dialog contains a table with columns for the name, the domain, and the zone. Each domain contains various inputs to define parameters, which appear on the right side of the ''Materials'' dialog. There are three domains available for the HydroGeoSphere model in GMS: porous media, surface flow, and ET (evapotranspiration).
[[File:HGS materials.png|thumb|500 px|HydroGeoSphere ''Materials'' dialog]]
[[File:HGS materials.png|thumb|500 px|HydroGeoSphere ''Materials'' dialog]]


==Domain: Porous Media==
==Domain: Porous Media==
The following options appear on the right side of the Materials dialog when Porous media is selected under the Domain column in the table on the left side of the dialog.
"Porous media" is the first domain option in the ''Materials'' dialog of the HydroGeoSphere model. The following options appear on the right side of the ''Materials'' dialog when "Porous media" is selected under the ''Domain'' column in the table on the left side of the dialog.
*Porous media
 
**K isotropic: isotropic hydraulic conductivity
'''Porous media'''
**K anisotropic: anisotropic hydraulic conductivity.
* ''K isotropic'' – isotropic hydraulic conductivity
***Kxx: diagonal terms of the hydraulic conductivity tensor.
* ''K anisotropic'' – anisotropic hydraulic conductivity
***Kyy: diagonal terms of the hydraulic conductivity tensor.
** ''Kxx'' – diagonal terms of the hydraulic conductivity tensor
***Kzz: diagonal terms of the hydraulic conductivity tensor.
** ''Kyy'' – diagonal terms of the hydraulic conductivity tensor
**Time dependent K for chosen elements: table defining time on and hydraulic conductivities in the x-, y-, and z- directions for each panel.
** ''Kzz'' – diagonal terms of the hydraulic conductivity tensor
**Specific storage
* ''Time dependent K for chosen elements'' – table defining time on and hydraulic conductivities in the x-, y-, and z- directions for each panel.
**Porosity
* ''Specific storage'' &ndash; default value of 1.0x10<sup>-4</sup>.
*Unsaturated tables or functions: choose either tables or functions to enter the unsaturated values.
* ''Porosity'' &ndash; default value of 0.375.
**Unsaturated tables
'''Unsaturated tables or functions''' &ndash; choose either tables or functions to enter the unsaturated values.
***Saturation-relative k: paired values of saturation and relative permeability entered in a table from lowest to highest saturation.
* ''Unsaturated tables''
***Pressure-saturation: paired values of pressure and saturation entered in a table from lowest pressure to highest pressure, usually zero.
** ''Saturation-relative k'' &ndash; paired values of saturation and relative permeability entered in a table from lowest to highest saturation.
*Unsaturated functions: two functions methods are available, which are brooks-corey and van genuchten. These are selected from a dropdown menu.
** ''Pressure-saturation'' &ndash; paired values of pressure and saturation entered in a table from lowest pressure to highest pressure, usually zero.
**brooks-corey
'''Unsaturated functions''' &ndash; two functions methods are available, which are brooks-corey and van genuchten. These are selected from a dropdown menu.
***Residual saturation: residual water saturation.
* ''brooks-corey''
***Alpha: for the brooks-corey function, this value is computed automatically from the air entry pressure.
** ''Residual saturation'' &ndash; residual water saturation.
***Beta: for the brooks-corey formulation
** ''Alpha'' &ndash; for the brooks-corey function, this value is computed automatically from the air entry pressure.
***Pore connectivity:
** ''Beta'' &ndash; for the brooks-corey formulation
***Air entry pressure
** ''Pore connectivity''
***Exponent
** ''Air entry pressure''
***Minimum relative permeability: during a simulation, the model will choose the maximum value for relative permeability between the minimum value specified here, and the value computed from the active function. This option may improve convergence of the nonlinear solution.
** ''Exponent''
***Table smoothness factor: smaller values cause more points to be generated for a smoother, more accurate table.
** ''Minimum relative permeability'' &ndash; during a simulation, the model will choose the maximum value for relative permeability between the minimum value specified here, and the value computed from the active function. This option may improve convergence of the nonlinear solution.
***Table minimum pressure: minimum pressure value in the pressure saturation table.
** ''Table smoothness factor'' &ndash; smaller values cause more points to be generated for a smoother, more accurate table.
***Table maximum s-k slope: maximum slope of the saturation-relative permeability curve when nearing the full saturation.
** ''Table minimum pressure'' &ndash; minimum pressure value in the pressure saturation table.
***Use tabulated unsaturated functions: generate tables from the functional constitutive relationships and causes grok to use those tables instead of the functions.
** ''Table maximum s-k slope'' &ndash; maximum slope of the saturation-relative permeability curve when nearing the full saturation.
**van genuchten
** ''Use tabulated unsaturated functions'' &ndash; generate tables from the functional constitutive relationships and causes grok to use those tables instead of the functions.
***Residual saturation: residual water saturation.
* ''van genuchten''
***Alpha
** ''Residual saturation'' &ndash; residual water saturation.
***Beta: for van genuchten this value must be greater than 1.0.
** ''Alpha''
***Pore connectivity: the default value of pore connectivity recommended for the van genuchten formulation is 0.5
** ''Beta'' &ndash; for van genuchten this value must be greater than 1.0.
***Minimum relative permeability: during a simulation, the model will choose the maximum value for relative permeability between the minimum value specified here, and the value computed from the active function. This option may improve convergence of the nonlinear solution.
** ''Pore connectivity'' &ndash; the default value of pore connectivity recommended for the van genuchten formulation is 0.5
***Table smoothness factor: smaller values cause more points to be generated for a smoother, more accurate table.
** ''Minimum relative permeability'' &ndash; during a simulation, the model will choose the maximum value for relative permeability between the minimum value specified here, and the value computed from the active function. This option may improve convergence of the nonlinear solution.
***Table minimum pressure: minimum pressure value in the pressure saturation table.
** ''Table smoothness factor'' &ndash; smaller values cause more points to be generated for a smoother, more accurate table.
***Table maximum s-k slope: maximum slope of the saturation-relative permeability curve when nearing the full saturation.
** ''Table minimum pressure'' &ndash; minimum pressure value in the pressure saturation table.
***Use tabulated unsaturated functions: generate tables from the functional constitutive relationships and causes grok to use those tables instead of the functions.
** ''Table maximum s-k slope'' &ndash; maximum slope of the saturation-relative permeability curve when nearing the full saturation.
** ''Use tabulated unsaturated functions'' &ndash; generate tables from the functional constitutive relationships and causes grok to use those tables instead of the functions.


==Domain: Surface Flow==
==Domain: Surface Flow==
The following options appear on the right side of the Materials dialog when Surface flow is selected under the Domain column in the table on the left side of the dialog.
"Surface flow" is the second domain option in the ''Materials'' dialog of the HydroGeoSphere model. The following options appear on the right side of the ''Materials'' dialog when "Surface flow" is selected under the ''Domain'' column in the table on the left side of the dialog.
*Surface flow
 
**X friction: friction factor in the X direction.
'''Surface flow'''
**Y friction: friction factor in the Y direciton.
* ''X friction'' &ndash; friction factor in the X direction.
**Time varying friction: import a table containing Time and Manning roughness coefficient.
* ''Y friction'' &ndash; friction factor in the Y direciton.
**Rill storage height: sets the minimum water depth required for flow.
* ''Time varying friction'' &ndash; import a table containing Time and Manning roughness coefficient.
**Obstruction storage height: defines the parameters for interaction between the channel domain and the overland flow and subsurface domains.
* ''Rill storage height'' &ndash; sets the minimum water depth required for flow.
**Coupling length
* ''Obstruction storage height'' &ndash; defines the parameters for interaction between the channel domain and the overland flow and subsurface domains.
**Maximum flow depth:
* ''Coupling length''
**Read rill storage from raster: import a raster file that computes the rill storage height form elevation values for each element in the surface layer of the mesh.
* ''Maximum flow depth''
**Scale factor: this option becomes available when ''Read rill storage from raster'' is selected.
* ''Read rill storage from raster'' &ndash; import a raster file that computes the rill storage height form elevation values for each element in the surface layer of the mesh.
* ''Scale factor'' &ndash; this option becomes available when ''Read rill storage from raster'' is selected.


==Domain: ET==
==Domain: ET==
The following options appear on the right side of the Materials dialog when ET is selected under the Domain column in the table on the left side of the dialog.
"ET", or evapotranspiration, is the third domain option in the ''Materials'' dialog of the HydroGeoSphere model. Evapotranspiration encompasses both the transpiration process from vegetation and the process of evaporation. The default properties for ET are representative of a grass cover. The following options appear on the right side of the ''Materials'' dialog when "ET" is selected under the ''Domain'' column in the table on the left side of the dialog.
*ET
 
**Evaporation depth
'''ET'''
**Potential evaporation using transpiration
* ''Evaporation depth'' &ndash; the default evaporation depth value is 0.2.
**EDF quadratic decay function: use the quadratic form of the evaporation function instead of the default, which is linear.
* ''Potential evaporation using transpiration''
**Root depth: maximum root depth.
* ''EDF quadratic decay function'' &ndash; use the quadratic form of the evaporation function instead of the default, which is linear.
**RDF table: relative depth and root length density.
* ''Root depth'' &ndash; maximum root depth.
**Time-root depth table
* ''RDF table'' &ndash; relative depth and root length density.
**RDF quadratic decay function: use the quadratic form of the root-depth function instead of the default, which is linear.
* ''Time-root depth table'' &ndash; a root depth time series table.
**LAI tables: paired values of time and leaf area index entered from earliest to latest time.
* ''RDF quadratic decay function'' &ndash; use the quadratic form of the root-depth function instead of the default, which is linear.
**Time varying LAI from raster: allows for time varying leaf area index values from a time-file table.
* ''LAI tables'' &ndash; paired values of time and leaf area index entered from earliest to latest time.
**Transpiration fitting parameters
* ''Time varying LAI from raster'' &ndash; allows for time varying leaf area index values from a time-file table.
***C_1
* ''Transpiration fitting parameters''
***C_2
** ''C_1'' &ndash; default value of 0.5.
***C_3
** ''C_2'' &ndash; default value of 0.0.
**Transpiration limiting pressure head
** ''C_3'' &ndash; default value of 1.0.
***Hwp_et
* ''Transpiration limiting pressure head''
***Hfc_et
** ''Hwp_et'' &ndash; pressure head at wilting point.
***Ho_et
** ''Hfc_et'' &ndash; pressure head at field capacity.
***Han_et
** ''Ho_et'' &ndash; pressure head at oxic limit.
**Evaporation limiting pressure head
** ''Han_et'' &ndash; pressure head at anoxic limit.
***He2_et
* ''Evaporation limiting pressure head''
***He1_et
** ''He2_et'' &ndash; pressure head below which evaporation is zero.
**Canopy storage parameter
** ''He1_et'' &ndash; pressure head above which full evaporation can occur.
**Canopy evaporation interval: controls the calculation of canopy evaporation by limiting the canopy evaporation rate over that time interval. The default value is zero.
* ''Canopy storage parameter'' &ndash; default value of 1.5.
**Initial interception storage: initial canopy interception storage value.
* ''Canopy evaporation interval'' &ndash; controls the calculation of canopy evaporation by limiting the canopy evaporation rate over that time interval. The default value is zero.
* ''Initial interception storage'' &ndash; initial canopy interception storage value. The default value is 1.5.




{{noindex}}
{{noindex}}
[[Category:HydroGeoSphere]]
[[Category:HydroGeoSphere]]

Revision as of 17:36, 21 September 2023

HydroGeoSphere's Materials dialog is accessed by right-clicking on the simulation in the Project Explorer and selecting Materials from the menu. The left side of the dialog contains a table with columns for the name, the domain, and the zone. Each domain contains various inputs to define parameters, which appear on the right side of the Materials dialog. There are three domains available for the HydroGeoSphere model in GMS: porous media, surface flow, and ET (evapotranspiration).

HydroGeoSphere Materials dialog

Domain: Porous Media

"Porous media" is the first domain option in the Materials dialog of the HydroGeoSphere model. The following options appear on the right side of the Materials dialog when "Porous media" is selected under the Domain column in the table on the left side of the dialog.

Porous media

  • K isotropic – isotropic hydraulic conductivity
  • K anisotropic – anisotropic hydraulic conductivity
    • Kxx – diagonal terms of the hydraulic conductivity tensor
    • Kyy – diagonal terms of the hydraulic conductivity tensor
    • Kzz – diagonal terms of the hydraulic conductivity tensor
  • Time dependent K for chosen elements – table defining time on and hydraulic conductivities in the x-, y-, and z- directions for each panel.
  • Specific storage – default value of 1.0x10-4.
  • Porosity – default value of 0.375.

Unsaturated tables or functions – choose either tables or functions to enter the unsaturated values.

  • Unsaturated tables
    • Saturation-relative k – paired values of saturation and relative permeability entered in a table from lowest to highest saturation.
    • Pressure-saturation – paired values of pressure and saturation entered in a table from lowest pressure to highest pressure, usually zero.

Unsaturated functions – two functions methods are available, which are brooks-corey and van genuchten. These are selected from a dropdown menu.

  • brooks-corey
    • Residual saturation – residual water saturation.
    • Alpha – for the brooks-corey function, this value is computed automatically from the air entry pressure.
    • Beta – for the brooks-corey formulation
    • Pore connectivity
    • Air entry pressure
    • Exponent
    • Minimum relative permeability – during a simulation, the model will choose the maximum value for relative permeability between the minimum value specified here, and the value computed from the active function. This option may improve convergence of the nonlinear solution.
    • Table smoothness factor – smaller values cause more points to be generated for a smoother, more accurate table.
    • Table minimum pressure – minimum pressure value in the pressure saturation table.
    • Table maximum s-k slope – maximum slope of the saturation-relative permeability curve when nearing the full saturation.
    • Use tabulated unsaturated functions – generate tables from the functional constitutive relationships and causes grok to use those tables instead of the functions.
  • van genuchten
    • Residual saturation – residual water saturation.
    • Alpha
    • Beta – for van genuchten this value must be greater than 1.0.
    • Pore connectivity – the default value of pore connectivity recommended for the van genuchten formulation is 0.5
    • Minimum relative permeability – during a simulation, the model will choose the maximum value for relative permeability between the minimum value specified here, and the value computed from the active function. This option may improve convergence of the nonlinear solution.
    • Table smoothness factor – smaller values cause more points to be generated for a smoother, more accurate table.
    • Table minimum pressure – minimum pressure value in the pressure saturation table.
    • Table maximum s-k slope – maximum slope of the saturation-relative permeability curve when nearing the full saturation.
    • Use tabulated unsaturated functions – generate tables from the functional constitutive relationships and causes grok to use those tables instead of the functions.

Domain: Surface Flow

"Surface flow" is the second domain option in the Materials dialog of the HydroGeoSphere model. The following options appear on the right side of the Materials dialog when "Surface flow" is selected under the Domain column in the table on the left side of the dialog.

Surface flow

  • X friction – friction factor in the X direction.
  • Y friction – friction factor in the Y direciton.
  • Time varying friction – import a table containing Time and Manning roughness coefficient.
  • Rill storage height – sets the minimum water depth required for flow.
  • Obstruction storage height – defines the parameters for interaction between the channel domain and the overland flow and subsurface domains.
  • Coupling length
  • Maximum flow depth
  • Read rill storage from raster – import a raster file that computes the rill storage height form elevation values for each element in the surface layer of the mesh.
  • Scale factor – this option becomes available when Read rill storage from raster is selected.

Domain: ET

"ET", or evapotranspiration, is the third domain option in the Materials dialog of the HydroGeoSphere model. Evapotranspiration encompasses both the transpiration process from vegetation and the process of evaporation. The default properties for ET are representative of a grass cover. The following options appear on the right side of the Materials dialog when "ET" is selected under the Domain column in the table on the left side of the dialog.

ET

  • Evaporation depth – the default evaporation depth value is 0.2.
  • Potential evaporation using transpiration
  • EDF quadratic decay function – use the quadratic form of the evaporation function instead of the default, which is linear.
  • Root depth – maximum root depth.
  • RDF table – relative depth and root length density.
  • Time-root depth table – a root depth time series table.
  • RDF quadratic decay function – use the quadratic form of the root-depth function instead of the default, which is linear.
  • LAI tables – paired values of time and leaf area index entered from earliest to latest time.
  • Time varying LAI from raster – allows for time varying leaf area index values from a time-file table.
  • Transpiration fitting parameters
    • C_1 – default value of 0.5.
    • C_2 – default value of 0.0.
    • C_3 – default value of 1.0.
  • Transpiration limiting pressure head
    • Hwp_et – pressure head at wilting point.
    • Hfc_et – pressure head at field capacity.
    • Ho_et – pressure head at oxic limit.
    • Han_et – pressure head at anoxic limit.
  • Evaporation limiting pressure head
    • He2_et – pressure head below which evaporation is zero.
    • He1_et – pressure head above which full evaporation can occur.
  • Canopy storage parameter – default value of 1.5.
  • Canopy evaporation interval – controls the calculation of canopy evaporation by limiting the canopy evaporation rate over that time interval. The default value is zero.
  • Initial interception storage – initial canopy interception storage value. The default value is 1.5.