Model:SWAN

From CSDMS
Revision as of 20:18, 16 September 2020 by WikiSysop (talk | contribs) (Text replacement - "{{End headertab}}" to "{{End headertab}} {{{{PAGENAME}}_autokeywords}}")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


SWAN


Metadata

Also known as
Model type Modular
Model part of larger framework
Note on status model
Date note status model
Incorporated models or components:
Spatial dimensions 3D
Spatial extent Continental, Landscape-Scale, Regional-Scale
Model domain Coastal
One-line model description SWAN is a third-generation wave model
Extended model description SWAN is a third-generation wave model that computes random, short-crested wind-generated waves in coastal regions and inland waters.
Keywords:

wave dynamics,

Name Team SWAN
Type of contact Model developer
Institute / Organization Delft University of Technology, Faculty of Civil Engineering and Geosciences
Postal address 1 P.O. Box 5048
Postal address 2
Town / City Delft
Postal code 2600 GA
State
Country Netherlands
Email address swan-info-citg@tudelft.nl
Phone
Fax


Supported platforms
Unix, Linux, Windows
Other platform
Programming language

Fortran77

Other program language
Code optimized Multiple Processors
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development 1993
Does model development still take place? Yes
If above answer is no, provide end year model development
Code development status Active
When did you indicate the 'code development status'? 2020
Model availability As code
Source code availability
(Or provide future intension)
Through web repository
Source web address http://www.swan.tudelft.nl/
Source csdms web address
Program license type Other
Program license type other GNU General Public License
Memory requirements --
Typical run time --


Describe input parameters The bathymetry, current, water level, bottom friction and wind (if spatially variable) need to be provided to SWAN on so-called input grids. It is best to make an input grid so large that it completely covers the computational grid.
Input format Binary
Other input format
Describe output parameters SWAN can provide output on uniform, recti-linear spatial grids that are independent from the input grids and from the computational grid. In the computation with a curvi-linear computational grid, curvi-linear output grids are available in SWAN. This also holds for triangular meshes. An output grid has to be specified by the user with an arbitrary resolution, but it is of course wise to choose a resolution that is fine enough to show relevant spatial details. It must be pointed out that the information on an output grid is obtained from the computational grid by bi-linear interpolation (output always at computational time level). This implies that some inaccuracies are introduced by this interpolation. It also implies that bottom or current information on an output plot has been obtained by interpolating twice: once from the input grid to the computational grid and once from the computational grid to the output grid. If the input-, computational- and output grids are identical, then no interpolation errors occur.


In the regions where the output grid does not cover the computational grid, SWAN assumes output values equal to the corresponding exception value. For example, the default exception value for the significant wave height is -9. The exception values of output quantities can be changed by means of the QUANTITY command.


In nonstationary computations, output can be requested at regular intervals starting at a given time always at computational times.

Output format Binary
Other output format
Pre-processing software needed? No
Describe pre-processing software
Post-processing software needed? No
Describe post-processing software
Visualization software needed? No
If above answer is yes
Other visualization software


Describe processes represented by the model SWAN accounts for the following physics:
  • Wave propagation in time and space, shoaling, refraction due to current and depth, frequency shifting due to currents and non-stationary depth.
  • Wave generation by wind.
  • Three- and four-wave interactions.
  • Whitecapping, bottom friction and depth-induced breaking.
  • Wave-induced set-up.
  • Propagation from laboratory up to global scales.
  • Transmission through and reflection (specular and diffuse) against obstacles.
  • Diffraction.
Describe key physical parameters and equations SWAN contains a number of physical processes (see Scientific/Technical documentation) that add or withdraw wave energy to or from the wave field. The processes included are: wind input, whitecapping, bottom friction, depth-induced wave breaking, obstacle transmission, nonlinear wave-wave interactions (quadruplets and triads) and wave-induced set-up. SWAN can run in several modes, indicating the level of parameterization. SWAN can operate in first-, second- and third-generation mode. The first- and second-generation modes are essentially those of Holthuijsen and De Boer (1988); first-generation with a constant Phillips "constant" of 0.0081 and second-generation with a variable Phillips "constant". An overview of the options is given in Table below.
Describe length scale and resolution constraints SWAN can be used on any scale relevant for wind generated surface gravity waves. However, SWAN is specifically designed for coastal applications that should actually not require such flexibility in scale. The reasons for providing SWAN with such flexibility are:
  • to allow SWAN to be used from laboratory conditions to shelf seas and
  • to nest SWAN in the WAM model or the WAVEWATCH III model which are formulated in terms of spherical coordinates.
Describe time scale and resolution constraints
Describe any numerical limitations and issues Limitations

The DIA approximation for the quadruplet wave-wave interactions depends on the width of the directional distribution of the wave spectrum. It seems to work reasonably in many cases but it is a poor approximation for long-crested waves (narrow directional distribution). It also depends on the frequency resolution. It seems to work reasonably in many cases but it is a poor approximation for frequency resolutions with ratios very different from 10% (see command CGRID). This is a fundamental problem that SWAN shares with other third-generation wave models such as WAM and WAVEWATCH III.


The LTA approximation for the triad wave-wave interactions depends on the width of the directional distribution of the wave spectrum. The present tuning in SWAN (the default settings, see command TRIAD) seems to work reasonably in many cases but it has been obtained from observations in a narrow wave flume (long-crested waves).


As an option SWAN computes wave-induced set-up. In 1D cases the computations are based on exact equations. In 2D cases, the computations are based on approximate equations. This approximation in SWAN can only be applied to open coast (unlimited supply of water from outside the domain, e.g. nearshore coasts and estuaries) in contrast to closed basin, e.g. lakes, where this option should not be used. The effects of wave-induced currents are always ignored.


SWAN does not calculate wave-induced currents. If relevant, such currents should be provided as input to SWAN, e.g. from a circulation model which can be driven by waves from SWAN in an iteration procedure.


In areas where variations in wave height are large within a horizontal scale of a few wave lengths, diffraction should be used. However, the computation of diffraction in arbitrary geophysical conditions is rather complicated and requires considerable computing effort. To avoid this, a phase-decoupled approach is employed in SWAN so that same qualitative behaviour of spatial redistribution and changes in wave direction is obtained. This approach, however, does not properly handle diffraction in harbors or in front of reflecting obstacles.


Describe available calibration data sets
Upload calibration data sets if available:
Describe available test data sets
Upload test data sets if available:
Describe ideal data for testing


Do you have current or future plans for collaborating with other researchers? --
Is there a manual available? Yes
Upload manual if available:
Model website if any Manual: http://swanmodel.sourceforge.net/online_doc/swanuse/swanuse.html

Official SWAN website: http://www.swan.tudelft.nl

Model forum / discussion board https://sourceforge.net/p/swanmodel/mailman/
Comments Notice: SWAN can be freely downloaded from the next site:

https://sourceforge.net/projects/swanmodel/files/swan/ No registration is needed.


This part will be filled out by CSDMS staff

OpenMI compliant No but possible
BMI compliant No but possible
WMT component No but possible
PyMT component
Is this a data component
Can be coupled with:
Model info
Team SWAN
Nr. of publications: 1652
Total citations: 41996
h-index: 87
m-quotient: 1.18

Link to this page



Introduction

History

References




Nr. of publications: 1652
Total citations: 41996
h-index: 87
m-quotient: 1.18



Featured publication(s)YearModel describedType of ReferenceCitations
Booij, N.; Holthuijsen, L.H.; Ris, R.C.; 1997. The SWAN wave model for shallow water.. Proc. 25th Int. Conf. Coastal Engng., Orlando, USA. Volume 1.
(View/edit entry)
1997 SWAN
Model overview 467
Booij, N.; Ris, R. C.; Holthuijsen, L. H.; 1999. A third-generation wave model for coastal regions: 1. Model description and validation. Journal of Geophysical Research: Oceans, 104, 7649–7666. 10.1029/98JC02622
(View/edit entry)
1999 SWAN
Model overview 3484
See more publications of SWAN


Issues

Help

Input Files

Output Files