Changes between Version 297 and Version 298 of doc/app/initialization_parameters

Timestamp:

Aug 12, 2016 1:53:23 PM (8 years ago)

Author:

suehring

Comment:

--

doc/app/initialization_parameters

@@ -1386 +1386 @@
 }}}
 {{{#!td style="vertical-align:top"
-'neumann'
+'initial_gradient'
 }}}
 {{{#!td
 Top boundary condition of the scalar concentration.\\\\
-Allowed are the values '' 'dirichlet' '' (s(k=nz) and s(k=nz+1) do not change during the run) and '' 'neumann' ''. With the Neumann boundary condition the value of the scalar concentration gradient at the top is calculated from the initial scalar concentration profile (see [#s_surface s_surface], [#s_vertical_gradient s_vertical_gradient]) by: bc_s_t_val = (s_init(k=nz) - s_init(k=nz-1)) / dzu(nz).
+Allowed are the values '' 'dirichlet' '' (s(k=nz) and s(k=nz+1) do not change during the run), '' 'neumann' '' (s(k=nz+1) = s(k=nz)), and '' 'initial_gradient' ''. With the '' 'initial_gradient' '' boundary condition the value of the scalar concentration gradient at the top is calculated from the initial scalar concentration profile (see [#s_surface s_surface], [#s_vertical_gradient s_vertical_gradient]) by: bc_s_t_val = (s_init(k=nz) - s_init(k=nz-1)) / dzu(nz).
 Using this value (assumed constant during the run) the concentration boundary values are calculated as
 
@@ -1396 +1396 @@
 
 (up to k=nz the prognostic equation for the scalar concentration is solved).
+
+When a constant scalar flux is used at the top boundary ([#top_scalarflux top_scalarflux]), bc_s_t = 'neumann' must be used, because otherwise the resolved scale may contribute to the top flux so that a constant value cannot be guaranteed.
 }}}
 |----------------
@@ -1762 +1764 @@
 The application of a salinity flux at the model top additionally requires the setting of initial parameter [#use_top_fluxes use_top_fluxes] = ''.T.''.\\\\
 See also [#bottom_salinityflux bottom_salinityflux].
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#top_scalarflux '''top_scalarflux''']
+}}}
+{{{#!td style="vertical-align:top"
+R
+}}}
+{{{#!td style="vertical-align:top"
+no prescribed\\
+scalarflux
+}}}
+{{{#!td
+Scalar flux at the top boundary (in kg/kg m/s).\\\\
+If a value is assigned to this parameter, the internal two-dimensional surface scalar flux field {{{sswst}}} is initialized with the value of '''top_scalarflux''' as the top (horizontally homogeneous) boundary condition for the scalar equation. This additionally requires that a Neumann condition must be used for the scalar (see [#bc_s_t bc_s_t]), because otherwise the resolved scale may contribute to the top flux so that a constant flux value cannot be guaranteed.\\\\
+'''Note:'''\\
+The application of a top scalar flux additionally requires the setting of initial parameter [#use_top_fluxes use_top_fluxes] = ''.T.''.\\\\
+No constant flux layer is available at the top boundary so far.
 }}}
 |----------------