rompy.swan.components.physics.SCAT#

pydantic model rompy.swan.components.physics.SCAT[source]#

Scattering.

SCAT [iqcm] (GRID [rfac]) (TRUNC [alpha] [qmax])

Using this optional command, the user activates a source term that allows for the generation and propagation of cross correlations between scattered waves due to variations in the bathymetry and mean currents. Such variations are rapid compared to the distancebetween the crossing waves (at the scale of 100-1000 m) and is particularly relevant for cases involving narrowband waves (swells) in coastal regions with shallow water and ambient currents. In turn, the immediate spatial effects of coherent scattering, interference, refraction and diffraction can cause large-scale changes in the wave parameters.

References

Smit, P.B. and Janssen, T.T., 2013. The evolution of inhomogeneous wave statistics through a variable medium. Journal of Physical Oceanography, 43(8), pp.1741-1758.

Smit, P.B., Janssen, T.T. and Herbers, T.H.C., 2015. Stochastic modeling of inhomogeneous ocean waves. Ocean Modelling, 96, pp.26-35.

Smit, P.B., Janssen, T.T. and Herbers, T.H.C., 2015. Stochastic modeling of coherent wave fields over variable depth. Journal of Physical Oceanography, 45(4), pp.1139-1154.

Akrish, G., Smit, P., Zijlema, M. and Reniers, A., 2020. Modelling statistical wave interferences over shear currents. Journal of Fluid Mechanics, 891, p.A2.

Notes

Implemented in SWAN 41.41.

If both alpha and qmax options are provided to truncate the infinite convolution sum their mimimum is considered as the final limit on the sum.

Examples:#

In [119]: from rompy.swan.components.physics import SCAT

In [120]: scat = SCAT()

In [121]: print(scat.render())
SCAT

In [122]: scat = SCAT(iqcm=2, rfac=1.0, alpha=1.0)

In [123]: print(scat.render())
SCAT iqcm=2 GRID rfac=1.0 TRUNC alpha=1.0
Fields:
Validators:
field alpha: float | None = None#

The coefficient by which the mean wave number is multiplied to set thelimit on the convolution sum (SWAN default: 1.0)

Validated by:
field iqcm: Literal[0, 1, 2] | None = None#

Indicates the modelling and computation of QC scattering:

  • 0: no scattering

  • 1: scattering due to non-uniform bathymetry and currents (the latter only if applicable; see command INPGRID CURRENT)

  • 2: wave-current interaction under the assumption of a slowly varying bathymetry

(SWAN default: 1)

Validated by:
field model_type: Literal['scat', 'SCAT'] = 'scat'#

Model type discriminator

Validated by:
field qmax: float | None = None#

The maximum scattering wave number (in 1/m)

Validated by:
field rfac: float | None = None#

The resolution factor through which the incident spectral width ismultiplied (SWAN default: 1.0)

Constraints:

  • ge = 1.0

Validated by:
cmd() → str[source]#

Command file string for this component.

validator warn_if_qmax_and_alpha  »  all fields[source]#
On this page
Show Source