WMS:Pipe and Node Parameters: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(46 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Overview ==
{{TOC right}}[[File:GsshaPipeNodeParameters.png|thumb|right|550px|GSSHA ''Pipe and Node Parameters'' dialog.]]
The GSSHA ''Pipe and Node Parameters'' dialog is accessed by clicking [[File:Dot dot dot button.png|16px]] in the ''Edit Pipes and Nodes'' column in the GSSHA feature arcs [[WMS:GSSHA Feature Arcs#Properties (GSSHA Storm Drain)|''Properties'' dialog]]. This is only accessible when a [[WMS:GSSHA Storm Drain#GSSHA Storm Drain Coverage|GSSHA storm drain coverage]] is active. This dialog is used for building and editing the pipes and nodes associated with superlinks (arcs) and superjunctions (nodes) when running a GSSHA storm and tile drain simulation.


[[Image:GsshaPipeNodeParameters.png|thumb|500 px|GSSHA ''Pipe and Node Parameters'' dialog]]
When running a GSSHA storm and tile drain simulation, it is recommended to add more than one pipe (two nodes) between superjunctions. In WMS, superlinks are represented as arcs and superjunctions are represented by the two nodes at the end of each arc. Each link may contain one or more pipes and two or more nodes. Many of the attributes between superjunctions and nodes between superjunctions overlap.


The ''GSSHA Pipe and Node Parameters'' dialog is accessed by selecting one or more feature arcs, going to the ''GSSHA Feature Arc Properties'' dialog, and changing the arc type to Pipe. This dialog is used for building and editing the pipes and nodes associated with Super-Links when running a GSSHA Storm and Tile drain simulation.
If a specific parameter needs to be copied to all or some other pipes or nodes below the one currently selected, click and hold the small square at the bottom right corner of the selection and drag down until the value is copied to the desired cells. Double-clicking on this square will copy the selected value to all entries below it.


== Help ==
If wanting all the attributes for the displayed arcs to be the same, set the value in the top cell of the dialog. Double-click on the small square in the lower left corner of the selected field (below) and the attribute will be copied to all the other pipes or nodes that are displayed.
[[File:WMS GSSHA selection square example.png|none|left|100px|border]]


When running a GSSHA Storm and Tile drain simulation, it is a good idea to add more than one pipe (2 nodes) between Super-Junctions.  In WMS, Super-Links are represented as arcs and Super-Junctions are represented by the 2 nodes at the end of each arc. Each link may contain 1 or more pipes and 2 or more nodes.  Many of the attributes between Super-Junctions and nodes between Super-Junctions overlap.  In WMS, users define nodes along a Super-Link (between Super-Junctions) by adding vertices along an arc. A user can [[WMS:Feature Objects Menu#Redistribute|redistribute the vertices]] on the arc using the '''Redistribute''' command or can manually add vertices along an arc using the '''Create Vertex''' tool. Normally, the following steps are to define storm or tile drains and their attributes in WMS:
The following buttons are found at the bottom of this dialog:
*'''Help''' – Opens this article in a web browser.
*'''OK''' – Saves all changes and closes the GSSHA ''Pipe and Node Parameters'' dialog.
*'''Cancel''' – Discards all changes and closes the GSSHA ''Pipe and Node Parameters'' dialog.


* Create a new GSSHA storm drain coverage and define the storm or tile drain geometry using arcs.
The superlink number is displayed at the top of each set of superlink attributes.  
* Define the storm or tile drain attributes for each arc (Super-Link) using the ''GSSHA Arc Properties'' dialog.


:[[Image:GsshaPipeArcProperties.png|thumb|none|left|500 px|GSSHA Arc ''Properties'' dialog]]
==Pipes==
In the ''Pipes'' section, the following options are available at the top:
*'''Initialize Pipes from Arc Geometry''' – Creates a pipe for each arc segment on the selected arc and creates a node for each node or vertex on the arc. Attributes associated with the superlink (arc) and superjunctions (nodes) are transferred to the generated pipes and nodes, but these transferred data values can be edited. Node ground surface elevations are extracted from the 2D grid elevations at the location of each node or vertex on the selected arc. These pipes and nodes are output to the GSSHA Storm Pipe Network (SPN) file when the GSSHA project run. It is important to define pipe and node parameters for all the pipe arcs in the storm or tile drain network.
*'''Delete Pipes''' – Delete the selected pipe(s) and nodes from the arc. Re-initialize the pipes from the arc geometry after making any changes that need to be made or WMS may not output the correct pipe and node attributes for the selected arc.
*''Show'' – Affects both the ''Pipes'' and ''Nodes'' spreadsheets. A drop-down with the following options:
**"Current arc" – Shows only pipes associated with the current arc described on the row in the GSSHA feature arcs [[WMS:GSSHA Feature Arcs#Properties (GSSHA Storm Drain)|''Properties'' dialog]] where the [[File:Dot dot dot button.png|16px]] button was clicked when opening this dialog.
**"Selected arcs" – Shows only pipes associated with the arcs currently selected in the Main Graphics Window.
**"All arcs" – Shows pipes associated with all arcs on the GSSHA storm drain coverage.


* Define the storm or tile drain attributes and pipe invert elevations for the nodes at each end of the arcs (Super-Junctions) using the ''GSSHA Point/Node Properties'' dialog.
The spreadsheet has the following columns:
*''Pipe Type'' – A drop-down with the following options:
**"Circular"
**"Rectangular"
*''Diameter/Height'' – A decimal value in meters for diameter (circular pipes) or height (rectangular pipes).
*''Width'' – A decimal value in meters.
*''Slope'' – A decimal ratio of horizontal rise to one unit of vertical rise (m/m).
*''Manning's n'' – A decimal Manning's ''n'' roughness value.
*''Length'' – A decimal distance in meters.
*''Conductance'' – A decimal distance value describing the average distance water travels through the pipe walls in centimeters per hour.
*''Drain Spacing'' – A decimal distance in meters for regularly-spaced openings that allow water to infiltrate into the groundwater.


:[[Image:GsshaPipePointProperties.png|thumb|none|left|500 px|GSSHA Point/Node ''Properties'' dialog]]
===Adverse Slope Detection===
If a segment on an arc has an adverse slope, and the option to [[WMS:Display Options|display adverse slopes]] is turned on, WMS displays in red the arc with the adverse slope. If any of the stream or pipe arcs in a GSSHA model have adverse slopes, an warning will display in the [[WMS:GSSHA#GSSHA Model Check|''GSSHA Model Check'' dialog]] indicating which pipe arc IDs have adverse slopes.


* For each arc (Super-Link), redistribute the vertices along the arc using the redistribute vertices command and/or manually add vertices along each arc. The spacing and number of vertices on an arc define the pipes and nodes on the arc and the lengths and slopes of the pipes.
==Nodes==
* Define the attributes of the pipes and nodes for each arc (Super-Link) by going to the ''GSSHA Arc Properties'' dialog and clicking on the '''Edit Pipes and Nodes''' button.
The distribution of vertices (nodes) along an arc (superlink) in the GSSHA storm drain coverage is important in the storm/tile drain model used by GSSHA. Space nodes closely near junctions and farther apart toward the center of the superlink. WMS has an option in the [[WMS:Feature Objects Menu#Redistribute|'''Redistribute Vertices''' dialog]] for feature arcs that allows for defining a second bias. Each of the bias values defines the ratio of spacing between vertices at the center of the arc and at the middle of the arc. Use the same bias value along with a specified vertex spacing or a number of vertex segments to define vertices close together at the ends and far apart at the center of the superlink.
* From the ''Pipe and Node Parameters'' dialog, users can Initialize the Pipes from the Arc Geometry.  Clicking on this button creates a pipe for each arc segment on the selected arc and creates a node for each node or vertex on the arc. Attributes associated with the Super-Link (arc) and Super-Junctions (arc nodes) are transferred to the generated pipes and nodes, but users are free to edit these transferred data values.  Node ground surface elevations are extracted from the 2D grid elevations at the location of each node or vertex on the selected arc.  These pipes and nodes are written to the GSSHA Storm Pipe Network (*.spn) file when the GSSHA project is written.  It is important to define pipe and node parameters for all the pipe arcs in the storm or tile drain network.  Deleting the pipes will delete the pipes and nodes from the arc, but users should re-initialize the pipes from the arc geometry after making any changes that need to be made or WMS may not write the correct pipe and node attributes for the selected arc.


Refer to the [[WMS:WMS Tutorials|GSSHA Subsurface Tile and Storm Drain tutorial]] for more information about how to setup a storm or tile drain model.
WMS 10.0 and later versions automatically update the pipes and nodes for a superlink when a vertex is added or deleted along an arc. When redistributing vertices on an arc, WMS updates the pipes and nodes on that arc. The attributes for the new pipes and nodes are assigned based on the attributes assigned to the arc and the upstream superjunction point before adding vertices to the arc.


== Tools for Editing GSSHA Storm and Tile Drain Data ==
WMS 10.0 and later versions also have an option in the WMS ''Display Options'' that allows displaying a special symbol for any nodes or superjunctions in the GSSHA Storm Drain coverage that have more than zero inlets.


WMS 10.0 and later versions have several specialized tools for editing storm and tile drain data.  These tools are described in this section.
The ''Nodes'' spreadsheet has the following columns:
 
*''Ground Surface Elevation'' – A decimal elevation value in meters.
=== Varied node distribution on an arc ===
*''Invert Elevation'' – A decimal elevation value in meters.
 
*''Manhole Area'' – A decimal area value in square meters.
The distribution of vertices (nodes) along an arc (superlink) in the GSSHA Storm Drain coverage is important in the storm/tile drain model used by GSSHA.  Users should space nodes closely near junctions and farther apart toward the center of the superlink.  WMS has an option under the '''Redistribute''' option for feature arcs that allows for defining a second bias.  Each of the bias values defines the ratio of spacing between vertices at the center of the arc and at the middle of the arc.  Use the same bias value along with a specified vertex spacing or a number of vertex segments to define vertices close together at the ends and far apart at the center of the superlink.  See the images below.
*''Inlet Type'' – A drop-down with the following options:
 
**"0 grate inlets (no flow capture)"
:[[Image:GsshaStormDrainRedistributeFig1.png|thumb|none|left|500 px|''Redistribute'' menu command]]
**"1 grate inlets"
 
**"2 grate inlets"
:[[Image:GsshaStormDrainRedistributeFig2.png|thumb|none|left|500 px|''Redistribute'' bias options]]
**"3 grate inlets"
 
**"4 grate inlets"
:[[Image:GsshaStormDrainRedistributeFig3.png|thumb|none|left|500 px|Effect of the ''bias'' option]]
**"5 grate inlets"
 
**"6 grate inlets"
=== GSSHA Storm Drain coverage ===
**"7 grate inlets"
 
**"8 grate inlets"
In WMS 10.0 and later, '''Pipe''' arc types are no longer defined in a GSSHA coverage. They are defined in a ''GSSHA Storm Drain'' coverage so pipes drawn inside of WMS do not impact stream elevations in the GSSHA coverage.
**"9 grate inlets (all flow captured)"
 
**"Node connects to junction"
:[[Image:GsshaStormDrainCoverageFig1.png|thumb|none|left|500 px|The GSSHA Storm Drain coverage has been separated from the GSSHA Coverage]]
*''Weir Side Length'' – A decimal length value in meters.
 
*''Orifice Diameter'' – A decimal diameter value in meters.
If there is an existing GSSHA project with pipe arcs in a GSSHA coverage, WMS converts these arcs to generic arcs in the GSSHA coverage and copies the pipes into a GSSHA Storm Drain coverage. This transition should work seamlessly, without needing to do any work.  Existing files with a GSSHA storm drain coverage can be read and should be able to be re-written and run in GSSHA from the WMS interface.  Users may want to delete the generic arcs that were pipes and are left in the GSSHA coverage, or can leave them there.  WMS does not put up any messages when converting a file from the single coverage to the GSSHA and GSSHA Storm Drain coverage model to avoid annoying users.
*''Hydrograph output'' – Turn on to enable output to a hydrograph. GSSHA hydrographs are displayed at node/vertex locations instead of at grid cell centers since WMS reads the hydrographs based on link/node, pipe/node, or superjunction numbers.
 
=== Auto-Updates of Pipes and Nodes and Attributes ===
 
WMS 10.0 and later versions automatically update the pipes and nodes for a superlink when a vertex is added or deleted along an arc.  When redistributing vertices on an arc, WMS updates the pipes and nodes on the arc.  The attributes for the new pipes and nodes are assigned based on the attributes assigned to the arc and the upstream superjunction point before adding vertices to the arc.
 
=== Elevation Interpolation Tools ===
 
WMS 10.0 and later versions have an '''Interpolate Between Nodes''' option when the user right-clicks on arcs.  With this command, users can define an elevation at one or both of the nodes at the ends of the arc and then select this command.  This command uses linear interpolation to assign the vertex elevations between the nodes at the ends of the arc.  WMS also has a '''Smooth Stream/Pipe Arcs''' menu command that allows users to select points along a single arc and use linear interpolation between to assign elevations between the points.  See the images below.
 
:[[Image:GsshaStormDrainElevationInterpFig1.png|thumb|none|left|500 px|The Interpolate Between Nodes menu command]]
 
:[[Image:GsshaStormDrainElevationInterpFig2.png|thumb|none|left|500 px|The Interpolate Selected Points button in the GSSHA Smooth Streams dialog]]
 
:[[Image:GsshaStormDrainElevationInterpFig3.png|thumb|none|left|500 px|The result after interpolating between selected points]]
 
=== Storm/Tile Drain Adverse Slope Detection ===
 
If a segment on the arc has an adverse slope and the option to display adverse slopes is turned on, WMS displays the adverse slope in red.  If any of the stream or pipe arcs in a GSSHA model have adverse slopes, the following error message is displayed when running the '''Model Check''' command under the GSSHA menu:
<blockquote>
''WARNING: The following pipe arc IDs have adverse slopes: <arc number>.  It is recommended that you turn on adverse slopes in the WMS display options and correct any adverse slopes.''
</blockquote>
The user then has the opportunity to turn on adverse slopes in the display options and correct any adverse slopes.  See the images below:
 
:[[Image:GsshaStormDrainAdverseSlopeFig1.png|thumb|none|left|500 px|The Interpolate Between Nodes menu command]]
 
:[[Image:GsshaStormDrainAdverseSlopeFig2.png|thumb|none|left|500 px|Adverse slopes in the model checker]]
 
=== Editing Pipe and Node Parameters for Multiple Arcs ===
 
WMS 10.0 and later versions have a combo box at the top of the Pipe and Node Parameters dialog that allows you to show only the current arc, selected arcs, or all arcs.  If the ''Current arc'' option is selected, only the pipes and nodes for the current arc are displayed, and so on. If you want to re-initialize all the pipes and nodes from the arc geometry, select the option to show ''All arcs'' and select the '''Initialize Pipes from Arc Geometry''' button.  This will re-initialize all your pipes and nodes for all your arcs in the current GSSHA Storm Drain coverage.  Note that there’s also an option to only do this for the selected arcs.  If you want all the attributes for the displayed arcs to be the same, just set the value in the top cell of the dialog.  There is a small square in the lower right section of the cell.  Double-click on this small square and the attribute will be copied to all the other pipes or nodes that are displayed.  The superlink number is displayed at the top of each set of superlink attributes.
 
:[[Image:GsshaStormDrainPipeNodeParamsFig1.png|thumb|none|left|500 px|New options in the Pipe/Node parameters dialog]]
 
=== Identify Nodes with Surface Inlets ===
 
WMS 10.0 and later versions have an option in the WMS display options that allows you to display a special symbol for any nodes or superjunctions in the GSSHA Storm Drain coverage that have more than zero inlets.
 
:[[Image:GsshaStormDrainIdentifyNodesFig1.png|thumb|none|left|500 px|Option to turn on nodes with multiple inlets]]
 
=== Enhanced Hydrograph Output Options ===
 
WMS 10.0 and later versions have a Hydrograph output option for superjunctions as well as for each of the nodes in a superlink. GSSHA hydrographs are displayed at node/vertex locations instead of at grid cell centers since WMS reads the hydrographs based on link/node, pipe/node, or superjunction numbers. See the images below:
 
:[[Image:GsshaStormDrainHydrographsFig1.png|thumb|none|left|500 px|The hydrograph output option exists at each supernode in a GSSHA Storm Drain coverage]]
 
:[[Image:GsshaStormDrainHydrographsFig2.png|thumb|none|left|500 px|You can output a hydrograph for each node in a GSSHA Storm Drain coverage]]
 
:[[Image:GsshaStormDrainHydrographsFig3.png|thumb|none|left|500 px|A display showing multiple output hydrographs in a GSSHA Storm Drain coverage]]




{{GSSHA Wiki}}
{{WMSMain}}
{{WMSMain}}


[[Category:GSSHA|P]]
[[Category:GSSHA|Pipe]]
[[Category:GSSHA Dialogs|Pipe]]
[[Category:WMS Display Dialogs]]
[[Category:WMS Parameters|Pipe]]
[[Category:Gallery]]

Latest revision as of 23:12, 17 May 2019

GSSHA Pipe and Node Parameters dialog.

The GSSHA Pipe and Node Parameters dialog is accessed by clicking Dot dot dot button.png in the Edit Pipes and Nodes column in the GSSHA feature arcs Properties dialog. This is only accessible when a GSSHA storm drain coverage is active. This dialog is used for building and editing the pipes and nodes associated with superlinks (arcs) and superjunctions (nodes) when running a GSSHA storm and tile drain simulation.

When running a GSSHA storm and tile drain simulation, it is recommended to add more than one pipe (two nodes) between superjunctions. In WMS, superlinks are represented as arcs and superjunctions are represented by the two nodes at the end of each arc. Each link may contain one or more pipes and two or more nodes. Many of the attributes between superjunctions and nodes between superjunctions overlap.

If a specific parameter needs to be copied to all or some other pipes or nodes below the one currently selected, click and hold the small square at the bottom right corner of the selection and drag down until the value is copied to the desired cells. Double-clicking on this square will copy the selected value to all entries below it.

If wanting all the attributes for the displayed arcs to be the same, set the value in the top cell of the dialog. Double-click on the small square in the lower left corner of the selected field (below) and the attribute will be copied to all the other pipes or nodes that are displayed.

WMS GSSHA selection square example.png

The following buttons are found at the bottom of this dialog:

  • Help – Opens this article in a web browser.
  • OK – Saves all changes and closes the GSSHA Pipe and Node Parameters dialog.
  • Cancel – Discards all changes and closes the GSSHA Pipe and Node Parameters dialog.

The superlink number is displayed at the top of each set of superlink attributes.

Pipes

In the Pipes section, the following options are available at the top:

  • Initialize Pipes from Arc Geometry – Creates a pipe for each arc segment on the selected arc and creates a node for each node or vertex on the arc. Attributes associated with the superlink (arc) and superjunctions (nodes) are transferred to the generated pipes and nodes, but these transferred data values can be edited. Node ground surface elevations are extracted from the 2D grid elevations at the location of each node or vertex on the selected arc. These pipes and nodes are output to the GSSHA Storm Pipe Network (SPN) file when the GSSHA project run. It is important to define pipe and node parameters for all the pipe arcs in the storm or tile drain network.
  • Delete Pipes – Delete the selected pipe(s) and nodes from the arc. Re-initialize the pipes from the arc geometry after making any changes that need to be made or WMS may not output the correct pipe and node attributes for the selected arc.
  • Show – Affects both the Pipes and Nodes spreadsheets. A drop-down with the following options:
    • "Current arc" – Shows only pipes associated with the current arc described on the row in the GSSHA feature arcs Properties dialog where the Dot dot dot button.png button was clicked when opening this dialog.
    • "Selected arcs" – Shows only pipes associated with the arcs currently selected in the Main Graphics Window.
    • "All arcs" – Shows pipes associated with all arcs on the GSSHA storm drain coverage.

The spreadsheet has the following columns:

  • Pipe Type – A drop-down with the following options:
    • "Circular"
    • "Rectangular"
  • Diameter/Height – A decimal value in meters for diameter (circular pipes) or height (rectangular pipes).
  • Width – A decimal value in meters.
  • Slope – A decimal ratio of horizontal rise to one unit of vertical rise (m/m).
  • Manning's n – A decimal Manning's n roughness value.
  • Length – A decimal distance in meters.
  • Conductance – A decimal distance value describing the average distance water travels through the pipe walls in centimeters per hour.
  • Drain Spacing – A decimal distance in meters for regularly-spaced openings that allow water to infiltrate into the groundwater.

Adverse Slope Detection

If a segment on an arc has an adverse slope, and the option to display adverse slopes is turned on, WMS displays in red the arc with the adverse slope. If any of the stream or pipe arcs in a GSSHA model have adverse slopes, an warning will display in the GSSHA Model Check dialog indicating which pipe arc IDs have adverse slopes.

Nodes

The distribution of vertices (nodes) along an arc (superlink) in the GSSHA storm drain coverage is important in the storm/tile drain model used by GSSHA. Space nodes closely near junctions and farther apart toward the center of the superlink. WMS has an option in the Redistribute Vertices dialog for feature arcs that allows for defining a second bias. Each of the bias values defines the ratio of spacing between vertices at the center of the arc and at the middle of the arc. Use the same bias value along with a specified vertex spacing or a number of vertex segments to define vertices close together at the ends and far apart at the center of the superlink.

WMS 10.0 and later versions automatically update the pipes and nodes for a superlink when a vertex is added or deleted along an arc. When redistributing vertices on an arc, WMS updates the pipes and nodes on that arc. The attributes for the new pipes and nodes are assigned based on the attributes assigned to the arc and the upstream superjunction point before adding vertices to the arc.

WMS 10.0 and later versions also have an option in the WMS Display Options that allows displaying a special symbol for any nodes or superjunctions in the GSSHA Storm Drain coverage that have more than zero inlets.

The Nodes spreadsheet has the following columns:

  • Ground Surface Elevation – A decimal elevation value in meters.
  • Invert Elevation – A decimal elevation value in meters.
  • Manhole Area – A decimal area value in square meters.
  • Inlet Type – A drop-down with the following options:
    • "0 grate inlets (no flow capture)"
    • "1 grate inlets"
    • "2 grate inlets"
    • "3 grate inlets"
    • "4 grate inlets"
    • "5 grate inlets"
    • "6 grate inlets"
    • "7 grate inlets"
    • "8 grate inlets"
    • "9 grate inlets (all flow captured)"
    • "Node connects to junction"
  • Weir Side Length – A decimal length value in meters.
  • Orifice Diameter – A decimal diameter value in meters.
  • Hydrograph output – Turn on to enable output to a hydrograph. GSSHA hydrographs are displayed at node/vertex locations instead of at grid cell centers since WMS reads the hydrographs based on link/node, pipe/node, or superjunction numbers.