SMS:Generate/Edit Spectra: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(32 intermediate revisions by 3 users not shown)
Line 1: Line 1:
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):
[[File:GenerateEditSpectra.png|thumb|400 px|''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 [[SMS:Spectral_Energy|''Spectral Energy'']] dialog (by pushing the '''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 ==
== Parameter Settings ==


* '''Generation Method''' – Choose the method you want to use to generate the spectra. Each method has slightly different options.
* ''Generation Method'' – Choose the method (TMA (Shallow Water), JONSWAP, Bretschneider (ITTC), Pierson-Moskowitz, or Ochi-Hubble Double Peak) to use to generate the spectra. Each method has slightly different options. JONSWAP and Pierson-Moskowitz both require additional information about what values to use to specify the spectra.  
* '''Replace Old Spectra''' – Delete all existing spectra in Spectral Energy  dialog after the new spectra are generated. Not available when editing.  
<!--* ''Replace Old Spectra'' &ndash; Delete all existing spectra in ''Spectral Energy'' dialog after the new spectra are generated. Not available when editing.-->
* '''Directional Spreading Distribution''' &ndash; 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.
* ''Directional Spreading Distribution'' &ndash; 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''' &ndash; Water depth in meters (d = 5.0). Choose whether to  specify once for all spectra or to specify for each spectrum.
* ''Seaward Boundary Depth'' &ndash; Water depth in meters (d = 5.0). Choose whether to  specify once for all spectra or to specify for each spectrum.


== Angle Settings ==
== Angle Settings ==


* '''Coordinate System''' &ndash; The wave direction can either be specified in a shore  normal/local coordinate system or a meteorologic/global coordinate system.
* ''Projection'' &ndash; The wave direction can be specified in a Oceanographic, Meteorologic, Shore Normal, or Cartesian coordinate system.


== Spectral Parameters ==
== Spectral Parameters ==
Line 16: 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)''' &ndash; 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)'' &ndash; Time offset using the specified units for the spectral node.
* '''Angle (deg)''' &ndash; Approach angle relative to  the shore normal in the clockwise direction measured in degrees (wvang = 25.0).
* ''Angle (deg)'' &ndash; Approach angle relative to  the shore normal in the clockwise direction measured in degrees (wvang = 25.0).
* '''Hs (m)'''  &ndash; The incident zero moment wave height (hm0 = 1.0).
* ''Hs (m)''  &ndash; The incident zero moment wave height (hm0 = 1.0).
* '''Tp (sec)''' &ndash; Wave period in seconds (tp = 20.0).
* ''Tp (sec)'' &ndash; Wave period in seconds (tp = 20.0).
* '''Gamma''' &ndash; Spectral peak dispersion factor (igamma = 3.3).
* ''Gamma'' &ndash; Spectral peak dispersion factor (igamma = 3.3).
* '''nn''' &ndash; Directional or peak dispersion factor, must be even  integer (inn = 4).  
* ''nn'' &ndash; Number of Nearest Neighbors to be calculated, Directional or peak dispersion factor, must be even  integer (inn = 4).  
* '''Gauge Depth (m)''' &ndash; Water depth  in meters (d = 5.0). This parameter is available if the Gauge Depth option above is set to  Specify for each spectrum.
* ''Gauge Depth (m)'' &ndash; 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 ==
== Spreadsheet Options ==


* '''Import/Export''' &ndash; Import/export an ASCII, space  delimited text file with the spectral generator parameters. The file format  is:
* '''Import/Export''' &ndash; Import/export an ASCII, space  delimited text file with the spectral generator parameters. The file format  is:
 
<blockquote>
 
{| cellspacing="0" cellpadding="3" border="1"
{| cellspacing="0" cellpadding="0" border="1"
| SPECTRAL TABLE
| SPECTRAL TABLE
| Values
| Values
Line 42: Line 42:
| >| 2nd row of values<br /><br />
| >| 2nd row of values<br /><br />
|}
|}
</blockquote>


Additional format description is found in [[SMS:CMS-Wave Spectral Table File|CMS-Wave Spectral Table File]].
Additional format description is found in [[SMS:CMS-Wave Spectral Table File|CMS-Wave Spectral Table File]].


* '''Import from Genesis''' &ndash; Imports wave parameters from the Filtered Ocean Conditions dialog. This button is only available if data has been filtered in Genesis.   
* '''Import from GenCade''' &ndash; Imports wave parameters from the ''Filtered Ocean Conditions'' dialog. This button is only available if data has been filtered in GenCade.   
 
*'''Delete All''' &ndash; Deletes everything within the ''Spectral Parameters'' table.
 
* '''Spectral Defaults''' &ndash; 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.


* '''Spectral Defaults''' &ndash; 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.
==Related Topics==
*[[SMS:Spectral Energy|Spectral Energy]]
*[[Direction Conventions and Conversions]]




{{Template:Navbox SMS}}


[[SMS:Spectral Energy|Return to Spectral Energy]]
[[Category:Spectral Energy|G]]
[[Category:SMS Spectral Dialogs]]

Latest revision as of 22:26, 10 June 2024

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 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 (TMA (Shallow Water), JONSWAP, Bretschneider (ITTC), Pierson-Moskowitz, or Ochi-Hubble Double Peak) to use to generate the spectra. Each method has slightly different options. JONSWAP and Pierson-Moskowitz both require additional information about what values to use to specify the spectra.
  • 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.
  • Seaward Boundary Depth – Water depth in meters (d = 5.0). Choose whether to specify once for all spectra or to specify for each spectrum.

Angle Settings

  • Projection – The wave direction can be specified in a Oceanographic, Meteorologic, Shore Normal, or Cartesian 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 – Number of Nearest Neighbors to be calculated, 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.
  • Delete All – Deletes everything within the Spectral Parameters table.
  • 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.

Related Topics