SMS:STWAVE: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(37 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{SMS Infobox Model |
{{SMS Infobox Model |
|name=          STWAVE
|name=          STWAVE
|screenshot= File:STWAVE.PNG
|model_type=    Model for nearshore wind-wave growth and propagation.
|model_type=    Model for nearshore wind-wave growth and propagation.
|developer=    [http://chl.erdc.usace.army.mil/chl.aspx?p=s&a=Persons;170 Jane Smith]
|developer=    [http://chl.erdc.usace.army.mil/chl.aspx?p=s&a=Persons;170 Jane Smith]
|web_site=      [http://chl.erdc.usace.army.mil/chl.aspx?p=s&a=SOFTWARE;9 STWAVE web site]
|web_site=      [http://www.erdc.usace.army.mil/Media/Fact-Sheets/Fact-Sheet-Article-View/Article/476716/steady-state-spectral-wave/ STWAVE web site]
|tutorials=     
|tutorials=     
General Section
General Section
Line 11: Line 12:
* STWAVE
* STWAVE
Several sets of sample problems and case studies are available. These include:  
Several sets of sample problems and case studies are available. These include:  
* Model Validataion cases from the STWAVE [http://chl.erdc.usace.army.mil/chl.aspx?p=s&a=SOFTWARE;9 website]
* Model Validation cases from the STWAVE [http://chl.erdc.usace.army.mil/chl.aspx?p=s&a=SOFTWARE;9 website]
}}
}}




STWAVE is a steady-state, finite difference, spectral model based on the wave action balance equation. STWAVE is written by the U.S. Army Corps of Engineers Waterways Experiment Station (USACE-WES).
STWAVE (STeady State Spectral WAVE) is a steady-state, finite difference, spectral model based on the wave action balance equation. STWAVE is written by the U.S. Army Corps of Engineers Waterways Experiment Station (USACE-WES).
 
The STWAVE model can be added to a [http://www.aquaveo.com/software/sms-pricing paid edition] of SMS.
[[Category:Link to Store]]


== Functionality ==
== Functionality ==
Line 21: Line 25:


The new full-plane version of STWAVE is not a replacement for the half-plane version, but a supplement. The half-plane version will always have an advantage of substantially lower memory requirements (~ two orders of magnitude) and faster execution. The half-plane limitation is generally appropriate for nearshore coastal applications, with the exception of enclosed or semi-enclosed bays, estuaries, and lakes where seas and swells may oppose each other or there is no clear “offshore” direction. The full-plane version allows wave input on all boundaries and wave generation from all directions.
The new full-plane version of STWAVE is not a replacement for the half-plane version, but a supplement. The half-plane version will always have an advantage of substantially lower memory requirements (~ two orders of magnitude) and faster execution. The half-plane limitation is generally appropriate for nearshore coastal applications, with the exception of enclosed or semi-enclosed bays, estuaries, and lakes where seas and swells may oppose each other or there is no clear “offshore” direction. The full-plane version allows wave input on all boundaries and wave generation from all directions.
===Saving STWAVE===
When completing the ''File'' | '''Save As...''' command, the following files get saved in the *.sms
* *.mat referenced to new save location
* stw_grds.h5 referenced to new save location
* spec_grds.h5 referenced to new save location
* *.grd referenced to new save location
* *.ctl referenced to new save location
* *.sol referenced to a folder in the new save location


== Using the Model / Practical Notes ==
== Using the Model / Practical Notes ==
* A grid for use with STWAVE is created and edited in [[SMS:SMS|SMS]] using the Map Module.
* A grid for use with STWAVE is created and edited in [[SMS:SMS|SMS]] using the Map module.
* The modeling parameters required by STWAVE are generated and applied to the mesh using commands grouped in the STWAVE menu.
* The modeling parameters required by STWAVE are generated in the Map module using STWAVE coverge which are then applied to the STWAVE simulation.
* Post processing of solution data generated by STWAVE is done using the generic visualization tools of SMS.
* Post processing of solution data generated by STWAVE is done using the generic visualization tools of SMS.
* Wind can be entered in the STWAVE model control as either a constant value or by specifying an existing Cartesian Grid data set.
* Wind can be entered in the STWAVE model control as either a constant value or by specifying an existing Cartesian Grid dataset.
* STWAVE requires metric units. All data in SMS needs to be in metric units before running STWAVE.
* STWAVE requires metric units. All data in SMS needs to be in metric units before running STWAVE.
* Water depths are defined as positive numbers and land elevations are negative numbers.
* Water depths are defined as negative numbers and land elevations are positive numbers.
* When running a simulation with wind only, the spectral data must be 0.


== Graphical Interface ==
== Graphical Interface ==
The [[SMS:STWAVE Graphical Interface|STWAVE Graphical Interface]] contains tools to create and edit a STWAVE simulation. The simulation consists of a geometric definition of the model domain (the grid) and a set of numerical parameters. The parameters define the boundary conditions and options pertinent to the model.
The [[SMS:STWAVE Graphical Interface|STWAVE graphical interface]] contains tools to create and edit a STWAVE simulation. The simulation consists of separate components that include a Cartesian grid, map coverages, and a STWAVE simulation component. The interface is accessed by creating an STWAVE simulation in the Project Explorer.  See [[SMS:STWAVE Graphical Interface|STWAVE Graphical Interface]] for more information.
 
==STWAVE Files==
 
Here are tables of some of the available input and output files for STWAVE
 
* For more information on these files see page 16 of the [https://ewn.erdc.dren.mil/wp-content/uploads/2021/08/STWAVE_manual.pdf#page=23 manual].
 
{| class="wikitable"
|+'''SMS Input Files'''
!width="40" align="center"|Name
!width="250" align="center"|Description
|-
|GRD||Grid File
|-
|H5||Spectral Grid HDF5 Wave File
|-
|H5||STWAVE Grid HDF5 Depth File
|-
|H5||Scatter HDF5 Velocity File
|-
|DIS||Discretization File
|-
|MAP||Boundary Map File
|-
|SMS||SMS Project File
|-
|}


The interface is accessed by selecting the [[SMS:Cartesian Grid Module|Cartesian Grid Module]] and setting the current model to STWAVE.  If a grid has already been created for a STWAVE simulation or an existing simulation read, the grid object will exist in the [[SMS:Project Explorer|Project Explorer]] and selecting that object will make the Cartesian grid module active and set the model to STWAVE. See [[SMS:Cartesian Grid Module#Creating 2D Grids|Creating 2D Cartesian Grids]] for more information.
{| class="wikitable"
|+'''SMS Generated STWAVE Input Files'''
!width="40" align="center"|Name
!width="250" align="center"|Description
|-
|DEP||Cell Depth File
|-
|ENG||Spectral Dataset Energy File
|-
|}


The interface consists of the [[SMS:Cartesian_Grid_Module_Menus|Cartesian grid menus]] and [[SMS:Cartesian Grid Tools|tools]] augmented by the [[SMS:STWAVE Menu|STWAVE Menu]]. See [[SMS:STWAVE Graphical Interface|STWAVE Graphical Interface]] for more information.
{| class="wikitable"
|+'''STWAVE Output Files'''
!width="40" align="center"|Name
!width="250" align="center"|Description
|-
|912||File
|-
|CMPCT||Full-Plane Mode Compact Output File
|-
|Log.OUT||Log Output File
|-
|Nest.OUT||Nesting Application Energy Spectra Grid File
|-
|Obse.OUT||Observation Output File
|-
|Spatial.OUT||Spatial Output HDF5 File
|-
|Selh.OUT||Local Paramater Summary Spatial Dataset
|-
|SIM||Simulation File
|-
|TP.OUT||Peak Wave Period File
|-
|Wave.OUT||Wave Height, Period, Direction File
|-
|}


== External Links ==
== External Links ==
* Aug 2007  ERDC/CHL CHETN-I-76  Modeling Nearshore Waves for Hurricane Katrina [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-i-76.pdf]
* [https://ewn.erdc.dren.mil/wp-content/uploads/2021/08/STWAVE_manual.pdf STWAVE 6.0 User's Manual] Sep 2011
* Aug 2007  ERDC/CHL CHETN-I-75  Full-Plane STWAVE with Bottom Friction: II. Model Overview [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-i-75.pdf]
* Aug 2007  ERDC/CHL CHETN-I-76  Modeling Nearshore Waves for Hurricane Katrina [https://apps.dtic.mil/sti/pdfs/ADA471589.pdf]
* Aug 2007  ERDC/CHL CHETN-I-75  Full-Plane STWAVE with Bottom Friction: II. Model Overview [https://apps.dtic.mil/sti/pdfs/ADA471582.pdf]
* Sep 2006  9th International Workshop On Wave Hindcasting and Forecasting  Jane McKee Smith    Modeling Nearshore Waves For Hurricane Katrina [http://www.waveworkshop.org/9thWaves/Papers/Smith.pdf]
* Sep 2006  9th International Workshop On Wave Hindcasting and Forecasting  Jane McKee Smith    Modeling Nearshore Waves For Hurricane Katrina [http://www.waveworkshop.org/9thWaves/Papers/Smith.pdf]
* Mar 2006  ERDC/CHL CHETN-I-71  Full Plane STWAVE: SMS Graphical Interface [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-i-71.pdf]
* Mar 2006  ERDC/CHL CHETN-I-71  Full Plane STWAVE: SMS Graphical Interface [https://erdc-library.erdc.dren.mil/jspui/bitstream/11681/1893/1/CHETN-I-71.pdf]
* Dec 2003  ERDC/CHL CHETN-IV-60 SMS Steering Module for Coupling Waves and Currents, 2: M2D (now know as CMS-Flow)  and STWAVE [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-60.pdf]
* Dec 2003  ERDC/CHL CHETN-IV-60 SMS Steering Module for Coupling Waves and Currents, 2: M2D (now know as CMS-Flow)  and STWAVE [https://www.researchgate.net/publication/228410242_SMS_Steering_Module_for_Coupling_Waves_and_Currents_M2D_and_STWAVE]
* Jun 2002  ERDC/CHL CHETN-I-66  Grid Nesting with STWAVE [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-i-66.pdf]
* Jun 2002  ERDC/CHL CHETN-I-66  Grid Nesting with STWAVE [https://apps.dtic.mil/sti/pdfs/ADA459646.pdf]
* Jun 2002 ERDC/CHL CHETN-IV-41 SMS Steering Module for Coupling Waves and Currents, 1: ADCIRC and STWAVE [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-41.pdf]
* Jun 2002 ERDC/CHL CHETN-IV-41 SMS Steering Module for Coupling Waves and Currents, 1: ADCIRC and STWAVE [https://erdc-library.erdc.dren.mil/jspui/bitstream/11681/1947/1/CHETN-IV-41.pdf]
** Please see [http://aquaveo.invisionzone.com/index.php?showtopic=23 this forum post] for an explanation of ADCIRC and STWAVE steering
* Sep 2001  ERDC/CHL CHETN-I-64  Modeling Nearshor Wave Transformation with STWAVE [https://apps.dtic.mil/sti/pdfs/ADA588527.pdf]
* Sep 2001  ERDC/CHL CHETN-I-64  Modeling Nearshor Wave Transformation with STWAVE [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-i-66.pdf]




Line 52: Line 128:
{{Template:Navbox SMS}}
{{Template:Navbox SMS}}


[[Category:SMS Cartesian Grid]]
[[Category:STWAVE]]
[[Category:STWAVE]]
[[Category:Wave Modeling|S]]
[[Category:External Links]]

Latest revision as of 22:41, 24 April 2023

STWAVE
STWAVE
STWAVE Screenshot
Model Info
Model type Model for nearshore wind-wave growth and propagation.
Developer Jane Smith
Web site STWAVE web site
Tutorials

General Section

  • Data Visualization
  • Observation

Models Section

  • STWAVE

Several sets of sample problems and case studies are available. These include:

  • Model Validation cases from the STWAVE website


STWAVE (STeady State Spectral WAVE) is a steady-state, finite difference, spectral model based on the wave action balance equation. STWAVE is written by the U.S. Army Corps of Engineers Waterways Experiment Station (USACE-WES).

The STWAVE model can be added to a paid edition of SMS.

Functionality

STWAVE simulates depth-induced wave refraction and shoaling, current-induced refraction and shoaling, depth- and steepness-induced wave breaking, diffraction, wave growth because of wind input, and wave-wave interaction and white capping that redistribute and dissipate energy in a growing wave field. The purpose of STWAVE is to provide an easy-to-apply, flexible, and robust model for nearshore wind-wave growth and propagation. Recent upgrades to the model include wind, surge and friction fields (spatially varied). Also, wind and surge fields can be temporally varied. The method of analysis used by the STWAVE code along with the file formats and input parameters are described in the STWAVE documentation. SMS supports both pre- and post-processing for STWAVE.

The new full-plane version of STWAVE is not a replacement for the half-plane version, but a supplement. The half-plane version will always have an advantage of substantially lower memory requirements (~ two orders of magnitude) and faster execution. The half-plane limitation is generally appropriate for nearshore coastal applications, with the exception of enclosed or semi-enclosed bays, estuaries, and lakes where seas and swells may oppose each other or there is no clear “offshore” direction. The full-plane version allows wave input on all boundaries and wave generation from all directions.

Saving STWAVE

When completing the File | Save As... command, the following files get saved in the *.sms

  • *.mat referenced to new save location
  • stw_grds.h5 referenced to new save location
  • spec_grds.h5 referenced to new save location
  • *.grd referenced to new save location
  • *.ctl referenced to new save location
  • *.sol referenced to a folder in the new save location

Using the Model / Practical Notes

  • A grid for use with STWAVE is created and edited in SMS using the Map module.
  • The modeling parameters required by STWAVE are generated in the Map module using STWAVE coverge which are then applied to the STWAVE simulation.
  • Post processing of solution data generated by STWAVE is done using the generic visualization tools of SMS.
  • Wind can be entered in the STWAVE model control as either a constant value or by specifying an existing Cartesian Grid dataset.
  • STWAVE requires metric units. All data in SMS needs to be in metric units before running STWAVE.
  • Water depths are defined as negative numbers and land elevations are positive numbers.
  • When running a simulation with wind only, the spectral data must be 0.

Graphical Interface

The STWAVE graphical interface contains tools to create and edit a STWAVE simulation. The simulation consists of separate components that include a Cartesian grid, map coverages, and a STWAVE simulation component. The interface is accessed by creating an STWAVE simulation in the Project Explorer. See STWAVE Graphical Interface for more information.

STWAVE Files

Here are tables of some of the available input and output files for STWAVE

  • For more information on these files see page 16 of the manual.
SMS Input Files
Name Description
GRD Grid File
H5 Spectral Grid HDF5 Wave File
H5 STWAVE Grid HDF5 Depth File
H5 Scatter HDF5 Velocity File
DIS Discretization File
MAP Boundary Map File
SMS SMS Project File
SMS Generated STWAVE Input Files
Name Description
DEP Cell Depth File
ENG Spectral Dataset Energy File
STWAVE Output Files
Name Description
912 File
CMPCT Full-Plane Mode Compact Output File
Log.OUT Log Output File
Nest.OUT Nesting Application Energy Spectra Grid File
Obse.OUT Observation Output File
Spatial.OUT Spatial Output HDF5 File
Selh.OUT Local Paramater Summary Spatial Dataset
SIM Simulation File
TP.OUT Peak Wave Period File
Wave.OUT Wave Height, Period, Direction File

External Links

  • STWAVE 6.0 User's Manual Sep 2011
  • Aug 2007 ERDC/CHL CHETN-I-76 Modeling Nearshore Waves for Hurricane Katrina [1]
  • Aug 2007 ERDC/CHL CHETN-I-75 Full-Plane STWAVE with Bottom Friction: II. Model Overview [2]
  • Sep 2006 9th International Workshop On Wave Hindcasting and Forecasting Jane McKee Smith Modeling Nearshore Waves For Hurricane Katrina [3]
  • Mar 2006 ERDC/CHL CHETN-I-71 Full Plane STWAVE: SMS Graphical Interface [4]
  • Dec 2003 ERDC/CHL CHETN-IV-60 SMS Steering Module for Coupling Waves and Currents, 2: M2D (now know as CMS-Flow) and STWAVE [5]
  • Jun 2002 ERDC/CHL CHETN-I-66 Grid Nesting with STWAVE [6]
  • Jun 2002 ERDC/CHL CHETN-IV-41 SMS Steering Module for Coupling Waves and Currents, 1: ADCIRC and STWAVE [7]
  • Sep 2001 ERDC/CHL CHETN-I-64 Modeling Nearshor Wave Transformation with STWAVE [8]