Changes between Version 3 and Version 4 of doc/app/ocean_parameters

Timestamp:

Oct 4, 2018 1:35:50 AM (7 years ago)

Author:

raasch

Comment:

--

doc/app/ocean_parameters

@@ -45 +45 @@
 }}}
 {{{#!td
-Parameter to switch on/off the prognostic equation for salinity.\\\\ 
-You may set {{{salinity = .FALSE.}}} in case of ocean mixed layer studies (where the turbulent layer is shallow), in order to save computational time. In that case, a constant salinity as given by [#sa_surface sa_surface] is assumed when calculating the equation of state.
+Parameter to switch on/off calculation of salinity equation.
+
+You may set '''salinity = .FALSE.''' in case of ocean mixed layer studies (where the turbulent layer is shallow), in order to save CPU time. In that case, a constant salinity as given by [#sa_surface sa_surface] is assumed when calculating the equation of state.
+
+In case of '''salinity''' = ''.F.'' non-zero values for parameters [#bottom_salinityflux bottom_salinityflux] and [#top_salinityflux top_salinityflux] are not allowed. 
 }}}
 |----------------
@@ -105 +108 @@
 }}}
 {{{#!td
-... 
+Parameter to switch on the effects of Langmuir circulation in PALM's ocean mode.
+
+The effects of Langmuir circulation are considered in PALM by the Craik-Leibovich vortex force and the Stokes drift velocity, as described in Noh et al. (2004), JPO. In order to switch these effects on, you need to set both parameters, '''stokes_waveheight''' as well as [#stokes_wavelength stokes_wavelength] to a non-zero positive value. '''stokes_waveheight''' sets the height of the ocean surface waves to be used for calculating the vertical profile of the Stokes drift velocity. The direction of the Stokes drift velocity is derived from parameters [wiki:doc/app/inipar#top_momentumflux_u top_momentumflux_u] and [wiki:doc/app/inipar#top_momentumflux_v top_momentumflux_v], which define the wind stress at the ocean surface.
 }}}
 |----------------
@@ -118 +123 @@
 }}}
 {{{#!td
-...
+Parameter to switch on the effects of Langmuir circulation in PALM's ocean mode.
+
+The effects of Langmuir circulation are considered in PALM by the Craik-Leibovich vortex force and the Stokes drift velocity, as described in Noh et al. (2004), JPO. In order to switch these effects on, you need to set both parameters, '''stokes_wavelength''' as well as [#stokes_waveheight stokes_waveheight] to a non-zero positive value. '''stokes_wavelength''' sets the wave length of the ocean surface waves to be used for calculating the vertical profile of the Stokes drift velocity. The direction of the Stokes drift velocity is derived from parameters [wiki:doc/app/inipar#top_momentumflux_u top_momentumflux_u] and [wiki:doc/app/inipar#top_momentumflux_v top_momentumflux_v], which define the wind stress at the ocean surface.
+
 }}}
 |----------------
@@ -169 +177 @@
 }}}
 {{{#!td
-...
+Parameter to switch on turbulence generation by wave breaking.
+
+You need to set '''wave_breaking = .T.''' to switch on turbulence generation by wave breaking at the ocean surface. This way, random perturbation are added to the horizontal velocity components at the top model layer (k = nzt). The parameterization is realized as described in Noh et al. (2004), JPO.
+
+'''WARNING: The implemented parameterization is designed for a vertical grid spacing of dz = 1.25m and time steps of about 4 s. It will probably fail for other setups.'''
 }}}