WMS:GSSHA Multiple Simulations: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
Line 1: Line 1:
{{TOC right}}
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==
[[File:WMS Project Explorer with two GSSHA simulations.png|thumb|right|200 px|WMS Project Explorer showing two GSSHA simulations.]]
[[File:WMS Project Explorer with two GSSHA simulations.png|thumb|right|200 px|WMS Project Explorer showing two GSSHA simulations.]]
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.
There are several different types of entries within a GSSHA simulation. Many of the options available under the [[WMS:GSSHA Menu#2D Grid Module GSSHA Menu|''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 [[WMS:GSSHA Job Control|''Job Control Parameters'' dialog]] for the active GSSHA simulation. This dialog can also be accessed by right-clicking on the "[[File:GSSHA Parameters Icon.svg|14px]] Job Control" entry under a specific GSSHA simulation and selecting '''Edit...'''.
 
===Precipitation===
Selecting '''Precipitation...''' from the ''GSSHA'' menu brings up the [[WMS:GSSHA Precipitation|''GSSHA Precipitation'' dialog]] for the active GSSHA simulation. This dialog can also be accessed by right-clicking on the "[[File:GSSHA Parameters Icon.svg|14px]] 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 "[[File:Coverage Active Icon.svg|14px]] 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 [[WMS:GSSHA Maps#Grid Index Maps|grid index]] and [[WMS:GSSHA Maps#Stream Index Maps|stream index maps]] are listed under the "[[File:Generic Folder.svg|14px]] Index Maps" folder under the 2D grid in the Project Explorer. Index maps assigned to a specific GSSHA simulation are listed under the "[[File:GSSHA Folder.svg|14px]] Index Maps" folder under each GSSHA simulation.
 
Right-clicking on "[[File:Generic Folder.svg|14px]] Index Maps" gives the following options:
*'''Import Scalar Dataset...''' – Brings up the [[#Select File Format Dialog|'''Select File Format'' dialog]].
*'''Import Index Map...''' – Brings up the [[#Import Index Map Dialog|''Import Index Map'' dialog]].
 
To assign a map to a specific GSSHA simulation, right-click on the "[[File:GSSHA Folder.svg|14px]] 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 "[[File:Generic Folder.svg|14px]] Index Maps" folder gives several options:
*''Rename'' – Allows the index map to be renamed.
*''Export Dataset...'' – Opens a [[#File Formats Dialog|''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 [[WMS:Datasets#Dataset Info|''Dataset Info'' dialog]].
*''View Values...'' – Opens the [[WMS:Datasets#Edit Dataset Values|''Edit Dataset Values'' dialog]].
*''Contour Options...'' – Opens the [[WMS:Contour Options|''Contour Options'' dialog]] for the selected dataset.


'''Job Control''' – The [[WMS:GSSHA Job Control|job control]] for the active GSSHA simulation can be accessed from the ''GSSHA'' menu item.  The job control can also be opened by right-clicking on the job control icon that corresponds with the desired GSSHA simulation and selecting '''Edit'''.
====Select File Format Dialog====
The ''Select File Format'' dialog has the following options:
*''GRASS ASCII grid file'' –  
*''Arc/Info ASCII grid file'' –


'''Precipitation''' – The [[WMS:GSSHA Precipitation|precipitation]] for the active GSSHA simulation can be accessed from the ''GSSHA'' menu item.  The precipitation can also be opened by right-clicking on the precipitation icon that corresponds with the desired GSSHA simulation and selecting '''Edit'''.
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.
[[File:WMS GSSHA Select File Format dialog.png|thumb|none|left|270px|''Select File Format'' dialog.]]


'''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 assigned GSSHA coverage, right-click on the coverage icon that corresponds with the desired GSSHA simulation and select the GSSHA coverage that is to be assigned.
====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.
[[File:WMS GSSHA Import Index Map dialog.png|thumb|none|left|400px|''Import Index Map'' dialog.]]


'''Index Maps''' – All [[WMS:GSSHA Maps|index maps]] for all GSSHA simulations are shown in the Project Explorer under the grid. To assign a map to a specific GSSHA simulation, right-click on the "Index Maps" folder under the desired GSSHA simulation, select '''Assign''', and then select the index map that is to be assigned.  To unassign an index map, right-click on the map and select '''Remove'''.
====File Formats Dialog====
[[File:WMS GSSHA index map file export File Formats dialog.png|thumb|right|220px|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''


'''Continuous Maps''' – All [[WMS:GSSHA Maps|continuous maps]] for all GSSHA simulations are shown in the Project Explorer under the grid.  To assign the maps to a specific GSSHA simulation, right-click on the "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'''.  
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.  


'''Solution''' – Once a GSSHA simulation has successfully run, the solution is shown underneath the simulation in the Project ExplorerIf the solution already exists, it can be read in by right-clicking on the simulation's project name and selecting '''Read Solution'''.
===Continuous Maps===
All [[WMS:GSSHA Maps|continuous maps]] for all GSSHA simulations are shown in the Project Explorer under the grid.  To assign the maps to a specific GSSHA simulation, right-click on the "Continuous Maps" folder under the desired GSSHA simulation, select '''Assign''', and then select the index map that is to be assignedTo unassign a continuous map, right-click on the map and select '''Remove'''.  


Most of the options available under the ''GSSHA'' menu are also found in the right-click menu of the GSSHA project in the Project Explorer.  When selected from the ''GSSHA'' menu, they are performed on the active simulation.  When selected from the right-click menu, they are performed on the corresponding simulation.
===Solution===
Once a GSSHA simulation has successfully run, the solution is shown underneath the simulation in the Project Explorer.  If the solution already exists, it can be read in by right-clicking on the simulation's project name and selecting '''Read Solution'''.


=== GSSHA Groups ===
== 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).
'''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).



Revision as of 23:42, 15 May 2019


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 for all GSSHA simulations are shown in the Project Explorer under the grid. To assign the maps to a specific GSSHA simulation, right-click on the "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.

Solution

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

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.