WMS:GSSHA Maps: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(19 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Index Maps==
{{TOC right}}
[[Image:Dialog_GSSHA_Maps.png|thumb|300 px|''GSSHA Maps'' dialog showing the ''Index - Grid'' tab]]
The ''GSSHA Maps'' dialog allows for setting various options and parameters for how index maps (for both grids and streams) and continuous maps are used in GSSHA simulations. The dialog is accessed by switching to the '''2D Grid''' [[File:2D Grid Icon.svg|16px]] module and selecting ''GSSHA'' | '''Maps...''' to bring up the dialog.
 
This dialog has three tabs:
*''Index – Grid'' – For index maps associated with grids.
*''Index – Stream'' – For index maps associated with streams.
*''Continuous – Grid'' – For continuous maps associated with grids.
 
At the bottom of the dialog are two buttons:
*'''Help''' – Clicking this button opens this page in a web browser.
*'''Done''' – Saves any changes and exits the ''GSSHA Maps'' dialog.
 
==Grid Index Maps==
[[File:WMS GSSHA Maps dialog Index Grid tab.png|thumb|300 px|''GSSHA Maps'' dialog showing the ''Index – Grid'' tab]]
The ''Index – Grid'' tab has the following sections and options:
*''Compute index using WMS coverages''
**''Input coverage (1)'' – A drop-down menu of applicable coverages in the project.
**''Coverage attribute'' – A drop-down menu of attributes to which the first coverage will be associated.
**''Input coverage (2)'' – Turn on to activate a second drop-down menu of applicable coverages in the project. Optional.
**''Coverage attribute'' – A drop-down menu of attributes to which the second coverage will be associated. Only accessible if ''Input coverage (2)'' is turned on.
**''Index map name'' – An alphanumeric field where the name of the new index map can be entered.
**'''Coverages→Index Map''' – Clicking this button maps the selected coverages to the new index map.
*''Compute index using data calculator (uniform map)'' section – Clicking '''Data Calculator...''' brings up the ''[[Data Calculator]]'' dialog.
 
One of the greatest assets of distributed hydrologic models like GSSHA is the ability to spatially distribute the parameters for processes, such as overland flow and infiltration, over the watershed. Assigning values, grid cell by grid cell, is tedious and makes all but the simplest and smallest models impossible. Using WMS, GIS coverages (layers) representing land use and soil texture can be used to assign model parameter values to groups of grid cells sharing the same characteristics.
One of the greatest assets of distributed hydrologic models like GSSHA is the ability to spatially distribute the parameters for processes, such as overland flow and infiltration, over the watershed. Assigning values, grid cell by grid cell, is tedious and makes all but the simplest and smallest models impossible. Using WMS, GIS coverages (layers) representing land use and soil texture can be used to assign model parameter values to groups of grid cells sharing the same characteristics.


The basic process of assigning spatially distributed parameters consists of the following steps:
The basic process of assigning spatially distributed parameters consists of the following steps:
 
*Import a GIS coverage for land use, soil texture, or vegetation type (generally, this should be in the ArcView® shapefile format).
*Import a GIS coverage for land use, soil texture, or vegetation type (generally this should be in the ArcView® shapefile format).
*Map the land use, soil texture, or vegetation ID to the grid cells using a spatial overlay operation.
*Map the land use, soil texture, or vegetation ID to the grid cells using a spatial overlay operation.
*Define parameter values (e.g., surface roughness, hydraulic conductivity, etc.) for the unique ID numbers.
*Define parameter values (e.g., surface roughness, hydraulic conductivity, etc.) for the unique ID numbers.
Line 11: Line 32:
A given soil texture/land use (STLU) index map can be used to assign multiple parameters. Since most of the grid cell parameters can be referenced to either land use or soil properties, a given simulation generally requires only a single index map of each. A combination land use and soil texture index map makes it possible to relate a parameter value to the combination of land use and soil texture (for example infiltration or erosion). Once the index maps are defined, parameter values are assigned to the IDs of the index maps. The combination of the index maps, with ID numbers, and the mapping tables, with the parameter values, are used by GSSHA to internally assign parameter values to each grid cell.  
A given soil texture/land use (STLU) index map can be used to assign multiple parameters. Since most of the grid cell parameters can be referenced to either land use or soil properties, a given simulation generally requires only a single index map of each. A combination land use and soil texture index map makes it possible to relate a parameter value to the combination of land use and soil texture (for example infiltration or erosion). Once the index maps are defined, parameter values are assigned to the IDs of the index maps. The combination of the index maps, with ID numbers, and the mapping tables, with the parameter values, are used by GSSHA to internally assign parameter values to each grid cell.  


The principle means of modifying and creating index maps is in the ''Index Map'' dialog but the index maps are now also able to be accessed through the ''Project Explorer''. When an index map has been created or read into WMS a folder appears in the ''Project Explorer'', named ''Index Maps'', that contains all of the index maps for the simulation. Index maps can then be treated like regular datasets; they can be contoured, renamed, deleted, and edited.
The principle means of modifying and creating index maps is in the ''Index Map'' dialog but the index maps are now also able to be accessed through the Project Explorer. When an index map has been created or imported into WMS a folder appears in the Project Explorer, named ''Index Maps'', that contains all of the index maps for the simulation. Index maps can then be treated like regular datasets; they can be contoured, renamed, deleted, and edited.
 
==Stream Index Maps==
[[File:WMS GSSHA Maps dialog Index Stream tab.png|thumb|right|300 px|''GSSHA Maps'' dialog showing the ''Index – Stream'' tab]]
The ''Index – Stream'' tab has the following sections and options:
*'''Add''' – Add a new stream index column.
*'''Delete''' – Immediately delete the selected stream index column.
*''Show'' – Drop-down menu with the following options:
**"All" – Show all stream arcs.
**"Selected" – Show only selected stream arcs.


==Continuous Maps==
Sometimes, a project might have a stream-based index map instead of a grid-based index map. When defining a stream index map, define an index value greater than zero for each link in the model. There is not currently an option to automatically define stream index map values from grid or map module data.  
[[Image:Dialog GSSHA Maps3.png|thumb|300 px]]
Some GSSHA input parameters change from cell to cell and cannot be characterized using index maps. Continuous maps, which are stored as [[WMS:Datasets|datasets]] of a 2D grid in WMS, are used where index maps are not appropriate. Examples of GSSHA input parameters that use continuous maps include soil properties for the groundwater processes and ground surface, bedrock, and water table elevations. Contours for each of the continuous maps are displayed on the 2D grid according to the contour options selected for the dataset. Continuous maps are specified as GSSHA input in either the Sub-surface Parameters (Groundwater) dialog or in the ''Continuous Maps'' tab of the [[WMS:GSSHA Mapping Tables|GSSHA Map Table Editor]] dialog.


The ''Continuous – Grid'' tab of the ''GSSHA Maps'' dialog has three options for generating continuous maps:
Turn on stream link IDs by opening the [[WMS:Display Options|''Display Options'' dialog]], selecting "Map Data" from the list on the left, and turning on ''Stream Link Numbers'' on the ''Map'' tab. Next, assign index values to each of the stream links in the model. Then use stream index maps to define Manning's roughness, nutrient values, and other values in the [[WMS:GSSHA Mapping Tables|''GSSHA Map Table Editor'' dialog]].
{{-}}
==Grid Continuous Maps==
[[File:WMS GSSHA Maps dialog Continuous Grid tab.png|thumb|300 px|''GSSHA Maps'' dialog showing the ''Continuous – Grid'' tab]]
Some GSSHA input parameters change from cell to cell and cannot be characterized using index maps. Continuous maps, which are stored as [[WMS:Datasets|datasets]] of a 2D grid in WMS, are used where index maps are not appropriate.


*Using GIS Data: Select an input coverage and attribute. Enter a name for the continuous map in the dataset name field.  Click the '''GIS Data → Dataset''' button to create the dataset.
Examples of GSSHA input parameters that use continuous maps include soil properties for the groundwater processes and ground surface, bedrock, and water table elevations. Contours for each of the continuous maps are displayed on the 2D grid according to the contour options selected for the dataset. Continuous maps are specified as GSSHA input in either the [[WMS:GSSHA Groundwater#GSSHA Groundwater Dialog|''GSSHA Groundwater'' dialog]] or in the ''Continuous Maps'' tab of the [[WMS:GSSHA Mapping Tables|''GSSHA Map Table Editor'']] dialog.
*Using the ''Data Calculator'': This option is useful for mathematically manipulating existing continuous maps. Click the '''Data Caluclator...''' button to open the ''Data Calculator'' window.
*Reclassification: Reclassify index map values to create a continuous map, if appropriate. Click the '''Reclassify Index Map→Dataset...''' button to begin.


==Stream Index Maps==
There are three section which allow generating continuous maps using different methods:
Sometimes, you might have a stream-based index map instead of a grid-based index map. When you define a stream index map, define an index value greater than zero to each link in your model. There is not currently an option to automatically define stream index map values from grid or map module data. You can turn on the stream link IDs in the ''Display Options'' dialog and define an index for each of these IDs. You can assign index values to each of the stream links in your model.  You can then use stream index maps to define Manning's roughness, nutrient values, and other values in the ''GSSHA Map Table Editor''.
*''Compute values using GIS data'' section
[[Image:Dialog GSSHA Maps2.png|thumb|none|left|300 px]]
**''Input coverage'' – Select an input coverage from the drop-down.
**''Coverage attribute'' – Select the desired coverage attribute from the drop-down.
**''Dataset name'' – Alphanumeric field. Enter the desired name for the new continuous map.
**'''GIS Data → Dataset''' – After the above three fields have been specified, click this button to create the new continuous map dataset.
*''Compute values using data calculator'' – Click '''Data Calculator...''' to bring up the ''[[Data Calculator]]'' dialog. This option is useful for mathematically manipulating existing continuous maps.
*'''Reclassify Index Map → Dataset...''' – Clicking this button brings up the [[#Reclassify Index Map Dialog|''Reclassify Index Map'' dialog]].


==Related Topics==
{{-}}
* [[WMS:GSSHA|GSSHA Overview]]
===Reclassify Index Map Dialog===
[[File:WMS Reclassify Index Map Dialog.png|thumb|180 px|''Reclassify Index Map'' dialog]]
The ''Reclassify Index Map'' dialog is accessed via the '''Reclassify Index Map → Dataset...''' button on the ''Continuous – Grid'' tab of the ''GSSHA Maps'' dialog. It allows non-destructive (the original index map is retained) reclassification of index map values to create a new continuous map. It has the following options:
*''Index map'' – Drop-down of all available index maps within the GSSHA project. Select the desired index map to reclassify.
*Spreadsheet – The spreadsheet has ''Id'' and ''Value'' columns. The data displayed varies, depending on the index map selected from the above drop-down.
*''Result'' – Alphanumeric field. Enter the desired name for the new continuous map.
*'''Reclassify''' – Click this button to create the new continuous map based on the options selected above.


{{GSSHAMain
There are two additional buttons at the bottom of the ''Reclassify Index Map'' dialog:
*'''Help''' – Clicking this button will open this article in a web browser.
*'''Done''' – Closes the ''Reclassify Index Map'' dialog.


|PLinks=
* [http://gsshawiki.com/index.php?title=Mapping:Assigning_Parameter_Values_to_Individual_Grid_Cells Assigning Parameter Values to Individual Grid Cells]
** [http://gsshawiki.com/index.php?title=Mapping:Index_maps Index Maps]


|GUMLinks=
{{GSSHA Wiki}}
* [http://gsshawiki.com/index.php?title=Mapping_Table:Mapping_Table_File Mapping Table File]
{{WMSMain}}
** [http://gsshawiki.com/index.php?title=Mapping_Table:Index_Maps Index Maps]


}}
[[Category:GSSHA|M]]
[[Category:GSSHA Dialogs|Maps]]

Latest revision as of 22:05, 9 May 2019


The GSSHA Maps dialog allows for setting various options and parameters for how index maps (for both grids and streams) and continuous maps are used in GSSHA simulations. The dialog is accessed by switching to the 2D Grid 2D Grid Icon.svg module and selecting GSSHA | Maps... to bring up the dialog.

This dialog has three tabs:

  • Index – Grid – For index maps associated with grids.
  • Index – Stream – For index maps associated with streams.
  • Continuous – Grid – For continuous maps associated with grids.

At the bottom of the dialog are two buttons:

  • Help – Clicking this button opens this page in a web browser.
  • Done – Saves any changes and exits the GSSHA Maps dialog.

Grid Index Maps

GSSHA Maps dialog showing the Index – Grid tab

The Index – Grid tab has the following sections and options:

  • Compute index using WMS coverages
    • Input coverage (1) – A drop-down menu of applicable coverages in the project.
    • Coverage attribute – A drop-down menu of attributes to which the first coverage will be associated.
    • Input coverage (2) – Turn on to activate a second drop-down menu of applicable coverages in the project. Optional.
    • Coverage attribute – A drop-down menu of attributes to which the second coverage will be associated. Only accessible if Input coverage (2) is turned on.
    • Index map name – An alphanumeric field where the name of the new index map can be entered.
    • Coverages→Index Map – Clicking this button maps the selected coverages to the new index map.
  • Compute index using data calculator (uniform map) section – Clicking Data Calculator... brings up the Data Calculator dialog.

One of the greatest assets of distributed hydrologic models like GSSHA is the ability to spatially distribute the parameters for processes, such as overland flow and infiltration, over the watershed. Assigning values, grid cell by grid cell, is tedious and makes all but the simplest and smallest models impossible. Using WMS, GIS coverages (layers) representing land use and soil texture can be used to assign model parameter values to groups of grid cells sharing the same characteristics.

The basic process of assigning spatially distributed parameters consists of the following steps:

  • Import a GIS coverage for land use, soil texture, or vegetation type (generally, this should be in the ArcView® shapefile format).
  • Map the land use, soil texture, or vegetation ID to the grid cells using a spatial overlay operation.
  • Define parameter values (e.g., surface roughness, hydraulic conductivity, etc.) for the unique ID numbers.

A given soil texture/land use (STLU) index map can be used to assign multiple parameters. Since most of the grid cell parameters can be referenced to either land use or soil properties, a given simulation generally requires only a single index map of each. A combination land use and soil texture index map makes it possible to relate a parameter value to the combination of land use and soil texture (for example infiltration or erosion). Once the index maps are defined, parameter values are assigned to the IDs of the index maps. The combination of the index maps, with ID numbers, and the mapping tables, with the parameter values, are used by GSSHA to internally assign parameter values to each grid cell.

The principle means of modifying and creating index maps is in the Index Map dialog but the index maps are now also able to be accessed through the Project Explorer. When an index map has been created or imported into WMS a folder appears in the Project Explorer, named Index Maps, that contains all of the index maps for the simulation. Index maps can then be treated like regular datasets; they can be contoured, renamed, deleted, and edited.

Stream Index Maps

GSSHA Maps dialog showing the Index – Stream tab

The Index – Stream tab has the following sections and options:

  • Add – Add a new stream index column.
  • Delete – Immediately delete the selected stream index column.
  • Show – Drop-down menu with the following options:
    • "All" – Show all stream arcs.
    • "Selected" – Show only selected stream arcs.

Sometimes, a project might have a stream-based index map instead of a grid-based index map. When defining a stream index map, define an index value greater than zero for each link in the model. There is not currently an option to automatically define stream index map values from grid or map module data.

Turn on stream link IDs by opening the Display Options dialog, selecting "Map Data" from the list on the left, and turning on Stream Link Numbers on the Map tab. Next, assign index values to each of the stream links in the model. Then use stream index maps to define Manning's roughness, nutrient values, and other values in the GSSHA Map Table Editor dialog.

Grid Continuous Maps

GSSHA Maps dialog showing the Continuous – Grid tab

Some GSSHA input parameters change from cell to cell and cannot be characterized using index maps. Continuous maps, which are stored as datasets of a 2D grid in WMS, are used where index maps are not appropriate.

Examples of GSSHA input parameters that use continuous maps include soil properties for the groundwater processes and ground surface, bedrock, and water table elevations. Contours for each of the continuous maps are displayed on the 2D grid according to the contour options selected for the dataset. Continuous maps are specified as GSSHA input in either the GSSHA Groundwater dialog or in the Continuous Maps tab of the GSSHA Map Table Editor dialog.

There are three section which allow generating continuous maps using different methods:

  • Compute values using GIS data section
    • Input coverage – Select an input coverage from the drop-down.
    • Coverage attribute – Select the desired coverage attribute from the drop-down.
    • Dataset name – Alphanumeric field. Enter the desired name for the new continuous map.
    • GIS Data → Dataset – After the above three fields have been specified, click this button to create the new continuous map dataset.
  • Compute values using data calculator – Click Data Calculator... to bring up the Data Calculator dialog. This option is useful for mathematically manipulating existing continuous maps.
  • Reclassify Index Map → Dataset... – Clicking this button brings up the Reclassify Index Map dialog.


Reclassify Index Map Dialog

Reclassify Index Map dialog

The Reclassify Index Map dialog is accessed via the Reclassify Index Map → Dataset... button on the Continuous – Grid tab of the GSSHA Maps dialog. It allows non-destructive (the original index map is retained) reclassification of index map values to create a new continuous map. It has the following options:

  • Index map – Drop-down of all available index maps within the GSSHA project. Select the desired index map to reclassify.
  • Spreadsheet – The spreadsheet has Id and Value columns. The data displayed varies, depending on the index map selected from the above drop-down.
  • Result – Alphanumeric field. Enter the desired name for the new continuous map.
  • Reclassify – Click this button to create the new continuous map based on the options selected above.

There are two additional buttons at the bottom of the Reclassify Index Map dialog:

  • Help – Clicking this button will open this article in a web browser.
  • Done – Closes the Reclassify Index Map dialog.