WMS:GSSHA Multiple Simulations

From XMS Wiki
Revision as of 00:25, 16 May 2019 by Jmonson (talk | contribs)
Jump to navigationJump to search


Multiple GSSHA simulations using the same 2D grid can be managed within a single instance of WMS. The simulations are displayed in the Project Explorer, where it is possible to edit the job control, precipitation, GSSHA coverage, index maps, and continuous maps.

GSSHA Simulations

WMS Project Explorer showing two GSSHA simulations.

There are several different types of entries within a GSSHA simulation. Many of the options available under the GSSHA menu are also found in the right-click menu of the GSSHA project in the Project Explorer.

Note that:

  • Selecting an item from the GSSHA menu performs the desired option on the active simulation.
  • Selecting an item from the right-click menu performs the desired option on the corresponding simulation (this can be done even if the simulation is not active).

Below are common functions available through either of those methods.

Job Control

Selecting Job Control... from the GSSHA menu brings up the Job Control Parameters dialog for the active GSSHA simulation. This dialog can also be accessed by right-clicking on the "GSSHA Parameters Icon.svg Job Control" entry under a specific GSSHA simulation and selecting Edit....

Precipitation

Selecting Precipitation... from the GSSHA menu brings up the GSSHA Precipitation dialog for the active GSSHA simulation. This dialog can also be accessed by right-clicking on the "GSSHA Parameters Icon.svg Precipitation" entry under a specific GSSHA simulation and selecting Edit....

GSSHA Coverage

When a GSSHA simulation is created, it is a assigned a GSSHA coverage (if a GSSHA coverage does not already exist, WMS creates one). To change the GSSHA coverage assigned to a specific simulation, right-click on "Coverage Active Icon.svg GSSHA" underneath the desired GSSHA simulation and select Assign Coverage | [CoverageName] (where "[CoverageName]" is the name of the desired GSSHA coverage). Note that only coverages of the type "GSSHA" will be listed. The name of the coverage can be changed as desired as long as the type remains "GSSHA".

Index Maps

All existing grid index and stream index maps are listed under the "Generic Folder.svg Index Maps" folder under the 2D grid in the Project Explorer. Index maps assigned to a specific GSSHA simulation are listed under the "GSSHA Folder.svg Index Maps" folder under each GSSHA simulation.

Right-clicking on "Generic Folder.svg Index Maps" gives the following options:

To assign a map to a specific GSSHA simulation, right-click on the "GSSHA Folder.svg Index Maps" folder under the desired GSSHA simulation and select Assign | [DesiredIndexMap], where "[DesiredIndexMap]" is the name of the index map to be assigned. To immediately remove (or unassign) an index map from a specific GSSHA simulation, right-click on the index map and select Remove.

Right-clicking an index map under the "Generic Folder.svg Index Maps" folder gives several options:

  • Rename – Allows the index map to be renamed.
  • Export Dataset... – Opens a File Formats dialog.
  • Export to KMZ... – Opens a Save dialog where a File name and save location can be specified for saving the GSSHA index map file as a Google Earth Vector (KMZ) file.
  • Delete – Immediately deletes the selected index map.
  • Properties... – Opens the Dataset Info dialog.
  • View Values... – Opens the Edit Dataset Values dialog.
  • Contour Options... – Opens the Contour Options dialog for the selected dataset.

Select File Format Dialog

The Select File Format dialog has the following options:

  • GRASS ASCII grid file
  • Arc/Info ASCII grid file

Select the desired format and click OK to close the Select File Format dialog and bring up an Open dialog where the desired file can be located and selected. Click Cancel to exit the dialog without making a selection.

Select File Format dialog.

Import Index Map Dialog

The Select File Format dialog is a custom Open dialog that allows for browsing to the location of an index map file (IDX file) and selecting it to be imported.

  • Click Open once the desired file has been selected to import the index map into WMS.
  • Click Cancel to exit the dialog without making a selection.
Import Index Map dialog.

File Formats Dialog

GSSHA index map file export File formats dialog.

The File Formats dialog gives the following options on the left side:

  • Generic scalar file
  • GRASS ASCII grid file
  • Arc/Info ASCII grid file

There are three buttons on the right side of the dialog:

  • OK – Saves the selection and opens a Save dialog where a File name and save location can be specified for saving the GSSHA index map file.
  • Cancel – Discards any selection and closes the File Formats dialog without exporting the GSSHA index map file.
  • Help – Opens the File Types page in a web browser.

Continuous Maps

All continuous maps (such as elevation) for all GSSHA simulations are shown in the Project Explorer under the 2D grid. To assign the maps to a specific GSSHA simulation, right-click on the "GSSHA Folder.svg Continuous Maps" folder under the desired GSSHA simulation, select Assign, and then select the index map that is to be assigned. To unassign a continuous map, right-click on the map and select Remove.

Right-clicking continuous map under the 2D grid (not under the "GSSHA Folder.svg Continuous Maps" folder) gives several options:

  • Rename – Allows the index map to be renamed.
  • Export Dataset... – Opens a File Formats dialog.
  • Delete – Immediately deletes the selected index map.
  • Properties... – Opens the Dataset Info dialog.
  • View Values... – Opens the Edit Dataset Values dialog.
  • Contour Options... – Opens the Contour Options dialog for the selected dataset.
  • Set as Elevations... – Available for elevations datasets. Sets the elevations in the project according to the values in the selected dataset.

Solution

Once a GSSHA simulation has successfully run, the solution is shown underneath the simulation in the Project Explorer. If a solution already exists, it can be imported by right-clicking on the simulation's project name and selecting Read Solution to bring up the Read GSSHA Solution dialog.

GSSHA Groups

Saving GSSHA Groups – Multiple GSSHA scenarios can be saved together as a group. To do this, right-click on the "2D Grid"" folder and select Save GSSHA Group. A dialog will appear prompting to select which scenarios to save. Also pick a location for WMS to save the scenarios and the GSSHA Group File (*.ggp).

Opening a GSSHA Group – To open a group of GSSHA scenarios, right-click on the "2D Grid" folder and select Open GSSHA Group and select the GSSHA Group File (*.ggp) that are to be opened. This will open each project that corresponds with this group. There is also the option to open the solutions, if they exist.

Running a GSSHA Group – To run multiple GSSHA scenarios, right-click on the "2D Grid" folder and select Run GSSHA Group. A dialog will appear to select which projects to run. These projects will be saved as a group and then WMS will run each GSSHA scenario in the group.