WMS:MWBM Wizard: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(create base page)
 
No edit summary
Line 60: Line 60:
When this page is selected, the title of the dialog is ''Delineate Watershed''.  
When this page is selected, the title of the dialog is ''Delineate Watershed''.  


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


===Computation Units===
===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 [[WMS:Edit Menu#Units|'''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.


The Delineate Watershed step is used to delineate a watershed.
After delineating a watershed, it is possible to [[WMS:DEM Basins|manually edit]] the extents of the watershed.


'''Compute flow directions/accumulations using TauDEM or TOPAZ''' – Select this button to compute flow directions and accumulations on the DEM while delineating the watershed. If the outlet is not in a flow accumulation cell, move the outlet, and run the delineate watershed command again.  If there are flow directions and accumulations already computed, unselect this button before delineating the watersheds to save computation time. Options exists to use either [http://hydrology.usu.edu/taudem/taudem5/index.html TauDEM] (Terrain Analysis Using Digital Elevation Models) or [[WMS:TOPAZ|TOPAZ]] (Topographic Parameterization Program) to calculate flows.
==Create 2D Grid==
[[File:MWBM Wizard dialog - Create 2D Grid.png|thumb|400px|right|''MWBM Wizard'' dialog showing the "Create 2D Grid" page.]]
When this page is selected, the title of the dialog is ''Create 2D Grid''.  


'''Stream threshold value''' – This value is used to modify the stream density. Lower values will cause the streams to be more dense while higher values will create fewer streams in the completed model.
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.


'''Apply to Display''' – Select this button to apply the stream threshold value entered to the display.
For the GSSHA or ModClark models to run correctly, the X and Y dimensions of the 2D grid cells must be equal.


'''Create Tc Coverage''' – If this toggle is selected, a Time Computation coverage containing an arc with the longest flow path is created after delineating the watershed and sub-basins.
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.
{{-}}


'''Units''' – This button is used to define the model and computation coordinates and units. Turn on the option to create a Tc coverage and change which data is computed by selecting the ''Drain Data Compute Opts...'' button in the ''Units'' dialog.
==GSSHA Parameters==
[[File:MWBM Wizard dialog - GSSHA Parameters.png|thumb|400px|right|''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'' &ndash; A drop-down populated by values from the ''Land use parameters'' spreadsheet. The default value is "<none>".
**''Description 2'' &ndash; A second alphanumeric description for the land use entry. Often left blank, but can be used if further disambiguation is needed. User-editable.
**''Hydraulic conductivity'' &ndash; ''K<sub>sat</sub>'' value in units per hour (default is cm/hr). User-editable.
**''Capillary head'' &ndash; Head value in centimeters. User-editable.
**''Porosity'' &ndash; Porosity value in units<sup>3</sup>/units<sup>3</sup> (default is m<sup>3</sup>/m<sup>3</sup>). User-editable.
**''Pore distribution index'' &ndash; Pore size distribution value in units/units (default is cm/cm). User-editable.
**''Residual saturation'' &ndash; Residual saturation value in units<sup>3</sup>/units<sup>3</sup> (default is m<sup>3</sup>/m<sup>3</sup>). User-editable.
**''Field capacity'' &ndash; Specific retention value in units<sup>3</sup>/units<sup>3</sup> (default is m<sup>3</sup>/m<sup>3</sup>). User-editable.
**''Wilting point'' &ndash; Saturation value in the soil of the minimal amount of water that plants require to not wilt, in units<sup>3</sup>/units<sup>3</sup> (default is m<sup>3</sup>/m<sup>3</sup>). User-editable.
**''Coefficient for detachment by rainfall'' &ndash; Ratio of sediment detachment by rainfall, 1/J. User-editable.
**''Rill erodibility coefficient'' &ndash; A value in seconds per meter (s/m). User-editable.
**''Rill erodibility exponent'' &ndash; A dimensionless value. User-editable.
**''Critical rill detachment'' &ndash; A force value in Pascals (Pa). User-editable.
**''Erodibility coefficient'' &ndash; A dimensionless value. User-editable.
**''Medium Gravel'' &ndash; 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'' &ndash; 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'' &ndash; 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'' &ndash; 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.


After delineating a watershed, it is possible to [[WMS:DEM Basins|manually edit the extents of the watershed.]]
The GSSHA Parameters step is used to specify the land use and soil type parameters used in GSSHA.


==Create 2D Grid==
'''Land use parameters''' &ndash; Specify the land use ID, Descriptions, and Manning's n value.
When this page is selected, the title of the dialog is ''Create 2D Grid''.  


==GSSHA Parameters==
'''Soil Type Parameters''' &ndash; Specify the Soil ID, Texture, descriptions, initial moisture conditions, Land Use IDs, Hydraulic Conductivity, Capillary head, Porosity, pore distribution, residual saturation, field capacity, and wilting point.
When this page is selected, the title of the dialog is ''GSSHA Parameters''.  


==Land Use/Soil==
==Land Use/Soil==

Revision as of 23:27, 20 March 2019

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.

The GSSHA Parameters step is used to specify the land use and soil type parameters used in GSSHA.

Land use parameters – Specify the land use ID, Descriptions, and Manning's n value.

Soil Type Parameters – Specify the Soil ID, Texture, descriptions, initial moisture conditions, Land Use IDs, Hydraulic Conductivity, Capillary head, Porosity, pore distribution, residual saturation, field capacity, and wilting point.

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.