SMS:HEC-RAS: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
The Hydrologic Engineering Center's (CEIWR-HEC) River Analysis System (HEC-RAS) is a one- and two-dimensional model for computing water surface profiles for steady state or gradually varied flow. HEC-RAS supports networks of channels and is capable of modeling subcritical, supercritical, and mixed flow regime profiles. HEC-RAS is able to model obstructions in the flow path.
The [http://www.hec.usace.army.mil/ Hydrologic Engineering Center's] River Analysis System (HEC-RAS) is a one- and two-dimensional model for computing water surface profiles for steady state or gradually varied flow. HEC-RAS supports networks of channels and is capable of modeling subcritical, supercritical, and mixed flow regime profiles. HEC-RAS is able to model obstructions in the flow path. Two dimensional capabilities were added to HEC-RAS 5.0 in 2016.


The SMS interface to HEC-RAS includes tools for setting up the river networks and cross-sections as well as post-processing capabilities. SMS reads and writes the HEC-GeoRAS GIS import format.
Historically, SMS and WMS have supported tools for creating and editing cross sections and attributes for these cross sections for one dimensional HEC-RAS 1D. These cross sections can be imported from the HEC-RAS system in the form of an SDF file (exported by HEC-Ras) and saved as a HEC-GeoRAS file for inclusion into a HEC-RAS project. The [[WMS:HEC-RAS|WMS package]] has also developed floodplain mapping tools to generate floodplains from HEC-RAS results.
 
With the 2D version of HEC-RAS, a new SMS interface to HEC-RAS has been added (starting with SMS 12.2). This new interface is a simulation-based interface that allows defining multiple simulations with individual settings in a single SMS project.  All of the mesh generating options supported in the SMS may be used to generate/edit a grid for use in HEC-RAS 2D.
 
SMS continues to include tools for defining river networks and cross-sections.
 
The HEC-RAS model can be added to a [http://www.aquaveo.com/software/sms-pricing paid edition] of SMS.
[[Category:Link to Store]]


==HEC-RAS Simulation==
==HEC-RAS Simulation==
Starting in SMS 12.2, HEC-RAS uses a simulation process. SMS can run multiple HEC-RAS simulations using the same components. To create a new simulation, right-click in the Project Explorer and select ''New Simulation'' | '''HEC-RAS'''. Components can then be linked to simulations by dragging the components under the simulation or by right-clicking on the component item and using the ''Link To'' submenu.
[[File:HEC-RAS Simulation SMS.png|thumb|175 px|Example of a HEC-RAS simulation in the Project Explorer]]
Starting in SMS 12.2, HEC-RAS uses a [[SMS:Simulations|simulation]] process. SMS can run multiple HEC-RAS simulations using the same components. To create a new simulation, right-click in the Project Explorer and select ''New Simulation'' | '''HEC-RAS'''. Components can then be linked to simulations by dragging the components under the simulation or by right-clicking on the component item and using the ''Link To'' submenu.


Components for the HEC-RAS simulation include the following:
Components for the HEC-RAS simulation include the following:
Line 12: Line 20:
Right-clicking on a HEC-RAS simulation provides a menu with the [[SMS:Simulations#General_Simulation_Right-Click_Menu_Commands|standard simulation menu commands]] and the following commands specific to HEC-RAS:
Right-clicking on a HEC-RAS simulation provides a menu with the [[SMS:Simulations#General_Simulation_Right-Click_Menu_Commands|standard simulation menu commands]] and the following commands specific to HEC-RAS:
* '''Model Check''' – Launches the model checker to look for problems with the simulation setup.
* '''Model Check''' – Launches the model checker to look for problems with the simulation setup.
* '''Export HEC-RAS''' – Exports the *.rasgeo file containing the mesh information that will be converted during the simulation run.
* '''Export HEC-RAS''' – Exports the mesh geometry so it can be imported into HEC-RAS.
* '''Launch HEC-RAS''' – Brings up the HEC-RAS model wrapper and starts the simulation run. At the end of the simulation run, HEC-RAS will have created a number of output files for use in the HEC-RAS program.
 
* '''Save, Export, and Launch HEC-RAS''' – Completes the processes of saving the SMS project, exporting the HEC-RAS files, and launching the HEC-RAS simulation run.
 
[[Category:SMS Simulations|HEC]]


==HEC-RAS Files==
==HEC-RAS Files==
A HEC-RAS simulation in SMS can generate a number of files for use in the HEC-RAS program. For following files are generated:
A HEC-RAS simulation in SMS will generate a number of files for use in the HEC-RAS program. The following files are generated:
* *.rasgeo – Contains the mesh data generated in SMS. This file is used to generate the other files and must be created before running the HEC-RAC simulation.
* *.g01 – HEC-RAS geometry file.
* *.g01 – HEC-RAS geometry file.
* *.g01.hdf
* *.g01.hdf
* *.prj – The HEC-RAS projection file. For post-processsing, open this file in the HEC-RAS software.
* *.prj – The HEC-RAS projection file. For post-processsing, open this file in the HEC-RAS software.
 
* *_projection.prj – The projection/coordinate system used by the project in SMS.
<!--
===HEC-RAS RASGEO File Example===
===HEC-RAS RASGEO File Example===
The RASGEO file contains unit, element, and node information from the mesh component in the HEC-RAS simulation.
The RASGEO file contains unit, element, and node information from the mesh component in the HEC-RAS simulation.
Line 49: Line 58:
  Node 9 412214.903435 2048704.060367 0.000000
  Node 9 412214.903435 2048704.060367 0.000000
  ...
  ...
-->
==HEC-RAS 1D==
[[Image:SMS Hec Ras MP.png|thumb|175 px|''HEC-RAS Material Properties'' dialog]]
[[File:SMS HecRas MC.png|thumb|200 px|''HEC-RAS Model Control'' dialog]]
SMS can export a HEC-RAS 1D model. This requires the following be available:
*1D Hyd Centerline coverage with a defined centerline arc.
*1D Hyd Cross Sections coverage with defined cross section arcs.
Materials can be defined on the 1D Hyd Cross Section coverage. However, if this is not done, the following is needed:
*An Area Properties coverage with polygon defining material areas.
*Materials assigned in the ''Material'' dialog.
Once all of the necessary components are available, the 1D HEC-RAS project can be exported through the 1D Module.
===HEC-RAS Menu===
The ''HEC-RAS'' menu is available when the 1D Module is the active module. The menu contains the following commands:
* '''Export HEC-RAS Project File''' &ndash; Brings up a save window to export the HEC-RAS 1D project file. This file can then be opened in HEC-RAS or in WMS.
* '''Material Properties''' &ndash; Opens the ''HEC-RAS Material Properties'' dialog. In this dialog, a list of all materials defined in the ''Materials'' dialog will appear. Roughness can be assigned to each material. Also, the property type that is being used for the material values must be specified in the ''HEC-RAS Model Control'' dialog.
* '''Model Control''' &ndash; Opens the ''HEC-RAS Model Control'' dialog. This dialog allows applying roughness to a cross section databases. A list of available cross section databases will be on the left. On the right, select if roughness will or will not be applied to a database.


==HEC-RAS Troubleshooting==
==HEC-RAS Troubleshooting==
Starting in SMS 12.2, HEC-RAS uses the dynamic model interface. If HEC-RAS was purchased through Aquaveo, the DMI file and HEC-RAS library was included in the installation and should be available for use when starting SMS.
Starting in SMS 12.2, HEC-RAS uses the dynamic model interface. If HEC-RAS was purchased through Aquaveo, the DMI file and HEC-RAS library was included in the installation and should be available for use when starting SMS.
<!--
If installing HEC-RAS to an existing version of SMS 12.2 or later, the XML file must be placed in the ''DynamicXml'' directory inside the SMS program directory. HEC-RAS also requires a translator. The RAS2D_translator folder should be placed in the ''Models'' directory inside the SMS program directory.
SMS needs to know the location of the HEC-RAS executable. If an error appears stating the executable cannot be found, go to ''Edit'' | '''Preferences''' to open the ''Preferences'' dialog. In the [[SMS:Preferences#File_Locations|''File Locations'']] tab, set the ''HECRAS Translate'' item to point to the "_runRunGeneric.bat" file in the RAS2D_tranlator.
-->


If installing HEC-RAS to an existing version of SMS 12.2 or later, the XML file must be placed in the DynamicXml directory inside the SMS program directory. HEC-RAS also requires a translator. The RAS2D_translator folder should be placed in the Models directory inside the SMS program directory.
Currently, HEC-RAS will encounter a memory error when exporting a mesh that contains more than 500,000 elements.


SMS needs to know the location of the HEC-RAS executable. If an error appears stating the executable cannot be found, go to ''Edit'' | '''Preferences''' to open the ''Preferences'' dialog. In the ''File Locations'' tab, set the ''HECRAS Translate'' item to point to the "_runRunGeneric.bat" file in the RAS2D_tranlator.
HEC-RAS does not support voids in a mesh. Be certain to review the mesh for voids, holes, flat elements, and other irregularities before exporting.


==Related Topics==
==Related Topics==
Line 68: Line 98:


[[Category:HEC-RAS]]
[[Category:HEC-RAS]]
[[Category:SMS Menus|HEC-RAS]]
[[Category:External Links]]
[[Category:SMS 1D River]]

Latest revision as of 18:55, 20 August 2020

The Hydrologic Engineering Center's River Analysis System (HEC-RAS) is a one- and two-dimensional model for computing water surface profiles for steady state or gradually varied flow. HEC-RAS supports networks of channels and is capable of modeling subcritical, supercritical, and mixed flow regime profiles. HEC-RAS is able to model obstructions in the flow path. Two dimensional capabilities were added to HEC-RAS 5.0 in 2016.

Historically, SMS and WMS have supported tools for creating and editing cross sections and attributes for these cross sections for one dimensional HEC-RAS 1D. These cross sections can be imported from the HEC-RAS system in the form of an SDF file (exported by HEC-Ras) and saved as a HEC-GeoRAS file for inclusion into a HEC-RAS project. The WMS package has also developed floodplain mapping tools to generate floodplains from HEC-RAS results.

With the 2D version of HEC-RAS, a new SMS interface to HEC-RAS has been added (starting with SMS 12.2). This new interface is a simulation-based interface that allows defining multiple simulations with individual settings in a single SMS project. All of the mesh generating options supported in the SMS may be used to generate/edit a grid for use in HEC-RAS 2D.

SMS continues to include tools for defining river networks and cross-sections.

The HEC-RAS model can be added to a paid edition of SMS.

HEC-RAS Simulation

Example of a HEC-RAS simulation in the Project Explorer

Starting in SMS 12.2, HEC-RAS uses a simulation process. SMS can run multiple HEC-RAS simulations using the same components. To create a new simulation, right-click in the Project Explorer and select New Simulation | HEC-RAS. Components can then be linked to simulations by dragging the components under the simulation or by right-clicking on the component item and using the Link To submenu.

Components for the HEC-RAS simulation include the following:

  • 2D Mesh

HEC-RAS Simulation Menu

Right-clicking on a HEC-RAS simulation provides a menu with the standard simulation menu commands and the following commands specific to HEC-RAS:

  • Model Check – Launches the model checker to look for problems with the simulation setup.
  • Export HEC-RAS – Exports the mesh geometry so it can be imported into HEC-RAS.

HEC-RAS Files

A HEC-RAS simulation in SMS will generate a number of files for use in the HEC-RAS program. The following files are generated:

  • *.g01 – HEC-RAS geometry file.
  • *.g01.hdf
  • *.prj – The HEC-RAS projection file. For post-processsing, open this file in the HEC-RAS software.
  • *_projection.prj – The projection/coordinate system used by the project in SMS.

HEC-RAS 1D

HEC-RAS Material Properties dialog
HEC-RAS Model Control dialog

SMS can export a HEC-RAS 1D model. This requires the following be available:

  • 1D Hyd Centerline coverage with a defined centerline arc.
  • 1D Hyd Cross Sections coverage with defined cross section arcs.

Materials can be defined on the 1D Hyd Cross Section coverage. However, if this is not done, the following is needed:

  • An Area Properties coverage with polygon defining material areas.
  • Materials assigned in the Material dialog.

Once all of the necessary components are available, the 1D HEC-RAS project can be exported through the 1D Module.

HEC-RAS Menu

The HEC-RAS menu is available when the 1D Module is the active module. The menu contains the following commands:

  • Export HEC-RAS Project File – Brings up a save window to export the HEC-RAS 1D project file. This file can then be opened in HEC-RAS or in WMS.
  • Material Properties – Opens the HEC-RAS Material Properties dialog. In this dialog, a list of all materials defined in the Materials dialog will appear. Roughness can be assigned to each material. Also, the property type that is being used for the material values must be specified in the HEC-RAS Model Control dialog.
  • Model Control – Opens the HEC-RAS Model Control dialog. This dialog allows applying roughness to a cross section databases. A list of available cross section databases will be on the left. On the right, select if roughness will or will not be applied to a database.

HEC-RAS Troubleshooting

Starting in SMS 12.2, HEC-RAS uses the dynamic model interface. If HEC-RAS was purchased through Aquaveo, the DMI file and HEC-RAS library was included in the installation and should be available for use when starting SMS.

Currently, HEC-RAS will encounter a memory error when exporting a mesh that contains more than 500,000 elements.

HEC-RAS does not support voids in a mesh. Be certain to review the mesh for voids, holes, flat elements, and other irregularities before exporting.

Related Topics

External Links