WMS:HY-12: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(59 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The US Federal Highway Administration's HY-12 is a DOS-based storm drain analysis program that can be used for designing inlets, pipes, and the general layout of a storm drain network. An HY-12 model can be generated by drawing the proposed pipe and inlet locations in a storm drain coverage. Then the map module locations are converted to a 1D schematic where the HY-12 model parameters are defined. Many of the HY-12 computations, such as channel calculations, curb and gutter calculations, and rational method computations, are based on computations in FHWA's Hydraulic Toolbox software. Users can refer to both the Hydraulic Toolbox and the HY-12 documentation to learn about the specific computation methods used in HY-12.  
{{WMS Unsupported}}
The US Federal Highway Administration's HY-12 is a DOS-based storm drain analysis program that can be used for designing inlets, pipes, and the general layout of a storm drain network. An HY-12 model can be generated by drawing the proposed pipe and inlet locations in a storm drain coverage. Then the map module locations are converted to a 1D schematic where the HY-12 model parameters are defined. Many of the HY-12 computations, such as channel calculations, curb and gutter calculations, and rational method computations, are based on computations in FHWA's Hydraulic Toolbox software. Refer to both the [https://www.fhwa.dot.gov/engineering/hydraulics/software/toolbox404.cfm Hydraulic Toolbox] and the [http://wmsdocs.aquaveo.com/HY-12_User_Manual.pdf HY-12 documentation] to learn about the specific computation methods used in HY-12.
 
The HY-12 model is included with all [http://www.aquaveo.com/software/wms-pricing paid editions] of WMS. [[Category:Link to Store]] WMS 10.1 and later versions include the ability to run a simple HY-12 model (fewer than 50 nodes) without a license of WMS.
 
Last updated: 2022


==HY-12 Menu==
==HY-12 Menu==
The ''HY-12'' menu has the following commands:
The ''HY-12'' menu has the following commands:
* Import HY-12 File
* ''Import HY-12 File''
* Export HY-12 Export  
* ''Export HY-12 Export''
* Run HY-12 – opens the ''Run HY-12 Simulation'' dialog.
* ''Run HY-12'' – Opens the ''Run HY-12 Simulation'' dialog.
* Edit Project Parameters – Opens an ''Edit Properties'' dialog where parameters for the project can be specified.
* ''Edit Project Parameters'' – Opens an [[WMS:HY-12#HY-12_Project_Properties|''HY-12 Properties'']] dialog where parameters for the project can be specified.
* Edit Parameters – Opens an ''Edit Properties'' dialog where parameters for nodes and links can be specified.
* ''Edit Parameters'' – Opens an [[WMS:HY-12#HY-12_Node_and_Link_Properties|''HY-12 Properties'']] dialog where parameters for nodes and links can be specified.
* View Detailed Link/Node Output – creates a text file describing the detailed link and node computation results.
* ''Edit Elevations'' – Opens an [[WMS:HY-12#Edit_Elevations|''Edit Link/Node Elevations'']] dialog that allows editing link and node elevations between selected links and/or nodes.
* View Hydrographic Plots  
* ''View Detailed Link/Node Output'' – Creates a text file describing the detailed link and node computation results.
* View EGL and HGL Plots – Brings up the ''EGL and HGL Profiles'' dialog.
* ''View Hydrographic Plots'' – Shows hydrograph plots for the selected link and/or node (Unsteady flow simulations only).
* Link Outlets and Inlets – brings up the ''Link Storm Drain and Drainage Nodes'' dialog.
* ''View EGL and HGL Plots'' – Brings up the ''EGL and HGL Profiles'' dialog.
* ''Link Outlets and Inlets'' – Brings up the ''Link Storm Drain and Drainage Nodes'' dialog.
[[Image:WMS HY12 Select Elevation Source.jpg|thumb|200 px|HY-12 ''Select Elevation Source'' dialog]]
[[Image:WMS HY12 Select Elevation Source.jpg|thumb|200 px|HY-12 ''Select Elevation Source'' dialog]]
* Assign Elevations – this group of commands will assign elevation data from a TIN to each node and link. Each command brings up a corresponding ''Select Elevation Source'' dialog where the elevation source data can be selected.
* ''Assign Elevations'' – This group of commands will assign elevation data from a TIN to each node and link. Each command brings up a corresponding ''Select Elevation Source'' dialog where the elevation source data can be selected.
** To Ground
** To Ground
** To Access Hole
** To Access Hole
Line 20: Line 26:
** To Channels
** To Channels
** To Gutters
** To Gutters
** Pipes
** To Pipes
** Pipe Storage
** To Pipe Storage
* Assign Lengths and Orientations
* ''Assign Lengths and Orientations''
* Assign Hydrology Data
* ''Assign Hydrology Data''
** Area – This command assigns the computed basin areas upstream from the outlet points when having linked to the rational method computations at each node.
** Area – This command assigns the computed basin areas upstream from the outlet points when having linked to the rational method computations at each node.
** Runoff Coefficient – This command areaweights the runoff coefficients for the sub-basins assigned to each outlet and assigns the area-weighted runoff coefficient to the rational method computations at each node.
** Runoff Coefficient – This command areaweights the runoff coefficients for the sub-basins assigned to each outlet and assigns the area-weighted runoff coefficient to the rational method computations at each node.
** Time of Concentration – This command computes the average time of concentration for the sub-basins assigned to each outlet and assigns this time of concentration to the rational method computations at each node.
** Time of Concentration – This command computes the average time of concentration for the sub-basins assigned to each outlet and assigns this time of concentration to the rational method computations at each node.
[[Category:WMS Menus|HY-12]]


==HY-12 Parameters==
==HY-12 Parameters==
Line 33: Line 40:
===HY-12 Project Properties===
===HY-12 Project Properties===
The ''HY-12 Properties'' is reached by using the '''Edit Project Parameters''' command in the ''HY-12'' menu.
The ''HY-12 Properties'' is reached by using the '''Edit Project Parameters''' command in the ''HY-12'' menu.
:[[Image:WMS HY12 Properties.jpg|thumb|none|left|500 px|Project ''HY-12 Properties'' dialog]]
:[[Image:WMS HY12 Properties.png|thumb|none|left|500 px|Project ''HY-12 Properties'' dialog]]
 
===HY-12 Node and Link Properties===
Select either a node or a link using the '''Select Hydraulic Node''' tool or the '''Select Hydraulic Link''' tool then right-click. In the right-click menu select the '''Edit Parameters''' command. This will bring up the ''HY-12 Properties'' dialog for Nodes and Links. This dialog can also be reached by using the '''Edit Parameters''' command in the ''HY-12'' dialog.
 
[[Image:WMS HY12 Simplified Properties.png|thumb|500 px|''HY-12 Simplified Properties'' dialog for Nodes and Links]] There are two versions of the HY-12 link/node properties dialog.  The simplified interface provides an intuitive way to edit link and node information and many projects will only require using this interface.  A person can add pipes or channels to links in the simplified interface.  A person can also add Rational method calculations, inlets, access holes, or outfalls to nodes in the simplified interface.  Using the simplified interface, it's not necessary to define advanced attributes that are not normally needed in an HY-12 storm drain simulation.  A useful feature in the simplified link/node properties dialog is the ability to sort data based on any of the attributes.  For example, if wanting to find any pipes with negative slopes, it's possible to sort links based on slope and any link with a negative slope would show up at the top of the list.


===HY-12 Nodes and Links Properties===
[[Image:WMS HY12 Nodal Links Properties.jpg|thumb|500 px|''HY-12 Properties'' dialog for Nodes and Links]]
[[Image:WMS HY12 Nodal Links Properties.jpg|thumb|500 px|''HY-12 Properties'' dialog for Nodes and Links]]
Select either a node or a link using the '''Select Hydraulic Node Tool''' or the '''Select Hydraulic Link Tool''' then right-click. In the right-click menu select the '''Edit Parameters''' command. This will bring up the ''HY-12 Properties'' dialog for Nodes and Links. This dialog can also be reached by using the '''Edit Parameters''' command in the ''HY-12'' dialog.


*Attribute Type – lets the user choose between viewing ''nodes'' or ''links''.  
If needing to define structures that are not supported in the simplified interface or if needing to define advanced structure parameters, turn on the ''Use Advanced Interface'' option in the ''HY-12 Project Parameters'' dialog and edit the project parameters using the advanced interface.
*Show – this option lets users to search between ''all'' or ''selected'' nodes or links.
 
*Filter using: Type – this combo box allows the user to view nodes or links based on the structure type.
====Information on tems in the Advanced interface dialog====
*Group Name
*''Attribute Type''' – Chooses between viewing ''nodes'' or ''links''.  
*Value/HY-12 ID – this column shows the node or link value and the corresponding HY-12 ID.
*''Show'' – Searches between ''all'' or ''selected'' nodes or links.
*Structure Type – The structure type for the node or link is assigned in this field. Selecting the '''New''' button will assign the structure type. The following structure types are available:
*''Filter using: Type'' – Views nodes or links based on the structure type.
*''Group Name'' – Not used
*''Value/HY-12 ID'' – Shows the node or link value and the corresponding HY-12 ID.
*''Structure Type'' – Assigns the structure type for the node or link. Selecting the '''New''' button will assign the structure type. The following structure types are available:
::{|class="wikitable"
::{|class="wikitable"
|-
|-
Line 58: Line 71:
|-
|-
| Outfall ||
| Outfall ||
|-
| Pump Station ||
|-
|-
| Rational Method Basin ||
| Rational Method Basin ||
Line 66: Line 81:
|}
|}


*Structure Name
*''Structure Name''
**New – clicking on this button will assign the structure type to the selected nodes or links.
**New – Clicking on this button will assign the structure type to the selected nodes or links.
*Define Structure
*''Define Structure''
**Define – selecting this button will bring up a ''HY-12 Properties'' dialog where definitions for the structure type can be entered.
**Define – Selecting this button will bring up a ''HY-12 Properties'' dialog where definitions for the structure type can be entered.
*::[[File:WMS HY-12 Define Node Properties.jpg|thumb|none|400 px|Example of the ''HY-12 Properties'' dialog as reached through the '''Define''' button in the Nodes and Links ''HY-12 Properties'' dialog. This dialog is for defining Access Hole structures.]]
*::[[File:WMS HY-12 Define Node Properties.png|thumb|none|400 px|Example of the ''HY-12 Properties'' dialog as reached through the '''Define''' button in the Nodes and Links ''HY-12 Properties'' dialog. This dialog is for defining Access Hole structures.]]
*Structure Downstream – shows structures assigned as downstream structures.  
*''Structure Downstream''' – Shows structures assigned as downstream structures.  
*Delete Structure   
*''Delete Structure''  
**Delete – removes the assigned structure type.
**Delete – Removes the assigned structure type.


Once parameters have been assigned for nodes and links, double-clicking on a node or link will bring up a ''HY-12 Properties'' dialog showing the attributes for that node or link.
Once parameters have been assigned for nodes and links, double-clicking on a node or link will bring up a ''HY-12 Properties'' dialog showing the attributes for that node or link.
==Edit Elevations==
The HY-12 '''Edit Elevations''' menu item is a useful tool for editing elevation profiles between selected links or nodes.  To edit elevations between two links or nodes, select the upstream and the downstream points for editing elevations and then select ''HY-12'' | '''Edit Elevations'''.  The ''Edit Link/Node Elevations'' dialog will appear.  In this dialog, modify elevation values graphically from the plot window or edit individual elevation values in the spreadsheet below the plot.
There are two buttons that may be useful for defining elevations in the storm drain network.
*'''Offset Invert Elevations from Surface Elevations''' – Allows offsetting pipes from the ground surface using either a given cover depth or a given invert depth.  A prompt will appear asking which of these options to use as well as the distance of the crown or invert below the ground after clicking on the button.
*'''Assign Invert Elevations using Constant Slope''' – Assigns pipe and node elevations to the storm drain profile based on a starting elevation as well as a slope.  By default, the starting elevation is the invert elevation of the most upstream selected point and the slope is the average slope of the storm drain network.  A prompt will appear for these two values after pressing the button.
:[[Image:WMS HY12 Edit Elevations.png|none|left|375 px|''Edit Elevations'' plot editor]]


==HGL and EGL Profiles==
==HGL and EGL Profiles==
The ''HGL and EGL Profiles'' plot is created by using the '''View HGL and EGL Plots''' command in the ''HY-12'' menu.
Hydraulic Grade Line (HGL) and Energy Grade Line (EGL) profile plots can be created after running the HY-12 model, selecting two links or nodes, and then by using the '''View HGL and EGL Plots''' command in the ''HY-12'' menu.
:[[Image:WMS HY12 HGL and EGL Profiles.jpg|none|left|375 px|''HGL and EGL Profiles'' plot]]
:[[Image:WMS HY12 HGL and EGL Profiles.png|none|left|375 px|''HGL and EGL Profiles'' plot]]


==Link Storm Drain and Drainage Nodes==
==Link Storm Drain and Drainage Nodes==
[[Image:WMS Link Storm Drain and Drainage Nodes.jpg|thumb|380 px|HY-12 ''Link Storm Drain and Drainage Nodes'' dialog]]
[[Image:WMS Link Storm Drain and Drainage Nodes.jpg|thumb|380 px|HY-12 ''Link Storm Drain and Drainage Nodes'' dialog]]
The option to link storm drain and drainage coverage nodes is a useful feature if wanting to use the rational method data from the hydrologic model as an input to the HY-12 model.  After defining the rational method information, use this menu item to link rational method information at the outlets in the hydrologic model to inlets in the HY-12 model.
* Storm Drain Nodes
* Storm Drain Nodes
* Drainage Nodes
* Drainage Nodes
Line 92: Line 119:


==Run HY-12==
==Run HY-12==
The '''Run HY-12''' command will bring up the ''Run HY-12 Simulation'' dialog where specifications can be reviewed. Clicking '''OK''' on this dialog will run the model.
The '''Run HY-12''' command will bring up the ''Run HY-12 Simulation'' dialog where specifications can be reviewed. Clicking '''OK''' on this dialog will run the model.  HY-12 simulations with more that 50 nodes cannot be run unless there is a license to WMS.


[[Image:WMS Run HY12 Simulation.jpg|thumb|none|left|500 px|''Run HY-12 Simulation'' dialog]]
[[Image:WMS Run HY12 Simulation.jpg|thumb|none|left|500 px|''Run HY-12 Simulation'' dialog]]
Line 99: Line 126:
* [[WMS:Hydraulic Modeling|Hydraulic Modeling]]
* [[WMS:Hydraulic Modeling|Hydraulic Modeling]]
* [[WMS:Models|Models]]
* [[WMS:Models|Models]]
 
* [[WMS:Storm Drain|Storm Drain]]


{{WMSMain}}
{{WMSMain}}


[[Category:HY-12]]
[[Category:HY-12]]
 
[[Category:HY-12 Dialogs]]
[[Category:Needs Update]]
[[Category:External Links]]
[[Category:Archived]]

Latest revision as of 20:17, 5 June 2023

The US Federal Highway Administration's HY-12 is a DOS-based storm drain analysis program that can be used for designing inlets, pipes, and the general layout of a storm drain network. An HY-12 model can be generated by drawing the proposed pipe and inlet locations in a storm drain coverage. Then the map module locations are converted to a 1D schematic where the HY-12 model parameters are defined. Many of the HY-12 computations, such as channel calculations, curb and gutter calculations, and rational method computations, are based on computations in FHWA's Hydraulic Toolbox software. Refer to both the Hydraulic Toolbox and the HY-12 documentation to learn about the specific computation methods used in HY-12.

The HY-12 model is included with all paid editions of WMS. WMS 10.1 and later versions include the ability to run a simple HY-12 model (fewer than 50 nodes) without a license of WMS.

Last updated: 2022

HY-12 Menu

The HY-12 menu has the following commands:

  • Import HY-12 File
  • Export HY-12 Export
  • Run HY-12 – Opens the Run HY-12 Simulation dialog.
  • Edit Project Parameters – Opens an HY-12 Properties dialog where parameters for the project can be specified.
  • Edit Parameters – Opens an HY-12 Properties dialog where parameters for nodes and links can be specified.
  • Edit Elevations – Opens an Edit Link/Node Elevations dialog that allows editing link and node elevations between selected links and/or nodes.
  • View Detailed Link/Node Output – Creates a text file describing the detailed link and node computation results.
  • View Hydrographic Plots – Shows hydrograph plots for the selected link and/or node (Unsteady flow simulations only).
  • View EGL and HGL Plots – Brings up the EGL and HGL Profiles dialog.
  • Link Outlets and Inlets – Brings up the Link Storm Drain and Drainage Nodes dialog.
HY-12 Select Elevation Source dialog
  • Assign Elevations – This group of commands will assign elevation data from a TIN to each node and link. Each command brings up a corresponding Select Elevation Source dialog where the elevation source data can be selected.
    • To Ground
    • To Access Hole
    • To Inlets
    • To Outlets
    • To Channels
    • To Gutters
    • To Pipes
    • To Pipe Storage
  • Assign Lengths and Orientations
  • Assign Hydrology Data
    • Area – This command assigns the computed basin areas upstream from the outlet points when having linked to the rational method computations at each node.
    • Runoff Coefficient – This command areaweights the runoff coefficients for the sub-basins assigned to each outlet and assigns the area-weighted runoff coefficient to the rational method computations at each node.
    • Time of Concentration – This command computes the average time of concentration for the sub-basins assigned to each outlet and assigns this time of concentration to the rational method computations at each node.

HY-12 Parameters

The HY-12 Model has several HY-12 Properties dialog where parameters can be defined.

HY-12 Project Properties

The HY-12 Properties is reached by using the Edit Project Parameters command in the HY-12 menu.

Project HY-12 Properties dialog

HY-12 Node and Link Properties

Select either a node or a link using the Select Hydraulic Node tool or the Select Hydraulic Link tool then right-click. In the right-click menu select the Edit Parameters command. This will bring up the HY-12 Properties dialog for Nodes and Links. This dialog can also be reached by using the Edit Parameters command in the HY-12 dialog.

HY-12 Simplified Properties dialog for Nodes and Links

There are two versions of the HY-12 link/node properties dialog. The simplified interface provides an intuitive way to edit link and node information and many projects will only require using this interface. A person can add pipes or channels to links in the simplified interface. A person can also add Rational method calculations, inlets, access holes, or outfalls to nodes in the simplified interface. Using the simplified interface, it's not necessary to define advanced attributes that are not normally needed in an HY-12 storm drain simulation. A useful feature in the simplified link/node properties dialog is the ability to sort data based on any of the attributes. For example, if wanting to find any pipes with negative slopes, it's possible to sort links based on slope and any link with a negative slope would show up at the top of the list.

HY-12 Properties dialog for Nodes and Links

If needing to define structures that are not supported in the simplified interface or if needing to define advanced structure parameters, turn on the Use Advanced Interface option in the HY-12 Project Parameters dialog and edit the project parameters using the advanced interface.

Information on tems in the Advanced interface dialog

  • Attribute Type' – Chooses between viewing nodes or links.
  • Show – Searches between all or selected nodes or links.
  • Filter using: Type – Views nodes or links based on the structure type.
  • Group Name – Not used
  • Value/HY-12 ID – Shows the node or link value and the corresponding HY-12 ID.
  • Structure Type – Assigns the structure type for the node or link. Selecting the New button will assign the structure type. The following structure types are available:
Node Structure Link Structure
Access Hole Channel
Gutter Inlet Gutter
Junction Pipe
Minor Loss Pipe Storage
Outfall
Pump Station
Rational Method Basin
Reservoir
Transition
  • Structure Name
    • New – Clicking on this button will assign the structure type to the selected nodes or links.
  • Define Structure
    • Define – Selecting this button will bring up a HY-12 Properties dialog where definitions for the structure type can be entered.
    Example of the HY-12 Properties dialog as reached through the Define button in the Nodes and Links HY-12 Properties dialog. This dialog is for defining Access Hole structures.
  • Structure Downstream' – Shows structures assigned as downstream structures.
  • Delete Structure
    • Delete – Removes the assigned structure type.

Once parameters have been assigned for nodes and links, double-clicking on a node or link will bring up a HY-12 Properties dialog showing the attributes for that node or link.

Edit Elevations

The HY-12 Edit Elevations menu item is a useful tool for editing elevation profiles between selected links or nodes. To edit elevations between two links or nodes, select the upstream and the downstream points for editing elevations and then select HY-12 | Edit Elevations. The Edit Link/Node Elevations dialog will appear. In this dialog, modify elevation values graphically from the plot window or edit individual elevation values in the spreadsheet below the plot.

There are two buttons that may be useful for defining elevations in the storm drain network.

  • Offset Invert Elevations from Surface Elevations – Allows offsetting pipes from the ground surface using either a given cover depth or a given invert depth. A prompt will appear asking which of these options to use as well as the distance of the crown or invert below the ground after clicking on the button.
  • Assign Invert Elevations using Constant Slope – Assigns pipe and node elevations to the storm drain profile based on a starting elevation as well as a slope. By default, the starting elevation is the invert elevation of the most upstream selected point and the slope is the average slope of the storm drain network. A prompt will appear for these two values after pressing the button.
Edit Elevations plot editor

HGL and EGL Profiles

Hydraulic Grade Line (HGL) and Energy Grade Line (EGL) profile plots can be created after running the HY-12 model, selecting two links or nodes, and then by using the View HGL and EGL Plots command in the HY-12 menu.

HGL and EGL Profiles plot

Link Storm Drain and Drainage Nodes

HY-12 Link Storm Drain and Drainage Nodes dialog

The option to link storm drain and drainage coverage nodes is a useful feature if wanting to use the rational method data from the hydrologic model as an input to the HY-12 model. After defining the rational method information, use this menu item to link rational method information at the outlets in the hydrologic model to inlets in the HY-12 model.

  • Storm Drain Nodes
  • Drainage Nodes
  • Linked Nodes
  • Link Nodes
  • Auto Link
  • Tolerance
  • Unlink Nodes

Run HY-12

The Run HY-12 command will bring up the Run HY-12 Simulation dialog where specifications can be reviewed. Clicking OK on this dialog will run the model. HY-12 simulations with more that 50 nodes cannot be run unless there is a license to WMS.

Run HY-12 Simulation dialog

Related Topics