WMS:GSSHA Multiple Simulations: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
No edit summary
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Overview ==
{{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.


Multiple GSSHA models using the same 2D grid can be managed within a single instance of WMS.  The models are displayed in the data tree, where the user can edit the job control, precipitation, GSSHA coverage, index maps, and continuous maps.
Note that when generating hydrographs, WMS will display the hydrograph solution for multiple scenarios in the same hydrograph.


==GSSHA Simulations==
[[File:WMS Project Explorer with two GSSHA simulations.png|thumb|right|200 px|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 [[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.


[[Image:GSSHAMultipleModels.png]]
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''' - The job control for the active GSSHA model 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 model and selecting "Edit".
===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''' - The precipitation for the active GSSHA model 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 model 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 model 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 model and select the GSSHA coverage that you want to assign.
===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 index maps for all GSSHA models are shown in the data tree under the grid. To assign a map to a specific GSSHA model, right-click on the Index Maps folder under the desired GSSHA model, select "Assign", and then select the index map that you want to assign.  To unassign an index map, right-click on the map and select "Remove".
===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.  


'''Continuous Maps''' - All continuous maps for all GSSHA models are shown in the data tree under the grid. To assign the maps to a specific GSSHA model, right-click on the Continuous Maps folder under the desired GSSHA model, select "Assign", and then select the index map that you want to assign. To unassign a continuous map, right-click on the map and select "Remove".  
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]].


'''Solution''' - Once a GSSHA model has successfully run, the solution is shown underneath the model in the data tree. If the solution already exists, it can be read in by right-clicking on the model's project name and selecting "Read Solution".
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.


Most of the options available under the GSSHA menu are also found in the right-click menu of the GSSHA project in the data tree.  When selected from the GSSHA menu, they are performed on the active model.  When selected from the right-click menu, they are performed on the corresponding model.
====Select File Format====
{{anchor|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.
[[File:WMS GSSHA Select File Format dialog.png|thumb|none|left|270px|''Select File Format'' dialog.]]


=== GSSHA Groups ===
====Import Index Map====
'''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 to prompt you to select which scenarios you want to save. You will also need to pick a location for WMS to save the scenarios and the GSSHA Group File (*.ggp).
{{anchor|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.]]


'''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 you wish to open.  This will open each project that corresponds with this group.  You also have the option to open the solutions, if they exist.
====File Formats====
{{anchor|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''


'''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 in which you can select which projects you want to run. These projects will be saved as a group and then WMS will run each GSSHA scenario in the group.
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.


==Related Topics==
===Continuous Maps===
* [[WMS:GSSHA|GSSHA Overview]]
All [[WMS:GSSHA Maps#Grid Continuous Maps|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 "[[File:GSSHA Folder.svg|14px]] 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 "[[File:GSSHA Folder.svg|14px]] Continuous Maps" folder) gives several options:
*''Rename'' – Allows the index map to be renamed.
*''Export Dataset...'' – Opens a [[#File Formats Dialog|''File Formats'' dialog]].
*''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.
*''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 [[WMS:GSSHA#Read GSSHA Solution|''Read GSSHA Solution'' dialog]].
 
== GSSHA Groups ==
WMS allows for opening, running, and saving GSSHA groups. These are groups of two or more GSSHA simulations that are saved together so they can be opened or run at a later time. The following can be done with  GSSHA groups:
 
;Opening a GSSHA Group
:There are two ways to open a GSSHA group:
:*Right-click on the "[[File:2D Grid Folder.svg|14px]] 2D Grid Data" folder and select '''Open GSSHA Group...''' to bring up an ''Open'' dialog. This allows browsing to and selection of the desired GSSHA group (GGP) file.
:*When in the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module, select ''GSSHA'' | '''Open GSSHA Group...''' to bring up an ''Open'' dialog.
 
;Running a GSSHA Group
:There are two ways to run a GSSHA group set of simulations. This can be done as long as there are multiple GSSHA simulations in the current project.
:*Right-click on the "[[File:2D Grid Folder.svg|14px]] 2D Grid Data" folder and select '''Run GSSHA Group...''' to bring up the [[#Save and Run GSSHA Group|''Save and Run GSSHA Group'' dialog]].
:*When in the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module, select ''GSSHA'' | '''Run GSSHA Group...''' to bring up an [[#Save and Run GSSHA Group|''Save and Run GSSHA Group'' dialog]].
 
;Saving GSSHA Groups
:There are two ways to save a GSSHA group set of simulations. This can be done as long as there are multiple GSSHA simulations in the current project.
:*Right-click on the "[[File:2D Grid Folder.svg|14px]] 2D Grid Data" folder and select '''Save GSSHA Group...''' to bring up the [[#Save GSSHA Group|''Save GSSHA Group'' dialog]].
:*When in the '''2D Grid''' [[File:2D Grid Icon.svg|14px]] module, select ''GSSHA'' | '''Save GSSHA Group...''' to bring up an [[#Save GSSHA Group|''Save GSSHA Group'' dialog]].
 
===Save GSSHA Group===
[[File:WMS Save GSSHA Group dialog.png|thumb|right|250px|''Save GSSHA Group'' dialog.]]
The "Save GSSHA Group" dialog appears in the following instances:
*When right-clicking on the "2D Grid Data" folder and selecting '''Save GSSHA Group...''', or
*When selecting ''GSSHA'' | '''Save GSSHA Group...''' while in the '''2D Grid''' module.
 
The ''Select projects to be saved'' section lists all of the GSSHA projects that are open in WMS. Check the box in the ''Save'' column to select the desired projects to save as a GSSHA group.
 
To set the ''Group filename'' that will be saved, click [[File:Open Macro.svg|14px]] '''Browse''' to bring up a ''Save'' dialog where the location and ''File name'' of the GSSH group file (GGP) can be specified. Once saved, the filename and path will be displayed to the right of the [[File:Open Macro.svg|14px]] '''Browse''' button.
 
At the bottom of the dialog are the following buttons:
*'''OK''' – Saves all changes, closes the "Save GSSHA Group" dialog, and saves the GSSHA group files as specified.
*'''Cancel''' – Discards any changes and closes the "Save GSSHA Group" dialog.
{{-}}
===Save and Run GSSHA Group===
[[File:WMS Save and Run GSSHA Group dialog.png|thumb|right|250px|''Save and Run GSSHA Group'' dialog.]]
The "Save and Run GSSHA Group" dialog appears in the following instances:
*When right-clicking on the "2D Grid Data" folder and selecting '''Run GSSHA Group...''', or
*When selecting ''GSSHA'' | '''Run GSSHA Group...''' while in the '''2D Grid''' module.
 
The ''Select projects to run'' section lists all of the GSSHA projects that are open in WMS. Check the box in the ''Run'' column to select the desired projects to save and run as a GSSHA group.
 
To set the ''Group filename'' that will be saved, click [[File:Open Macro.svg|14px]] '''Browse''' to bring up a ''Save'' dialog where the location and ''File name'' of the GSSH group file (GGP) can be specified. Once saved, the filename and path will be displayed to the right of the [[File:Open Macro.svg|14px]] '''Browse''' button.
 
There are two options:
*''Suppress screen printing'' – Turning this on suppresses the output of runtime data from GSSHA at each time step, significantly reducing the overall run time required for a GSSHA simulation.
*''Read solution on finish'' – Turn this on to automatically import the GSSHA solutions after each GSSHA run.
 
At the bottom of the dialog are the following buttons:
*'''OK''' – Saves all changes, closes the "Save and Run GSSHA Group" dialog, saves the GSSHA group files as specified, and begins the GSSHA runs on the selected simulations.
*'''Cancel''' – Discards any changes and closes the "Save and Run GSSHA Group" dialog.
 
 
{{GSSHA Wiki}}
{{WMSMain}}
 
[[Category:GSSHA|M]]

Latest revision as of 19:35, 7 June 2021


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.

Note that when generating hydrographs, WMS will display the hydrograph solution for multiple scenarios in the same hydrograph.

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

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

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

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

WMS allows for opening, running, and saving GSSHA groups. These are groups of two or more GSSHA simulations that are saved together so they can be opened or run at a later time. The following can be done with GSSHA groups:

Opening a GSSHA Group
There are two ways to open a GSSHA group:
  • Right-click on the "2D Grid Folder.svg 2D Grid Data" folder and select Open GSSHA Group... to bring up an Open dialog. This allows browsing to and selection of the desired GSSHA group (GGP) file.
  • When in the 2D Grid 2D Grid Icon.svg module, select GSSHA | Open GSSHA Group... to bring up an Open dialog.
Running a GSSHA Group
There are two ways to run a GSSHA group set of simulations. This can be done as long as there are multiple GSSHA simulations in the current project.
Saving GSSHA Groups
There are two ways to save a GSSHA group set of simulations. This can be done as long as there are multiple GSSHA simulations in the current project.

Save GSSHA Group

Save GSSHA Group dialog.

The "Save GSSHA Group" dialog appears in the following instances:

  • When right-clicking on the "2D Grid Data" folder and selecting Save GSSHA Group..., or
  • When selecting GSSHA | Save GSSHA Group... while in the 2D Grid module.

The Select projects to be saved section lists all of the GSSHA projects that are open in WMS. Check the box in the Save column to select the desired projects to save as a GSSHA group.

To set the Group filename that will be saved, click Open Macro.svg Browse to bring up a Save dialog where the location and File name of the GSSH group file (GGP) can be specified. Once saved, the filename and path will be displayed to the right of the Open Macro.svg Browse button.

At the bottom of the dialog are the following buttons:

  • OK – Saves all changes, closes the "Save GSSHA Group" dialog, and saves the GSSHA group files as specified.
  • Cancel – Discards any changes and closes the "Save GSSHA Group" dialog.


Save and Run GSSHA Group

Save and Run GSSHA Group dialog.

The "Save and Run GSSHA Group" dialog appears in the following instances:

  • When right-clicking on the "2D Grid Data" folder and selecting Run GSSHA Group..., or
  • When selecting GSSHA | Run GSSHA Group... while in the 2D Grid module.

The Select projects to run section lists all of the GSSHA projects that are open in WMS. Check the box in the Run column to select the desired projects to save and run as a GSSHA group.

To set the Group filename that will be saved, click Open Macro.svg Browse to bring up a Save dialog where the location and File name of the GSSH group file (GGP) can be specified. Once saved, the filename and path will be displayed to the right of the Open Macro.svg Browse button.

There are two options:

  • Suppress screen printing – Turning this on suppresses the output of runtime data from GSSHA at each time step, significantly reducing the overall run time required for a GSSHA simulation.
  • Read solution on finish – Turn this on to automatically import the GSSHA solutions after each GSSHA run.

At the bottom of the dialog are the following buttons:

  • OK – Saves all changes, closes the "Save and Run GSSHA Group" dialog, saves the GSSHA group files as specified, and begins the GSSHA runs on the selected simulations.
  • Cancel – Discards any changes and closes the "Save and Run GSSHA Group" dialog.