GMS:HydroGeoSphere: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
Line 21: Line 21:


The right-click menu for a simulation includes menu commands specific to each model.
The right-click menu for a simulation includes menu commands specific to each model.
=== Simulation Menu Preferences ===
In addition to some general commands, which are described below, the user has control over a set of simulation right-click menu options. These options are accessed by pressing the '''Edit''' button in the [[SMS:Preferences#Project Explorer|''Project Explorer'']] tab of the [[SMS:Preferences|''SMS Preferences'']] dialog. This dialog is accessed in the ''Edit'' menu using the '''Preferences''' command.
<!--Update template-->
The options in this dialog allow hiding or showing menu commands for the simulation right-click menus. The dialog has the following options:
*''Simulation'' &ndash; This section is for turning on and off commands located in the simulation right-click menu for individual simulations. It includes the following commands:
**Save Simulation
**Run Simulation
**Save Simulation and Run
**Save Project and Simulation
** Save Project, Simulation and Run
*''Multiple Simulations for Model'' &ndash; This section is for turning on and off commands for the simulation data right-click menu that affects multiple simulations. This is accessed by right-clicking on the simulation folder [[File:Simulation Folder Icon.svg|16 px]] for each numerical model. It includes the following commands:
**Save Multiple Simulations
**Run Multiple Simulations
**Save Multiple Simulations and Run
**Save Project and Multiple Simulations
** Save Project, Multiple Simulations and Run
:'''''Note:''''' Saving a project does not save files used by the numeric model for the simulation run. The simulation must be saved for these files to be exported from the project.
:'''''Note:''''' Some models do not support a Save and/or Run command. Menus selected in this dialog may not appear for those models. For example, if the '''Save Simulation and Run''' was the only menu item selected, but the model only supports the '''Save''' command, then the '''Save Simulation''' command would appear instead of the '''Save Simulation and Run''' command.


===General Simulation Right-Click Menu Commands===
===General Simulation Right-Click Menu Commands===

Revision as of 22:51, 19 September 2023

HydroGeoSphere (HGS) is a three-dimensional control-volume finite element simulator created by Aquanty. HGS can be used to model the entire terrestrial portion of the hydrologic cycle. It uses a globally-implicit approach to simultaneously solve the 2D diffusive-wave equation for overland/surface water flow and the 3D form of Richards’ equation for variably saturated groundwater flow.

Graphical Interface

The GMS interface for HydroGeoSphere contains multiple components. These components include:

  • An unstructured grid (UGrid)
  • HGS coverages
  • HGS simulation, including the Simulation Control

Working with Simulations

A simulation can be created by right-clicking on a blank portion of the Project Explorer and choosing the New Simulation submenu. The New Simulation menu will have commands to create a new model simulation. Selecting a model will cause a simulation folder Simulation Folder Icon.svg for the chosen model to appear in the Project Explorer.

After a simulation Simulation Icon.svg has been created, components may be added to the simulation. Components are often created as map coverages, meshes, grids, or scatter sets. The individual map coverages, grids, or scatter sets can be linked to the simulation by clicking on the item in the Project Explorer and dragging it under the simulation item in the Project Explorer. Each simulation in the Project Explorer will show a list of all linked components Coverage Link.svg. This allows multiple simulations to make use of the same datasets.

Components can also be added to a simulation using the right-click Apply To submenus.

Once a simulation exists, future simulations are often similar to one already created. Often it is easier to make a copy of the simulation and make changes where appropriate. A simulation can be copied by right-clicking on the simulation and choosing Duplicate. All simulations for a model will be listed under the simulation Simulation Icon.svg for that model. Under the simulation data Simulation Data Icon.svg item all simulations for all models will be listed—SMS supports using more than one model for a project.

Note: When naming simulations, apostrophes are not allowed in the simulation name. Using an apostrophe in any simulation name may cause an error.

The right-click menu for a simulation includes menu commands specific to each model.

General Simulation Right-Click Menu Commands

Right-clicking on any simulation object Simulation Icon.svg in the Project Explorer will bring up a menu for that simulation. Some of the commands are specific for the simulation model type. The simulation right-click menu has the following commands that are used by all simulations.

  • Rename – Allows changing the simulation name.
  • Duplicate – Creates a copy of the selected simulation. All components linked to selected simulation will be linked to the duplicate simulation. Adding, or removing the components in the duplicate simulation will not change the original simulation.
  • Delete – Removes the selected simulation. This command does not delete or modify components linked to the simulation.
  • Properties – Brings up a Properties dialog that shows which model the simulation is using and what components have been applied.

Right-clicking on the simulation folder Simulation Folder Icon.svg always includes the following commands:

  • New Simulation – This command will create a new simulation of the same model type as the simulation folder.
  • Simulation Run Queue – Opens the Simulation Run Queue dialog.

Additional commands appear in the simulation right-click menu depend on the settings in the Simulation Menu Preferences dialog as described above. If any of the Multiple simulation commands are invoked, a dialog appears listing the simulations in this folder with toggle box next to each as shown. The user may then select which simulations should be included in this command.

The Simulations dialog for multiple simulations

These optional commands should be self explanatory based on their name. In general, their function can be described as:

  • A command that says Save Simulation generates the files for the numeric model simulation run, but does not save the project files.
  • A command that says Save Project saves the project such as mesh and map data, but doesn't generate the files needed for the simulation run. This command is typically used with the Save Simulation command.
  • A command that says Run Simulation runs the simulation. It is necessary to save the simulation files as part of or before using a run command.

All of the above applies equally to multiple simulations commands and single simulations commands.

Modeling Notes

  • GMS allows multiple HGS simulations to exist in a single GMS project.

HGS Files

External Links