Summary
Also known as
|
|
Model type
|
Modular
|
Model part of larger framework
|
|
Note on status model
|
|
Date note status model
|
|
Technical specs
Supported platforms
|
Unix, Linux, Windows
|
Other platform
|
|
Programming language
|
Fortran77
|
Other program language
|
|
Code optimized
|
Parallel
Computing"Parallel </br>Computing" is not in the list (Single Processor, Multiple Processors) of allowed values for the "Code optimized" property.
|
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
|
|
When did you indicate the 'code development status'?
|
|
Model availability
|
As code
|
Source code availability (Or provide future intension)
|
Through web repository
|
Source web address
|
http://vlm089.citg.tudelft.nl/swan/index.htm
|
Source csdms web address
|
|
Program license type
|
Other
|
Program license type other
|
GNU General Public License
|
Memory requirements
|
--
|
Typical run time
|
--
|
In/Output
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
|
|
Process
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 harbours or in front of reflecting obstacles.
|
Testing
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
|
--
|
Other
Do you have current or future plans for collaborating with other researchers?
|
--
|
Introduction
History
Papers
Issues
Help
Input Files
Output Files
Download
Source |