HydroGeoSphere Basic Workflow

From XMS Wiki
This is the approved revision of this page, as well as being the most recent.
Jump to navigationJump to search

This is a top level workflow. This workflow includes all of the specific workflows needed in creating a general HydroGeoSphere project. Newer and infrequent GMS users should start here.

To build a HydroGeoSphere model in GMS, use the following steps:

1. Start GMS.
1. Start GMS, or clear existing projects in GMS.
  1. If GMS is already running, select File | New.
  2. A new project can also be started by clicking New New Macro.svg.
2. If necessary, register or update GMS.
1. Register GMS and components.
  1. Launch the GMS Registration Wizard.
  2. Follow the Registration Wizard instructions.
  3. Review the registered components in the Aquaveo License Registration dialog.
2. Update GMS.
GMS can be updated by doing any of the following:
  1. Select Download if prompted to update when starting GMS.
  2. Select Help | Check For Updates.
  3. Go directly to the GMS download page.
3. Set the display projection.
  1. Select the Edit | Units... command.
  2. In the Units dialog, set the time, mass, force, and concentration.
  3. Click the Dot dot dot button.png button and set the horizontal and vertical projection in the Display Projection dialog.
  4. If necessary, use the Horizontal Projection dialog to set a global projection.
2. Import data.
1. Gather and open image files.

Images are imported into the GIS module in GMS.

1. Open local images.
  1. Load images from local computer files using the File | Open... command.
  2. Alternatively, drag and drop the file into the Graphics Window in GMS.
2. Import images from the web.
  1. Use the Add Online Maps Add Online Maps Icon.svg macro.
  2. Select a location in the Virtual Earth Map Locator.
  3. If a projection has not been set for the project, set a new project in the Display Projection dialog.
  4. Use the Data Service Options dialog to select a web service.
2. Gather and open geometric data files.
1. Import map data.
  1. Use the File | Open... command to import map data such as Map files, boundary ID files, or boundary XY files.
  2. Alternately, drag and drop the file into the Graphics Window in GMS.
2. Import GIS data.
  1. Use the File | Open... command to import GIS data files such as Shapefiles or raster files.
  2. Alternatively, drag and drop the file into the Graphics Window in GMS.
3. Import scatter data.
  1. Use File | Open... to open files with scatter data.
    • Alternatively, drag and drop the file into the Graphics Window in GMS.
  2. Use the File Import Wizard to specify how to import the data.
4. Import CAD data.
  1. Verify the CAD file type is readable by GMS before importing it. GMS can import DXF and DWG files.
  2. Use the File | Open... command to launch the Open dialog (or drag and drop) to import the CAD files.
The data should load in layers into the Project Explorer.
5. Review and set object projections.
  1. Right-click on an object in the Project Explorer and select the Projection | Projection command.
  2. Set the horizontal and vertical projection using the Object Projection dialog.
  3. To set a global projection, use the Horizontal Projection dialog.
3. Gather hydrologic data files.
  1. Gather data files for hydrologic and hydraulic data. These include data such as hydrographs, water levels, and rating curves. They will be imported when setting boundary conditions and when doing model calibration.
3. Create UGrids (both 3D and 2D).

HGS will require both a 3D UGrid and a 2D UGrid

1. Create the 3D UGrid.
Create a 3D UGrid in one of the following ways:
1. Create a 3D UGrid from scratch.
  1. Right-click in the Project Explorer and select New | UGrid 3D....
  2. In the New UGrid dialog, enter the information for the X-, Y-, and Z-Dimension of the grid.
2. Create a 3D UGrid from a coverage.
  1. Right-click on the desired coverage and select the Map To | UGrid command.
  2. In the Map → UGrid dialog, set the Dimension drop-down to "3D".
  3. Enter the rest of the information for the grid, including the X-, Y-, and Z-Dimension information.
2. Create the 2D UGrid.
The 2D UGrid should be created from the 3D UGrid so the grids match.
  1. In the Project Explorer, right-click on the 3D UGrid and select 3D → 2D.
  2. Use the 2D UGrid from 3D UGrid tool to generate the 2D UGrid.
4. Renumber both UGrids for HGS.

Use the Renumber UGrid for HydroGeoSphere tool to renumber a UGrids to meet HydroGeoSphere requirements.

  1. Access the Renumber UGrid for HydroGeoSphere tool in the Toolbox Toolbox macro.png.
  2. Select the UGrid to renumber and run the tool.
  3. Repeat for to renumber both the 3D and 2D UGrids.
5. Create a HydroGeoSphere simulation.
  1. Right-click in the Project Explorer and select the New Simulation | HydroGeoSphere command.
6. Set the HydroGeoSphere Simulation Control.
  1. Right-click on the HydroGeoSphere simulation in the Project Explorer and select the Simulation Control command.
  2. Define the simulation parameters in the HGS [[ |Simulation Control]] dialog, including:
    • General parameters
    • Units
    • Saturated flow
    • Variably saturated flow
    • Time stepping
    • Output
    • Zones
    • Initial conditions
7. Define HydroGeoSphere zones.
1. Create zones from a raster.
  1. Import raster data.
  2. Create a cell-based dataset on a 3D UGrid by right-clicking on the UGrid and selecting the Z Values → Cell Dataset command.
  3. Interpolate the raster data to the 3D UGrid by right-clicking on the raster and selecting the Interpolate → UGrid command.
  4. Use the Interpolate Priority Rasters tool to define how the raster data is interpolated to the UGrid. Values from the raster will define the zones.
2. Create zones from a coverage.
1. Create coverage for defining zones.
1. Create new coverage from scratch.
  1. Use the New Coverage right-click command.
  2. Use the Coverage Setup dialog to create a new coverage by selecting the desired coverage properties and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage setup.
2. Create polygons that define the zones.
1. Create enclosed arcs for polygon areas.
1. Create feature points, arcs, nodes and vertices.
In the map module, create feature objects in the active coverage.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the graphics window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Point Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs, whether digitized or incorporated from a boundary condition or a material coverage, often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Vertex GMS Create Vertex.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool and the Select Points\Nodes GMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Arcs GMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool.
  2. Select the Feature Objects | Vertices → Nodes command to split the arc into two arcs.
2. Add a node to the arc.
  1. Use the Create Point Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Connect the end of an existing arc to the middle of the arc.
  1. Use the Select Points\Nodes GMS Select Node Tool.svg tool to drag the node of an existing arc to anywhere in the middle of another arc. This will split the second arc into two arcs.
4. Add a new connecting arc.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Points\Nodes GMS Select Node Tool.svg tool.
  2. Click on the Feature Objects | Nodes → Vertices menu command to merge the arcs.
  3. If desired, the Select Vertices GMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Transform arcs.
  1. Select the arc using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Edit | Transform command.
  3. Use the Transform dialog to scale, translate or rotate the arc.
2. Build polygons in enclosed areas.
Polygons are not created automatically when arcs are enclosed. To create polygons:
  1. Use the Feature Objects | Build Polygons command.
3. Use the polygon to define zones on the UGrid.
  1. Select and make active a dataset on the UGrid which will define the zones in the simulation run. Make certain to be in plan view and shows the correct layer.
  2. Select the coverage containing the zone polygons.
  3. Select a polygon then right-click and select the Select Intersecting Objects command.
  4. In the Select Objects of Type dialog, select the UGrid.
  5. With the cells selected on the UGrid, change to cell values (S) to define the zone.
8. Define HydroGeoSphere materials.
  1. In the Project Explorer, right-click on the HGS simulation and select Materials.
  2. In the HGS Materials dialog, add materials.
  3. Select each material and define the material properties.
9. Define HydroGeoSphere boundary conditions.
1. Create an HGS boundary condition coverage.
1. Create coverage for defining boundary conditions.
1. Create new coverage from scratch.
  1. Use the New Coverage right-click command.
  2. Use the Coverage Setup dialog to create a new coverage by selecting the desired coverage properties and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage setup.
2. Set the coverage type.
  1. In the Project Explorer, right-click on the HGS boundary condition coverage and select Coverage Type | HydroGeoSphere | Boundary Conditions.
2. Create boundary condition arcs.
1. Create feature points, arcs, nodes and vertices.
In the map module, create feature objects in the active coverage.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the graphics window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Point Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs, whether digitized or incorporated from a boundary condition or a material coverage, often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Vertex GMS Create Vertex.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool and the Select Points\Nodes GMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Arcs GMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool.
  2. Select the Feature Objects | Vertices → Nodes command to split the arc into two arcs.
2. Add a node to the arc.
  1. Use the Create Point Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Connect the end of an existing arc to the middle of the arc.
  1. Use the Select Points\Nodes GMS Select Node Tool.svg tool to drag the node of an existing arc to anywhere in the middle of another arc. This will split the second arc into two arcs.
4. Add a new connecting arc.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Points\Nodes GMS Select Node Tool.svg tool.
  2. Click on the Feature Objects | Nodes → Vertices menu command to merge the arcs.
  3. If desired, the Select Vertices GMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Transform arcs.
  1. Select the arc using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Edit | Transform command.
  3. Use the Transform dialog to scale, translate or rotate the arc.
3. Assign properties to the boundary condition arcs.
  1. Using the Select Arcs GMS Select Arc Tool.svg tool, right-click on an arc in the HGS boundary condition coverage and select Assign Properties.
  2. Set HGS boundary condition properties in the Arc Properties dialog.
10. Set HydroGeoSphere output options.
1. Create observations.
1. Create an HGS Observations coverage.
1. Create coverage for defining observation points.
1. Create new coverage from scratch.
  1. Use the New Coverage right-click command.
  2. Use the Coverage Setup dialog to create a new coverage by selecting the desired coverage properties and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage setup.
2. Set the coverage type.
  1. In the Project Explorer, right-click on the HGS boundary condition coverage and select Coverage Type | HydroGeoSphere | Observations.
2. Create observation points.
1. Create feature points, arcs, nodes and vertices.
In the map module, create feature objects in the active coverage.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the graphics window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Point Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs, whether digitized or incorporated from a boundary condition or a material coverage, often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Vertex GMS Create Vertex.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool and the Select Points\Nodes GMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Arcs GMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool.
  2. Select the Feature Objects | Vertices → Nodes command to split the arc into two arcs.
2. Add a node to the arc.
  1. Use the Create Point Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Connect the end of an existing arc to the middle of the arc.
  1. Use the Select Points\Nodes GMS Select Node Tool.svg tool to drag the node of an existing arc to anywhere in the middle of another arc. This will split the second arc into two arcs.
4. Add a new connecting arc.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Points\Nodes GMS Select Node Tool.svg tool.
  2. Click on the Feature Objects | Nodes → Vertices menu command to merge the arcs.
  3. If desired, the Select Vertices GMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Transform arcs.
  1. Select the arc using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Edit | Transform command.
  3. Use the Transform dialog to scale, translate or rotate the arc.
3. Turn on observations.
  1. Using the Select Points\Nodes GMS Select Node Tool.svg tool, right-click on a point in the HGS observation coverage and select Assign Properties.
  2. Set HGS observation properties in the Point Properties dialog.
2. Create hydrographs.
1. Create an HGS Hydrographs coverage.
1. Create coverage for defining hydrograph arcs and points.
1. Create new coverage from scratch.
  1. Use the New Coverage right-click command.
  2. Use the Coverage Setup dialog to create a new coverage by selecting the desired coverage properties and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage setup.
2. Set the coverage type.
  1. In the Project Explorer, right-click on the HGS boundary condition coverage and select Coverage Type | HydroGeoSphere | Hydrographs.
2. Create hydrograph arcs and points.
1. Create feature points, arcs, nodes and vertices.
In the map module, create feature objects in the active coverage.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the graphics window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Point Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs, whether digitized or incorporated from a boundary condition or a material coverage, often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Vertex GMS Create Vertex.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool and the Select Points\Nodes GMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Arcs GMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Vertices GMS Select Vertex Tool.svg tool.
  2. Select the Feature Objects | Vertices → Nodes command to split the arc into two arcs.
2. Add a node to the arc.
  1. Use the Create Point Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Connect the end of an existing arc to the middle of the arc.
  1. Use the Select Points\Nodes GMS Select Node Tool.svg tool to drag the node of an existing arc to anywhere in the middle of another arc. This will split the second arc into two arcs.
4. Add a new connecting arc.
  1. Use the Create Arc GMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Points\Nodes GMS Select Node Tool.svg tool.
  2. Click on the Feature Objects | Nodes → Vertices menu command to merge the arcs.
  3. If desired, the Select Vertices GMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Transform arcs.
  1. Select the arc using the Select Arcs GMS Select Arc Tool.svg tool.
  2. Use the Edit | Transform command.
  3. Use the Transform dialog to scale, translate or rotate the arc.
3. Turn on hydrographs.
  1. Using the Select Arcs GMS Select Arc Tool.svg tool or the Select Points\Nodes GMS Select Node Tool.svg tool, right-click on an arc or point in the HGS hydrographs coverage and select Assign Properties.
  2. Set HGS hydrograph properties in the Arc Properties dialog or the Point Properties dialog.
11. Run HydroGeoSphere.
1. Link components to the simulations.
To link components to the simulation, do one of the following.
  1. Right-click on the component and select the simulation name from the Apply To submenu.
  2. In the Project Explorer, click and drag items under the simulation object.
2. Save and run the simulation.
  1. In the Project Explorer, right-click on the HGS simulation and Save Simulation.
  2. In the Project Explorer, right-click on the HGS simulation and Run grok.exe.
  3. In the Project Explorer, right-click on the HGS simulation and Run phgs.exe.
  4. The Simulation Run Queue dialog will appear; allow the simulation to run to completion.
  5. When the simulation has finished successfully, click Load Solution.
12. Visualize the solution.
1. Change display options.
1. Set display options.
  1. Open the Display Options Display Options Macro.svg dialog.
  2. Set the general display options.
  3. Set general lighting options.
  4. Set display options for each module that is being used.
  5. Set contour options.
  6. Set vector options.
2. View display.
  1. Use the Rotate Rotate Tool.svg, Pan Pan Tool.svg, and Zoom Zoom Tool Icon.svg tools.
  2. Use the View menu commands found in the Display menu.
  3. Use the Frame Frame Macro.svg command to center and resize the display as needed.
3. Adjust display.
Display may need to be adjusted during the remainder of the project.
  1. Use the Display Options dialog and viewing tools as needed.
  2. Use the Frame Frame Macro.svg command to center and resize the display as needed.
2. Change contour options.
  1. Turn on Contours in the Display Options dialog and set contour options. The "Color Fill" option is recommended for this.
  2. Look for inconsistent points (points with values much higher/lower than their neighbors or regions where no data points exist).
  3. Verify that the region being modeled is covered by the elevation/depth data and there are no holes.
3. Create a plot.
  1. In the Project Explorer, right-click on the HGS simulation and select the Solution Plots command.
  2. Review plots in the Solution Plots dialog.
4. Create an animation.
  1. Select a solution dataset and use the Display | Animate menu command.
  2. Use the Animation Wizard to specify the animation parameters.
  3. Save and view the animation file.
Retrieved from "https://www.xmswiki.com/index.php?title=HydroGeoSphere_Basic_Workflow&oldid=162932"