WMS:GSSHA Mapping Tables

The GSSHA Map Table Editor dialog allows editing of the mapping tables for all of the spatially distributed parameters for options specified in the GSSHA Job Control dialog. The mapping tables relate parameter sets for each process to an index map that shows their spatial distribution.

There are tabs for each of these parameter sets. Some of the tabs require the option to have been turned on in the GSSHA Job Control dialog. If the tab is selected and the option has not been turned on there, a warning dialog will appear to ask if the option should be turned on.

The following buttons are always found at the bottom of the dialog, regardless of which tab is selected:

• Import Table... – Brings up the Open dialog where a CMT file (GSSHA Mapping Table File) can be selected and imported.
• Export Table... – Brings up the Enter the GSSHA Mapping Table file name dialog where the data from the selected tab can be exported as a CMT file.
• Job Control – Brings up the GSSHA Job Control dialog.

Roughness

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Index map type – A drop-down list of index map types in the project. Select the desired type.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Surface roughness – A Manning's n value.

GSSHA Map Table Editor dialog showing the Roughness tab

Roughness Exp

GSSHA Map Table Editor dialog showing the Roughness Exp tab

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Roughness exponent –

Interception

GSSHA Map Table Editor dialog showing the Interception tab

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Storage capacity – An initial quantity of rainfall (in millimeters) that is entirely intercepted by foliage.
• Interception coeff – A unitless number with a range between "0.0" and "1.0". This is the fraction of rainfall retained as intercepted water after satisfying the storage capacity.

Retention

GSSHA Map Table Editor dialog showing the Retention tab

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Retention depth – Specifies distributed retention depth (mm) over the index map.

Evapotranspiration

GSSHA Map Table Editor dialog showing the Evapotranspiration tab

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Land-surface albedo – A dimensionless number with a range between "0.0" and "1.0". Fraction of radiation reflected back to the atmosphere.
• Vegetation height – Height of the vegetation in meters.
• Vegetation radiation coeff – A unitless number with a range between "0.0" and "1.0". Direct solar radiation penetrating the vegetation canopy and reaching the ground.
• Canopy stomatal resistance – Resistance of the canopy to transpiration at noon (s/m).

Infiltration

GSSHA Map Table Editor dialog showing the Infiltration tab

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Hydraulic conductivity – Typical value of "0.01" to "2.0", given in cm/hr. The saturated hydraulic conductivity, or K_s, is the rate at which water will enter the soil under unit head and saturated conditions.
• Capillary head – Typical value of "10.0" to "100.0", given in cm. The capillary suction head, or Ψ_f, is a measure of the combined adhesive forces that bind the water molecules to solid walls and the cohesive forces that attract water molecules to each other.
• Porosity – Also known as θ_s. The volume of voids/total volume of soil. A decimal fraction between "0.0" and "1.0", in m³/m³.
• Pore distribution index – The pore index value, λ, in cm/cm.
• Residual saturation – The water content of air dry soil, or θ_r. A decimal fraction between "0.0" and "1.0", in m³/m³.
• Field capacity – Also known as θ_f.
• Wilting point – A fraction between residual saturation and porosity (θ_wp), water content below which plants cannot uptake water from the soil.

Initial Moisture

GSSHA Map Table Editor dialog showing the Initial Moisture tab

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Initial moisture – Also known as θ_i. A decimal fraction obtained by subtracting θ_s from θ_r, in m³/m³.

Area Reduction

GSSHA Map Table Editor dialog showing the Area Reduction tab

The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Impervious area fraction – Reduces the potential infiltration by the specified fraction. A unitless number with a range of "0.0" to "1.0".

Soil Erosion

GSSHA Map Table Editor dialog showing the Soil Erosion tab

This tab requires the Soil erosion option be turned on in the GSSHA Job Control dialog. The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Coefficient for detachment by rainfall – A function of rainfall intensity, or J^-1, and determined by this equation: d_i = K_I C_w C_G C_i I^β.
• Rill erodibility coefficient – A dimensionless number a in the equation shown here, expressed as s/m. Surface runoff detaches soil particles by exerting a shear stress that breaks the bonds between particles. Erosion in rills is lumped and described as gross rill erosion. Within a grid cell, rill erosion and flow are assumed to be uniformly distributed.
• Rill erodibility exponent – A dimensionless number b used in this equation.
• Critical rill detachment – Expressed as τ or "Pa" used in this equation.
• Erodibility coefficient – A dimensionless number K used in equation 108 here. A combined factor with a range of "0.0" to "1.0" that consists of the combined influence of soil erodibility, vegetation, and land-use.

Contaminants

GSSHA Map Table Editor dialog showing the Contaminants tab

This tab requires the Contaminant transport option be turned on in the GSSHA Job Control dialog. The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Contaminant – A drop-down listing of all available contaminants in the project. Contaminants are defined in the GSSHA Contaminants dialog.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Dispersion – The overland dispersion coefficient, expressed in m²/s.
• Decay (per day) – The soil and overland decay coefficient.
• Uptake – The overland uptake coefficient, expressed in m/day.
• Soil concentration – The overland loading, expressed in mg/kg of soil.
• Groundwater concentration – The concentration of the contaminant in groundwater, expressed in mg/l of groundwater.
• Initial concentration – The initial concentration of the contaminant, expressed in mg/l.
• Soil water concentration – The soil water partition in the soil, expressed in mg/l of soil water.
• Max concentration/solubility – The maximum concentration (or solubility) of the contaminant, expressed in mg/l.

Nutrients

GSSHA Map Table Editor dialog showing the Nutrients tab

This tab requires the Nutrients option be turned on in the GSSHA Job Control dialog. The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Index map type – A drop-down listing of map types available. The option selected here affects what is shown in the Using index map drop-down. Select the desired map type from the list.
• Map Table – A drop-down listing all available map tables in the project. The option selected here affects what is shown in the spreadsheet section of this tab.
  • "Aquatic kinetic constants"
  • "Dispersion"
  • "Nitrogen initial conditions"
  • "Phosphorous initial conditions"
  • "Carbon initial conditions"
  • "Other initial conditions"
  • "Dry bulk densities"
  • "Soil nitrogen initial conditions"
  • "Soil phosphorous initial conditions"
  • "Soil carbon initial conditions"
  • "Soil uptake rates"
  • "Soil/water partitioning"
  • "Groundwater nitrogen initial conditions"
  • "Groundwater phosphorous initial conditions"
  • "Groundwater carbon initial conditions"
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. Depending on which options is selected in the Map Tables drop-down, the options change:

• "Aquatic kinetic constants" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Dispersion" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Nitrogen initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Phosphorous initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Carbon initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Other initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Dry bulk densities" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Soil nitrogen initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Soil phosphorous initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Soil carbon initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Soil uptake rates" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Soil/water partitioning" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Groundwater nitrogen initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Groundwater phosphorous initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• "Groundwater carbon initial conditions" options
  • ID – A unique type ID.
  • Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
  • Description2 – An optional alphanumeric field. Enter additional concise descriptive information.

Continuous Maps

GSSHA Map Table Editor dialog showing the Continuous Maps tab

Each of the options on the tab can be turned on or off. The drop-down in the Dataset column lists all the "Continuous Maps" datasets in the project. The following options are available on this tab:

• Roughness
• Roughness exponent
• Storage capacity
• Hydraulic conductivity
• Capillary head
• Initial soil moisture
• Pore index
• Residual saturation
• Wilting point
• Canopy resistance
• Vegetation radiation coeff
• Vegetation height
• Albedo
• Field capacity

Groundwater

GSSHA Map Table Editor dialog showing the Groundwater tab

This tab requires the Groundwater option be turned on in the GSSHA Job Control dialog. The following options are available on this tab:

• Using index map – A drop-down listing all available index maps in the project. Select the desired index map from the list.
• Generate IDs – Generates a list of IDs from those found in the selected index map.
• Add ID – Adds a new ID to the spreadsheet, allowing manual creation of a new ID.
• Delete ID – Immediately deletes the selected ID.

The spreadsheet displays all of the IDs in the selected index map, one per column. It has the following rows:

• ID – A unique type ID.
• Description1 – An alphanumeric field. Enter a concise descriptive name for the ID type.
• Description2 – An optional alphanumeric field. Enter additional concise descriptive information.
• Hydraulic Conductivity – A value given in cm/hr. The saturated hydraulic conductivity, or K_s, is the rate at which water will enter the soil under unit head and saturated conditions.
• Porosity – The volume of voids/total volume of soil. A decimal fraction between "0.0" and "1.0", in m³/m³.