WMS:MWBM Wizard

From XMS Wiki
Jump to navigationJump to search

The MWBM Wizard dialog is accessed through the MWBM Wizard MWBM ModelingTool.png tool icon in the WMS Graphics Window. Mine Water Balance Modeling (MWBM) can be used to update a GSSHA model within WMS by using this dialog.

On the left of the dialog is a list of pages that allow modification of various parameters and data to be used in updating and running the GSSHA model. The name of the dialog changes as each page is selected from the list on the left. The pages should generally be selected and completed in the order they appear in the list.

Each of these pages is discussed and explained below.

Read Existing Model

When this page is selected, the title of the dialog is Project Filename.

The "Read Existing Model" page has one item:

  • Browse for WMS project filename – Click Browse Open Macro.svg to bring up the Select WMS Project File dialog. Browse to the location of the desired project file.

Define Model Changes

MWBM Wizard dialog showing the "Define Model Changes" page.

When this page is selected, the title of the dialog is Model Changes.

The "Define Model Changes" page allows the specification of pages in the dialog that require new information. These checkboxes allow the user to automatically skip particular pages when using the Next button if that information doesn't require updating. The user can still visit the other pages, if needed. Some options will cover more than one page.

Under Specify steps that require new information, the following options are available:

  • Update elevation data &ndash - Takes the user to the "Elevation Data", "Outlet Location", "Delineate Watershed", "Create 2D Grid", and "Output Locations" pages before running GSSHA.
  • Update outlet/settling pond locations &ndash - Takes user to "Outlet Locations", "Delineate Watershed", "Create 2D Grid", and "Output Locations" pages before running GSSHA.
  • Update GSSHA parameters &ndash - Takes the user to the "GSSHA Parameters" and "Output Locations" pages before running GSSHA.
  • Update land use/soil &ndash - Takes the user to the "Land Use/Soil" and "Output Locations" pages before running GSSHA.
  • Update index maps &ndash - Takes the user to the "Index Maps" and "Output Locations" pages before running GSSHA.
  • Update embankment locations &ndash - Takes the user to the "Embankment Locations" and "Output Locations" pages before running GSSHA.
  • Update pumping locations &ndash - Takes the user to the "Pumping Locations" and "Output Locations" pages before running GSSHA.
  • Update rainfall &ndash - Takes the user to the "Rainfall" and "Output Locations" pages before running GSSHA.

Elevation Data

MWBM Wizard dialog showing the "Elevation Data" page.

When this page is selected, the title of the dialog is Elevation Data.

This page has two sections: Elevation data and Flow directions/accumulations.

Elevation data

There are three parts to this section:

  • To use elevation data different than what is already in the opened project, click Browse Open Macro.svg to bring up the Select DEM File(s) dialog. This allows a new DEM to be imported into the project.
  • The Select updated elevation data source drop-down contains a listing of all the available elevation data sources. Select the desired DEM from the drop-down to update the 2D grid.
  • Click the Update Elevation Source List button after importing a new DEM, then select it as the desired elevation data source from the drop-down above.

Flow direction/accumulations

Clicking the Compute button computes the flow directions and accumulations for the new terrain dataset (the DEM). If the imported file has these pre-computed, it is not necessary to click this button.

Outlet Location

MWBM Wizard dialog showing the "Outlet Location" page.

When this page is selected, the title of the dialog is Outlet Location.

This page contains a single button: Change Outlet Location. These steps must be followed by delineating the watershed.

Follow these steps to select the new outlet location:

  1. Click Change Outlet Location to change the cursor to a small cross-hair icon.
  2. In the Main Graphics Window in WMS, click on the desired new location for the outlet. The outlet must be in an flow accumulation cell; an error message will popup advising the user if the selected location is not an accumulation cell.
  3. If needed, use the Property section of the Main Graphics Window to manually adjust the Feature Point X and Feature Point Y locations.


Delineate Watershed

MWBM Wizard dialog showing the "Delineate Watershed" page.

When this page is selected, the title of the dialog is Delineate Watershed.

This page has a Computation Units section, followed by a single user-adjustable option and the Delineate Watershed button.

Computation Units

This section is mostly informational, displaying horizontal and vertical units, units for the computed sub-basin areas, and units for computed distances.

  • Clicking Units... brings up the Units dialog. The dialog allows model and parameter units to be set, and gives access to the drain data computation and drain data display options.

Other Options

Below the Computation Units section, four items are shown:

  • Displayed threshold value – Shows the currently-displayed threshold value in the selected units.
  • Stream threshold value – Allows the stream density value to be manually set. Lower values will cause the streams to be more dense while higher values will create fewer streams in the completed model.
  • Apply to Display – Applies the value set in the stream threshold value field to what is displayed in the Main Graphics Window.
  • Delineate Watershed – Clicking this button tells WMS to delineate the watershed using the outlet and elevation information set in previous steps.

After delineating a watershed, it is possible to manually edit the extents of the watershed.

Create 2D Grid

MWBM Wizard dialog showing the "Create 2D Grid" page.

When this page is selected, the title of the dialog is Create 2D Grid.

At the top of this page are two options:

  • Enter number of cells – When selected, allows the user to set the number of cells in the X-dimension. The number of cells in the Y-dimension will be adjusted automatically based on what is entered in the X-dimension field.
  • Enter cell size – When selected, allows the user to enter the cell size in the X-dimension. The cell size in the Y-dimension will be adjusted automatically based on what is entered in the X-dimension field.

For the GSSHA or ModClark models to run correctly, the X and Y dimensions of the 2D grid cells must be equal.

Below the two spreadsheets are two additional options and two buttons:

  • Use a depression coverage – When turned on, allows the user to select a depression coverage from a drop-down of all the appropriate coverages in the project.
  • Add structures from existing GSSHA coverage – When turned on, allows the user to select from a drop-down list of all the GSSHA coverages in the project.
  • Create 2D Grid – Creates a 2D grid based on the updated number of cells or cell size, the above options, the new outlet location, the delineated watershed, and elevation information.


GSSHA Parameters

MWBM Wizard dialog showing the "GSSHA Parameters" page.

When this page is selected, the title of the dialog is GSSHA Parameters.

There are two spreadsheet sections and one button on this page:

  • Land use parameters – This section lists all of the land use values within the project. The following columns are found in this spreadsheet:
    • Land Use ID – Unique numeric ID for each entry. The IDs are created automatically by WMS for each entry. New land use entries can be made at the bottom of this spreadsheet.
    • Description 1 – An alphanumeric description for the land use entry. User-editable.
    • Description 2 – A second alphanumeric description for the land use entry. Often left blank, but can be used if further disambiguation is needed. User-editable.
    • Manning's n – Roughness value used in calculating the flow through a channel. A higher value indicates a higher roughness, meaning the flow is being impeded to a certain degree. User-editable.
  • Soil type parameters – This section lists all of the soil type values within the project. The following columns are found in this section:
    • Soil ID – Unique numeric ID for each entry. The IDs are created automatically by WMS for each entry. New soil type entries can be made at the bottom of this spreadsheet.
    • Soil Texture – A numeric soil texture value for each entry. For example, "Mudstone" might be soil texture 18, and "Silty clayey sand" might be soil texture 5.
    • Description 1 – An alphanumeric description for the land use entry. User-editable.
    • Initial Moisture – A value between "0.0" and "1.0". User-editable.
    • Land Use ID – A drop-down populated by values from the Land use parameters spreadsheet. The default value is "<none>".
    • Description 2 – A second alphanumeric description for the land use entry. Often left blank, but can be used if further disambiguation is needed. User-editable.
    • Hydraulic conductivityKsat value in units per hour (default is cm/hr). User-editable.
    • Capillary head – Head value in centimeters. User-editable.
    • Porosity – Porosity value in units3/units3 (default is m3/m3). User-editable.
    • Pore distribution index – Pore size distribution value in units/units (default is cm/cm). User-editable.
    • Residual saturation – Residual saturation value in units3/units3 (default is m3/m3). User-editable.
    • Field capacity – Specific retention value in units3/units3 (default is m3/m3). User-editable.
    • Wilting point – Saturation value in the soil of the minimal amount of water that plants require to not wilt, in units3/units3 (default is m3/m3). User-editable.
    • Coefficient for detachment by rainfall – Ratio of sediment detachment by rainfall, 1/J. User-editable.
    • Rill erodibility coefficient – A value in seconds per meter (s/m). User-editable.
    • Rill erodibility exponent – A dimensionless value. User-editable.
    • Critical rill detachment – A force value in Pascals (Pa). User-editable.
    • Erodibility coefficient – A dimensionless value. User-editable.
    • Medium Gravel – Percentage of medium gravel in the total volume of sediment. Values of medium gravel, medium sand, medium silt, and medium clay must add up to 100. User-editable.
    • Medium Sand – Percentage of medium sand in the total volume of sediment. Values of medium gravel, medium sand, medium silt, and medium clay must add up to 100. User-editable.
    • Medium Silt – Percentage of medium silt in the total volume of sediment. Values of medium gravel, medium sand, medium silt, and medium clay must add up to 100. User-editable.
    • Medium Clay – Percentage of medium clay in the total volume of sediment. Values of medium gravel, medium sand, medium silt, and medium clay must add up to 100. User-editable.
  • Read CMT File From Existing Project... – Brings up the Open dialog where a CMT file can be selected for importing. The imported file can either overwrite the existing information or be appended to it.

Land Use/Soil

When this page is selected, the title of the dialog is Define Land Use and Soil Data.

Index Maps

When this page is selected, the title of the dialog is Index Maps.

Embankment Locations

When this page is selected, the title of the dialog is Embankment Locations.

Pumping Locations

When this page is selected, the title of the dialog is Pumping Locations.

Rainfall

When this page is selected, the title of the dialog is Define Precipitation.

Output Locations

When this page is selected, the title of the dialog is Output Locations.

Run GSSHA

When this page is selected, the title of the dialog is Run Hydrologic Model.

Output

When this page is selected, the title of the dialog is Output.

Erosion/Deposition Maps

When this page is selected, the title of the dialog is Erosion/Deposition Maps.