SMS:Generate/Edit Spectra: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
Line 17: Line 17:
The following are used by SpecGen to generate the spectra.
The following are used by SpecGen to generate the spectra.


* '''Index/Time (hrs)''' – Run identifier. If  the ''Generate as Time Steps'' option is on above it will be  labeled as Time (hrs), otherwise it will be labeled as  Index. This can be a text string or time stamp. The  value is written to the files to identify the spectrum, but is not used  otherwise.
* '''Time (hrs)''' – Time offset using the specified units for the spectral node.
* '''Angle (deg)''' – Approach angle relative to  the shore normal in the clockwise direction measured in degrees (wvang = 25.0).
* '''Angle (deg)''' – Approach angle relative to  the shore normal in the clockwise direction measured in degrees (wvang = 25.0).
* '''Hs (m)'''  – The incident zero moment wave height (hm0 = 1.0).
* '''Hs (m)'''  – The incident zero moment wave height (hm0 = 1.0).

Revision as of 22:58, 9 January 2014

Generate Spectra dialog

This page describes both the Generate Spectra and Edit Spectra dialogs since they are almost the same dialog. The Generate Spectra dialog is accessed through the Spectral Energy dialog (by pushing the Generate Spectra button). The Edit Spectra dialog is accessed through the Spectral Energy dialog by right-clicking on a grid or spectra in the Spectral Manager and clicking Edit Spectra. SMS creates/edits the spectra when the Generate/Edit button is clicked. All units for the options are feet or meters, depending on the coordinate system. STWAVE runs in metric units, so if the current units are in English units inside SMS, all data is converted to metric when it is saved. The settings are shown below (default values are shown in parenthesis):

Parameter Settings

  • Generation Method – Choose the method you want to use to generate the spectra. Each method has slightly different options.
  • Replace Old Spectra – Delete all existing spectra in Spectral Energy dialog after the new spectra are generated. Not available when editing.
  • Directional Spreading Distribution – Choose to use either the wrapped normal distribution or the cosine power distribution. With the wrapped normal option, a standard deviation and maximum angle cutoff must be specified. With the cosine power option, the spreading index and the maximum cutoff angle must be specified. The recommended cutoff angle is three times the standard deviation of the directional distribution.
  • Gauge Depth – Water depth in meters (d = 5.0). Choose whether to specify once for all spectra or to specify for each spectrum.

Angle Settings

  • Coordinate System – The wave direction can either be specified in a shore normal/local coordinate system or a meteorologic/global coordinate system.

Spectral Parameters

The following are used by SpecGen to generate the spectra.

  • Time (hrs) – Time offset using the specified units for the spectral node.
  • Angle (deg) – Approach angle relative to the shore normal in the clockwise direction measured in degrees (wvang = 25.0).
  • Hs (m) – The incident zero moment wave height (hm0 = 1.0).
  • Tp (sec) – Wave period in seconds (tp = 20.0).
  • Gamma – Spectral peak dispersion factor (igamma = 3.3).
  • nn – Directional or peak dispersion factor, must be even integer (inn = 4).
  • Gauge Depth (m) – Water depth in meters (d = 5.0). This parameter is available if the Gauge Depth option above is set to Specify for each spectrum.

Spreadsheet Options

  • Import/Export – Import/export an ASCII, space delimited text file with the spectral generator parameters. The file format is:
SPECTRAL TABLE Values
Method Option Time Index Angle Hs(1) Tp(1) Gamma (1) Hs (1) Tp(1) Gamma(1) Hs(2) Tp(2) Gamma(2) Wind Fetch nn StdDev Depth Headers
0 -1 999.0 None 25.0 1.0 20.0 8.0 999.0 999.0 999.0 999.0 999.0 30.0 999.0 0.001 1st row of values
0 -1 999.0 None 30.0 1.0 16.0 8.0 999.0 999.0 999.0 999.0 999.0 30.0 999.0 0.001 2nd row of values

Additional format description is found in CMS-Wave Spectral Table File.

  • Import from GenCade – Imports wave parameters from the Filtered Ocean Conditions dialog. This button is only available if data has been filtered in GenCade.
  • Spectral Defaults – This opens a section of the dialog that lists the approximate spectral parameters. Double-click a row of values to replace the selected spreadsheet row(s). The period (T), gamma, and nn will be replaced for the row. If the period in the spreadsheet does not match a period in the table, the spreadsheet period is rounded to the nearest table period.


Return to Spectral Energy