SMS:WAM Grid Options: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(52 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Hide in print|{{WAM Menubox}}
The ''Grid Options'' dialog is accessed by right-clicking on the grid entry in the Project Explorer and selecting '''Options'''. The ''Grid Options'' dialog contains the following three tabs:
}}
The Grid Options dialog contains three tabs which are as follows:


==General Tab==
==General Tab==
[[Image:WAM MC general.png|thumb|400 px|WAM ''Grid Options'' dialog showing the ''General'']]
The ''General'' tab allows setting parameters for the WAM model run.
===Model options===
===Model options===
*Water depth model &ndash; Choosing a shallow depth model specifies the use of the full dispersion equation. Dispersion equation is <math>w^2 = g k \tanh(k h)</math> where <math>w</math> is radial frequency, <math>g</math> is acceleration due to gravity, <math>k</math> is the wave number, and <math>h</math> is the water depth. Computes all phase and group celerity where there is depth dependence.
*''Water depth model'' &ndash; Choosing a shallow depth model specifies the use of the full dispersion equation. Dispersion equation is <math>w^2 = g k \tanh(k h)</math> where ''w'' is radial frequency, ''g'' is acceleration due to gravity, ''k'' is the wave number, and ''h'' is the water depth. Computes all phase and group celerity where there is depth dependence.
*Refraction model &ndash; If running in deep water, specify "Not used." It is not recommend to use if grid resolution is greater than 3-min (0.05 deg) on a spherical grid.
*''Refraction model'' &ndash; If running in deep water, specify "Not used." It is not recommend to use if grid resolution is greater than 3-min (0.05 deg) on a spherical grid.
*Breaking &ndash; It is recommended that breaking be used when the water depth model is "Shallow." This will implement limited breaking within the WAM model.
*''Breaking'' &ndash; It is recommended that breaking be used when the water depth model is "Shallow." This will implement limited breaking within the WAM model.
[[Category:Equations|WAM Grid]]
*''Test level'' &ndash; A control for output diagnostics and is mostly used for model debugging. The WAM model includes the capability to simulate refraction of waves caused by interaction with the ocean bottom and interaction with currents. WAM can also simulate wave breaking and create a restart file to continue analysis at a future time. The default value is "0.0", which is the minimal diagnostic output level.
*''Create restart file'' &ndash; Causes WAM to create a restart file to continue analysis at a future time.


===Model time steps===
===Model time steps===
*Propagation time step &ndash; The propagation time step is controlled by the CFL condition. The CFL condition requires that the numerical solution cannot move faster than the group speed of the waves. It is recommended that the other model time steps and output time steps be multiples of the propagation time step.
*''Propagation'' &ndash; The ''Propagation'' time step is controlled by the Courant–Friedrichs–Lewy (CFL) condition. The CFL condition requires that the numerical solution cannot move faster than the group speed of the waves. It is recommended that the other model time steps and output time steps be multiples of the propagation time step.
*The CFL criteria must be less than 1.0 for WAM to run successfully. The estimated CFL value is shown below the time step. The value shows in green if the settings meet the criteria or red if not. The CFL computation is dependent upon whether deep or shallow water depth model is being used as well as the refraction model. Currently the CFL estimation in SMS does not account for currents but this is used within WAM. Therefore, the CFL estimate may look okay in SMS but fail when running WAM. If this occurs further reduce the propogation time step or change some of the other options.
*''Max CFL'' &ndash; The CFL criteria must be less than 1.0 for WAM to run successfully. The estimated CFL value is shown below the time step. SMS computes the maximum CFL value based on the propagation time step, cell size, refraction model, and the water depth model. The value shows in green if the settings meet the criteria, or in red if they do not. Currently, the CFL estimation in SMS does not account for currents, but this is used within WAM. Therefore, the CFL estimate may show green in SMS but fail when running WAM. If this occurs, further reduce the propagation time step or change some of the other options before rerunning WAM.  All of the parameters are interconnected.
*Source time step &ndash; This is the time step for the source term integration time step. Increasing this value can greatly decrease run times. However, it should be used with caution. It is recommended that the source term time step be no greater than 10 times the propagation time step.
*''Source'' &ndash; This is the time step for the source term integration time step. Increasing this value can greatly decrease run times. However, it should be used with caution. It is recommended that the source term time step be no greater than 10 times the propagation time step. WAM interpolates between these intervals to attain a smaller forcing time step.
 
*''Output wind'' &ndash; This time step controls how frequently the WAM simulation updates the forcing terms. WAM interpolates between these intervals to attain a smaller forcing time step.
===Output time steps===
*Spatial datasets &ndash; This is the frequency of output that will be generated that can be loaded into SMS as datasets. The WAM file it creates is the "integrated parameter map file."
*Spectra &ndash; This is the frequency of output for spectra data at defined observation cells.
*Close/Reopen &ndash; When writing files on a computer, often data being written is stored temporarily in RAM before being written to disk. If a file is in this state and WAM crashes, the final data may not be complete. Closing and reopening the output files forces the file system to complete writing the data to file.


===Output Time Steps===
*''Spatial Datasets'' &ndash; This is the frequency of output that will be generated that can be loaded into SMS as datasets. The WAM file it creates is the "integrated parameter map file."
*''Spectra'' &ndash; This is the frequency of output for spectra data at defined observation cells.
*''Close/Reopen files'' &ndash; When writing files on a computer, often data being written is stored temporarily in RAM before being written to disk. If a file is in this state and WAM crashes, the final data may not be complete. Closing and reopening the output files forces the file system to complete writing the data to file.


==Output Tab==
==Output Tab==
The Output tab consists of different Model options.
[[Image:WAM MC Output.png|thumb|400 px|WAM ''Grid Options'' dialog showing the ''Output'' tab]]
The ''Output'' tab consists of different Model options. Selecting each option will determine the dataset generated in the solution. Options include:
{|
|-
|valign="top"|
*Wind speed at 10m
*Wind direction
*Friction velocity
*Drag coefficient
*Significant wave height
*Wave peak period
*Wave mean period
*Wave TM1 period
*Wave TM2 period
|valign="top"|
*Wave direction
*Directional spread
*Normalized wave stress
*Sea significant wave height
*Sea peak period
*Sea mean period
*Sea TM1 period
*Sea TM2 period
*Sea direction
|
*Swell significant wave height
*Swell peak period
*Swell mean period
*Swell TM1 period
*Swell TM2 period
*Swell direction
*Swell directional spread
*Spectra of total sea
*Sea spectra
*Swell spectra
|}
Sea waves and swell waves are defined as:
*Sea waves: waves generated by the wind blowing at the time, and in the recent past, in the area of observation.
*Sea waves: waves generated by the wind blowing at the time, and in the recent past, in the area of observation.
*Swell waves: waves which have travelled into the area of observation after having been generated by previous winds in other areas. These waves may travel thousands of kilometres from their origin before dying away. There may be swell present even if the wind is calm and there are no 'sea' waves.
*Swell waves: waves which have traveled into the area of observation after having been generated by previous winds in other areas. These waves may travel thousands of kilometers from their origin before dying away. There may be swell present even if the wind is calm and there are no 'sea' waves.
 


==Spatial Inputs Tab==
==Spatial Inputs Tab==
WAM uses spatial input for ice cover, currents, and wind. The Spatial Inputs section of the WAM Model Control is used to manage these datasets.
[[Image:WAM MC Spatial Inputs.png|thumb|400 px|WAM ''Grid Options'' dialog showing the ''Spatial Inputs'' tab]]
WAM uses spatial input for ice cover, currents, and wind. The ''Spatial Inputs'' section of the ''WAM Model Control'' is used to manage these datasets.


===Ice Cover===
===Ice Cover===
====Dataset====
The ice cover dataset is an editable scalar dataset.  
The ice cover dataset is an editable scalar dataset. After creating the dataset using the ''Editable Datasets'' dialog accessed from the Model Control, the dataset will be displayed in the project explorer in a folder named ''Editable Datasets''. Only one ice cover dataset may exist at a time.
*"Dataset" &ndash; After creating the dataset using the ''Editable Datasets'' dialog accessed from the ''Model Control'', the dataset will be displayed in the project explorer in a folder named ''Editable Datasets''. Only one ice cover dataset may exist at a time.
 
*"File" &ndash; Rather than using a dataset, specify the file name for ice.
====File====
Rather than using a dataset you can specify the file name for ice.


===Currents===
===Currents===
====Dataset====
The currents dataset is specified to be any vector dataset on the current grid.
The currents dataset is specified to be any vector dataset on the current grid. The dataset and time step must both be selected. The selection may be removed by clicking on the Clear button. This unselects the dataset as the specified currents dataset, but it does not remove the dataset from the SMS project.
*"Dataset" &ndash; The dataset and time step must both be selected. The selection may be removed by clicking on the '''Clear''' button. This deselects the dataset as the specified currents dataset, but it does not remove the dataset from the SMS project.
 
*"File" &ndash; Rather than using a dataset, specify the file name for currents.
====File====
Rather than using a dataset you can specify the file name for currents.


===Wind===
===Wind===
====Dataset====
The winds dataset can be set to any vector dataset that belongs to the current grid or another grid whose angle is zero and whose extents cover the current grid.
The winds dataset can be set to any vector dataset that belongs to the current grid or another grid whose angle is zero and whose extents cover the current grid. Nested grids may use the wind dataset of the parent grid. The time steps in the dataset used must match those used with the WAM simulation.
*"Dataset" &ndash; Nested grids may use the wind dataset of the parent grid. The time steps in the dataset used must match those used with the WAM simulation.
*"File" &ndash; PBL can be used to create an input wind file for WAM by selecting "WAM input" in the ''PBL Model Control''. The fort.12 file created by PBL may be selected as the wind data. Note: This option is only useful if there is access to the "Planetary Boundary Layer" model which isn't available through SMS.


====File====
==Related Topics==
PBL can be used to create an input wind file for WAM by selecting "WAM input" in the PBL Model Control. The fort.12 file created by PBL may be selected as the wind data. Note: This option is only useful if you have access to the "Planetary Boundary Layer" model which isn't available through SMS.
*[[SMS:WAM|WAM]]




{{Template:Navbox SMS}}
{{Template:Navbox SMS}}
[[Category:WAM Dialogs|grid]]
[[Category:WAM|Grid]]

Latest revision as of 23:17, 22 May 2020

The Grid Options dialog is accessed by right-clicking on the grid entry in the Project Explorer and selecting Options. The Grid Options dialog contains the following three tabs:

General Tab

WAM Grid Options dialog showing the General

The General tab allows setting parameters for the WAM model run.

Model options

  • Water depth model – Choosing a shallow depth model specifies the use of the full dispersion equation. Dispersion equation is where w is radial frequency, g is acceleration due to gravity, k is the wave number, and h is the water depth. Computes all phase and group celerity where there is depth dependence.
  • Refraction model – If running in deep water, specify "Not used." It is not recommend to use if grid resolution is greater than 3-min (0.05 deg) on a spherical grid.
  • Breaking – It is recommended that breaking be used when the water depth model is "Shallow." This will implement limited breaking within the WAM model.
  • Test level – A control for output diagnostics and is mostly used for model debugging. The WAM model includes the capability to simulate refraction of waves caused by interaction with the ocean bottom and interaction with currents. WAM can also simulate wave breaking and create a restart file to continue analysis at a future time. The default value is "0.0", which is the minimal diagnostic output level.
  • Create restart file – Causes WAM to create a restart file to continue analysis at a future time.

Model time steps

  • Propagation – The Propagation time step is controlled by the Courant–Friedrichs–Lewy (CFL) condition. The CFL condition requires that the numerical solution cannot move faster than the group speed of the waves. It is recommended that the other model time steps and output time steps be multiples of the propagation time step.
  • Max CFL – The CFL criteria must be less than 1.0 for WAM to run successfully. The estimated CFL value is shown below the time step. SMS computes the maximum CFL value based on the propagation time step, cell size, refraction model, and the water depth model. The value shows in green if the settings meet the criteria, or in red if they do not. Currently, the CFL estimation in SMS does not account for currents, but this is used within WAM. Therefore, the CFL estimate may show green in SMS but fail when running WAM. If this occurs, further reduce the propagation time step or change some of the other options before rerunning WAM. All of the parameters are interconnected.
  • Source – This is the time step for the source term integration time step. Increasing this value can greatly decrease run times. However, it should be used with caution. It is recommended that the source term time step be no greater than 10 times the propagation time step. WAM interpolates between these intervals to attain a smaller forcing time step.
  • Output wind – This time step controls how frequently the WAM simulation updates the forcing terms. WAM interpolates between these intervals to attain a smaller forcing time step.

Output Time Steps

  • Spatial Datasets – This is the frequency of output that will be generated that can be loaded into SMS as datasets. The WAM file it creates is the "integrated parameter map file."
  • Spectra – This is the frequency of output for spectra data at defined observation cells.
  • Close/Reopen files – When writing files on a computer, often data being written is stored temporarily in RAM before being written to disk. If a file is in this state and WAM crashes, the final data may not be complete. Closing and reopening the output files forces the file system to complete writing the data to file.

Output Tab

WAM Grid Options dialog showing the Output tab

The Output tab consists of different Model options. Selecting each option will determine the dataset generated in the solution. Options include:

  • Wind speed at 10m
  • Wind direction
  • Friction velocity
  • Drag coefficient
  • Significant wave height
  • Wave peak period
  • Wave mean period
  • Wave TM1 period
  • Wave TM2 period
  • Wave direction
  • Directional spread
  • Normalized wave stress
  • Sea significant wave height
  • Sea peak period
  • Sea mean period
  • Sea TM1 period
  • Sea TM2 period
  • Sea direction
  • Swell significant wave height
  • Swell peak period
  • Swell mean period
  • Swell TM1 period
  • Swell TM2 period
  • Swell direction
  • Swell directional spread
  • Spectra of total sea
  • Sea spectra
  • Swell spectra

Sea waves and swell waves are defined as:

  • Sea waves: waves generated by the wind blowing at the time, and in the recent past, in the area of observation.
  • Swell waves: waves which have traveled into the area of observation after having been generated by previous winds in other areas. These waves may travel thousands of kilometers from their origin before dying away. There may be swell present even if the wind is calm and there are no 'sea' waves.

Spatial Inputs Tab

WAM Grid Options dialog showing the Spatial Inputs tab

WAM uses spatial input for ice cover, currents, and wind. The Spatial Inputs section of the WAM Model Control is used to manage these datasets.

Ice Cover

The ice cover dataset is an editable scalar dataset.

  • "Dataset" – After creating the dataset using the Editable Datasets dialog accessed from the Model Control, the dataset will be displayed in the project explorer in a folder named Editable Datasets. Only one ice cover dataset may exist at a time.
  • "File" – Rather than using a dataset, specify the file name for ice.

Currents

The currents dataset is specified to be any vector dataset on the current grid.

  • "Dataset" – The dataset and time step must both be selected. The selection may be removed by clicking on the Clear button. This deselects the dataset as the specified currents dataset, but it does not remove the dataset from the SMS project.
  • "File" – Rather than using a dataset, specify the file name for currents.

Wind

The winds dataset can be set to any vector dataset that belongs to the current grid or another grid whose angle is zero and whose extents cover the current grid.

  • "Dataset" – Nested grids may use the wind dataset of the parent grid. The time steps in the dataset used must match those used with the WAM simulation.
  • "File" – PBL can be used to create an input wind file for WAM by selecting "WAM input" in the PBL Model Control. The fort.12 file created by PBL may be selected as the wind data. Note: This option is only useful if there is access to the "Planetary Boundary Layer" model which isn't available through SMS.

Related Topics