User:Mburton/HydroGeoSphere Materials Dialog: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(6 intermediate revisions by 2 users not shown)
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 ID. Each domain contains various inputs to define parameters, which appear on the right side of the ''Materials'' dialog. There are three material 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==
==Porous Media Domain==
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. Each element that is assigned the zone ID number corelated with the porous media domain will be assigned a porous media material, the attributes of which are set in the ''Materials'' dialog. 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
*'''Porous media'''
**K isotropic: isotropic hydraulic conductivity
** ''K isotropic'' – Isotropic hydraulic conductivity
**K anisotropic: anisotropic hydraulic conductivity.
** ''K anisotropic'' – Anisotropic hydraulic conductivity
***Kxx: diagonal terms of the hydraulic conductivity tensor.
** ''Kxx'' – Diagonal terms of the hydraulic conductivity tensor
***Kyy: diagonal terms of the hydraulic conductivity tensor.
*** ''Kyy'' – Diagonal terms of the hydraulic conductivity tensor
***Kzz: 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.
** ''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
** ''Specific storage'' &ndash; Default value of 1.0x10<sup>-4</sup>
**Porosity
** ''Porosity'' &ndash; Default value of 0.375
*Unsaturated tables or functions: choose either tables or functions to enter the unsaturated values.
*'''Unsaturated tables or functions''' &ndash; Choose either tables or functions to enter the unsaturated values.
**Unsaturated tables
** ''Unsaturated tables''
***Saturation-relative k: paired values of saturation and relative permeability entered in a table from lowest to highest saturation.
*** ''Saturation-relative k'' &ndash; 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.
*** ''Pressure-saturation'' &ndash; 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.
*'''Unsaturated functions''' &ndash; Two functions methods are available, which are brooks-corey and van genuchten. These are selected from a dropdown menu.
**brooks-corey
** ''brooks-corey''
***Residual saturation: residual water saturation.
*** ''Residual saturation'' &ndash; Residual water saturation
***Alpha: for the brooks-corey function, this value is computed automatically from the air entry pressure.
*** ''Alpha'' &ndash; For the brooks-corey function, this value is computed automatically from the air entry pressure.
***Beta: for the brooks-corey formulation
*** ''Beta''
***Pore connectivity:
*** ''Pore connectivity''
***Air entry pressure
*** ''Air entry pressure''
***Exponent
*** ''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.
*** ''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 smoothness factor: smaller values cause more points to be generated for a smoother, more accurate table.
*** ''Table smoothness factor'' &ndash; 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 minimum pressure'' &ndash; 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.
*** ''Table maximum s-k slope'' &ndash; 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.
*** ''Use tabulated unsaturated functions'' &ndash; Generate tables from the functional constitutive relationships and causes grok to use those tables instead of the functions.
**van genuchten
** ''van genuchten''
***Residual saturation: residual water saturation.
*** ''Residual saturation'' &ndash; Residual water saturation
***Alpha
*** ''Alpha''
***Beta: for van genuchten this value must be greater than 1.0.
*** ''Beta'' &ndash; 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
*** ''Pore connectivity'' &ndash; 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.
*** ''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 smoothness factor: smaller values cause more points to be generated for a smoother, more accurate table.
*** ''Table smoothness factor'' &ndash; 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 minimum pressure'' &ndash; 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.
*** ''Table maximum s-k slope'' &ndash; 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.
*** ''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==
==Surface Flow Domain==
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. Each element that is assigned the zone ID number corelated with the surface flow domain will be assigned a surface flow material, the attributes of which are set in the ''Materials'' dialog. 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
*'''Surface flow'''
**X friction: friction factor in the X direction.
** ''X friction'' &ndash; Friction factor in the X direction
**Y friction: friction factor in the Y direciton.
** ''Y friction'' &ndash; Friction factor in the Y direciton
**Time varying friction: import a table containing Time and Manning roughness coefficient.
** ''Time varying friction'' &ndash; Import a table containing Time and Manning roughness coefficient
**Rill storage height: sets the minimum water depth required for flow.
** ''Rill storage height'' &ndash; 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.
** ''Obstruction storage height'' &ndash; Defines the parameters for interaction between the channel domain and the overland flow and subsurface domains
**Coupling length
** ''Coupling length''
**Maximum flow depth:
** ''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.
** ''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: this option becomes available when ''Read rill storage from raster'' is selected.
** ''Scale factor'' &ndash; This option becomes available when ''Read rill storage from raster'' is selected


==Domain: ET==
==ET Domain==
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. Each element that is assigned the zone ID number corelated with the ET domain will be assigned an ET material, the attributes of which are set in the ''Materials'' dialog. 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
*'''ET'''
**Evaporation depth
** ''Evaporation depth'' &ndash; The default evaporation depth value is 0.2
**Potential evaporation using transpiration
** ''Potential evaporation using transpiration''
**EDF quadratic decay function: use the quadratic form of the evaporation function instead of the default, which is linear.
** ''EDF quadratic decay function'' &ndash; Use the quadratic form of the evaporation function instead of the default, which is linear
**Root depth: maximum root depth.
** ''Root depth'' &ndash; Maximum root depth
**RDF table: relative depth and root length density.
** ''RDF table'' &ndash; Relative depth and root length density
**Time-root depth table
** ''Time-root depth table'' &ndash; 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.
** ''RDF quadratic decay function'' &ndash; 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.
** ''LAI tables'' &ndash; 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.
** ''Time varying LAI from raster'' &ndash; Allows for time varying leaf area index values from a time-file table
**Transpiration fitting parameters
** ''Transpiration fitting parameters''
***C_1
*** ''C_1'' &ndash; Default value of 0.5
***C_2
*** ''C_2'' &ndash; Default value of 0.0
***C_3
*** ''C_3'' &ndash; Default value of 1.0
**Transpiration limiting pressure head
** ''Transpiration limiting pressure head''
***Hwp_et
*** ''Hwp_et'' &ndash; Pressure head at wilting point
***Hfc_et
*** ''Hfc_et'' &ndash; Pressure head at field capacity
***Ho_et
*** ''Ho_et'' &ndash; Pressure head at oxic limit
***Han_et
*** ''Han_et'' &ndash; Pressure head at anoxic limit
**Evaporation limiting pressure head
** ''Evaporation limiting pressure head''
***He2_et
*** ''He2_et'' &ndash; Pressure head below which evaporation is zero
***He1_et
*** ''He1_et'' &ndash; Pressure head above which full evaporation can occur
**Canopy storage parameter
** ''Canopy storage parameter'' &ndash; 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.
** ''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: initial canopy interception storage value.
** ''Initial interception storage'' &ndash; Initial canopy interception storage value. The default value is 1.5




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

Latest revision as of 19:33, 26 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 ID. Each domain contains various inputs to define parameters, which appear on the right side of the Materials dialog. There are three material domains available for the HydroGeoSphere model in GMS: porous media, surface flow, and ET (evapotranspiration).

HydroGeoSphere Materials dialog

Porous Media Domain

"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. Each element that is assigned the zone ID number corelated with the porous media domain will be assigned a porous media material, the attributes of which are set in the Materials dialog. 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
      • 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

Surface Flow Domain

"Surface flow" is the second domain option in the Materials dialog of the HydroGeoSphere model. Each element that is assigned the zone ID number corelated with the surface flow domain will be assigned a surface flow material, the attributes of which are set in the Materials dialog. 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

ET Domain

"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. Each element that is assigned the zone ID number corelated with the ET domain will be assigned an ET material, the attributes of which are set in the Materials dialog. 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