Changes between Version 263 and Version 264 of doc/app/initialization_parameters


Ignore:
Timestamp:
Oct 27, 2015 7:44:09 AM (9 years ago)
Author:
maronga
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • doc/app/initialization_parameters

    v263 v264  
    264264{{{#!td
    265265Constant eddy diffusivities are used (laminar simulations).\\\\
    266 If this parameter is specified, both in the 1d and in the 3d-model constant values for the eddy diffusivities are used in space and time with K,,m,, = '''km_constant''' and K,,h,, = K,,m,, / [#prandtl_number prandtl_number]. The prognostic equation for the subgrid-scale TKE is switched off. Constant eddy diffusivities are only allowed with the Prandtl layer ([#prandtl_layer prandtl_layer]) switched off.
     266If this parameter is specified, both in the 1d and in the 3d-model constant values for the eddy diffusivities are used in space and time with K,,m,, = '''km_constant''' and K,,h,, = K,,m,, / [#prandtl_number prandtl_number]. The prognostic equation for the subgrid-scale TKE is switched off. Constant eddy diffusivities are only allowed with the constant flux layer ([#constant_flux_layer constant_flux_layer]) switched off.
    267267}}}
    268268|----------------
     
    14341434Bottom boundary condition of the horizontal velocity components u and v.\\\\
    14351435Allowed values are '' 'dirichlet' '' and '' 'neumann' ''. '''bc_uv_b''' = '' 'dirichlet' '' yields the no-slip condition with u=v=0 at the bottom.
    1436 The Neumann boundary condition yields the free-slip condition with u(k=0) = u(k=1) and v(k=0) = v(k=1). With Prandtl - layer switched on (see [#prandtl_layer prandtl_layer]), the free-slip condition is not allowed (otherwise the run will be terminated).
     1436The Neumann boundary condition yields the free-slip condition with u(k=0) = u(k=1) and v(k=0) = v(k=1). With a constant flux layer switched on (see [#constant_flux_layer constant_flux_layer]) at the bottom boundary, the free-slip condition is not allowed (otherwise the run will be terminated).
    14371437}}}
    14381438|----------------
     
    15271527|----------------
    15281528{{{#!td style="vertical-align:top"
    1529 [=#prandtl_layer '''prandtl_layer''']
     1529[=#constant_flux_layer '''constant_flux_layer''']
    15301530}}}
    15311531{{{#!td style="vertical-align:top"
     
    15361536}}}
    15371537{{{#!td
    1538 Parameter to switch on a Prandtl layer.\\\\
    1539 By default, a Prandtl layer is switched on at the bottom boundary between z = 0 and z = 0.5 * [#dz dz] (the first computational grid point above ground for u, v and the scalar quantities). In this case, at the bottom boundary, free-slip conditions for u and v (see [#bc_uv_b bc_uv_b]) are not allowed. Likewise, laminar simulations with constant eddy diffusivities ([#km_constant km_constant]) are forbidden.\\\\
    1540 With Prandtl-layer switched off, the pressure boundary condition [#bc_p_b bc_p_b] = '' 'neumann+inhomo' ''  is not allowed.\\\\
    1541 If the Prandtl-layer is switched off and fluxes shall be prescribed at the surface (by setting [#surface_heatflux surface_heatflux]), it is required to set the parameter [#use_surface_fluxes use_surface_fluxes] = ''.T.''.\\\\
     1538Parameter to switch on a constant flux layer at the bottom boundary.\\\\
     1539By default, a constant flux layer is switched on at the bottom boundary between z = 0 and z = 0.5 * [#dz dz] (the first computational grid point above ground for u, v and the scalar quantities). In this case, at the bottom boundary, free-slip conditions for u and v (see [#bc_uv_b bc_uv_b]) are not allowed. Likewise, laminar simulations with constant eddy diffusivities ([#km_constant km_constant]) are forbidden.\\\\
     1540With a constant flux layer switched off at the bottom, the pressure boundary condition [#bc_p_b bc_p_b] = '' 'neumann+inhomo' ''  is not allowed.\\\\
     1541If the constant flux layer is switched off and fluxes shall be prescribed at the surface (by setting [#surface_heatflux surface_heatflux]), it is required to set the parameter [#use_surface_fluxes use_surface_fluxes] = ''.T.''.\\\\
    15421542The roughness length is declared via the parameter [#roughness_length roughness_length].
    15431543}}}
     
    15741574|----------------
    15751575{{{#!td style="vertical-align:top"
    1576 [=#rif_max '''rif_max''']
    1577 }}}
    1578 {{{#!td style="vertical-align:top"
    1579 R
    1580 }}}
    1581 {{{#!td style="vertical-align:top"
    1582 1.0
    1583 }}}
    1584 {{{#!td
    1585 Upper limit of the flux-Richardson number.\\\\
    1586 With the Prandtl layer switched on (see [#prandtl_layer prandtl_layer]), flux-Richardson numbers ('''rif''') are calculated for z=zp (k=1) in the 3d-model (in the [../../tec/1dmodel 1d-model] for all heights). Their values in particular determine the values of the friction velocity (1d- and 3d-model) and the values of the eddy diffusivity (1d-model). With small wind velocities at the Prandtl layer top or small vertical wind shears in the 1d-model, '''rif''' can take up unrealistic large values. They are limited by an upper ('''rif_max''') and lower limit (see [#rif_min rif_min]) for the flux-Richardson number. The condition '''rif_max''' > rif_min must be met.
    1587 }}}
    1588 |----------------
    1589 {{{#!td style="vertical-align:top"
    1590 [=#rif_min '''rif_min''']
    1591 }}}
    1592 {{{#!td style="vertical-align:top"
    1593 R
    1594 }}}
    1595 {{{#!td style="vertical-align:top"
    1596 -5.0
    1597 }}}
    1598 {{{#!td
    1599 Lower limit of the flux-Richardson number.\\\\
    1600 For further explanations see [#rif_max rif_max]. The condition rif_max > '''rif_min''' must be met.
    1601 }}}
    1602 |----------------
    1603 {{{#!td style="vertical-align:top"
    16041576[=#roughness_length '''roughness_length''']
    16051577}}}
     
    16131585Roughness length (in m).\\\\
    16141586The roughness length for scalars can be given a value different from the one for momentum (see [#z0h_factor z0h_factor]). \\\\
    1615 This parameter is effective only in case that a Prandtl layer is switched on (see [#prandtl_layer prandtl_layer]).
     1587This parameter is effective only in case that a constant flux layer is switched on at the bottom boundary (see [#constant_flux_layer constant_flux_layer]).
    16161588}}}
    16171589|----------------
     
    16641636If a value is assigned to this parameter, the internal two-dimensional surface heat flux field '''shf''' is initialized with the value of '''surface_heatflux''' as bottom (horizontally homogeneous) boundary condition for the temperature equation. This additionally requires that a Neumann condition must be used for the potential temperature (see [#bc_pt_b bc_pt_b]), because otherwise the resolved scale may contribute to the surface flux so that a constant value cannot be guaranteed. Also, changes of the surface temperature (see [#pt_surface_initial_change pt_surface_initial_change]) are not allowed. The parameter [#random_heatflux random_heatflux] can be used to impose random perturbations on the (homogeneous) surface heat flux field '''shf'''.\\\\
    16651637'''Attention:'''\\
    1666 Setting of '''surface_heatflux''' requires setting of [#use_surface_fluxes use_surface_fluxes] = ''.T.,'' if the Prandtl-layer is switched off ([#prandtl_layer prandtl_layer] = ''.F.'').\\\\
     1638Setting of '''surface_heatflux''' requires setting of [#use_surface_fluxes use_surface_fluxes] = ''.T.,'' if the constant flux layer is switched off ([#constant_flux_layer constant_flux_layer] = ''.F.'').\\\\
    16671639In case of a non-flat topography, the internal two-dimensional surface heat flux field '''shf''' is initialized with the value of '''surface_heatflux''' at the bottom surface and [#wall_heatflux wall_heatflux](0) at the topography top face. The parameter random_heatflux can be used to impose random perturbations on this combined surface heat flux field '''shf'''.\\\\
    1668 If no surface heat flux is assigned, '''shf''' is calculated at each timestep by u,,*,, {{{*}}} theta,,*,, (of course only with [#prandtl_layer prandtl_layer] switched on). Here, u,,*,, and theta,,*,, are calculated from the Prandtl law assuming logarithmic wind and temperature profiles between k=0 and k=1. In this case a Dirichlet condition (see [#bc_pt_b bc_pt_b]) must be used as bottom boundary condition for the potential temperature.\\\\
     1640If no surface heat flux is assigned, '''shf''' is calculated at each timestep by u,,*,, {{{*}}} theta,,*,, (of course only with [#constant_flux_layer constant_flux_layer] switched on). Here, u,,*,, and theta,,*,, are calculated from Monin-Obukhov similarity theory assuming logarithmic wind and temperature profiles between k=0 and k=1. In this case a Dirichlet condition (see [#bc_pt_b bc_pt_b]) must be used as bottom boundary condition for the potential temperature.\\\\
    16691641Non-zero values must not be given for '''surface_heatflux''' in case of simulations with pure neutral stratification (see parameter [#neutral neutral]).\\\\
    16701642See also [#top_heatflux top_heatflux].
     
    16841656Scalar flux at the surface (in kg/(m^2^ s)).\\\\
    16851657If a non-zero value is assigned to this parameter, the respective scalar flux value is used as bottom (horizontally homogeneous) boundary condition for the scalar concentration equation. This additionally requires that a Neumann condition must be used for the scalar concentration (see [#bc_s_b bc_s_b]), because otherwise the resolved scale may contribute to the surface flux so that a constant value cannot be guaranteed. Also, changes of the surface scalar concentration (see [#s_surface_initial_change s_surface_initial_change]) are not allowed.\\\\
    1686 If no surface scalar flux is assigned ('''surface_scalarflux''' = ''0.0''), it is calculated at each timestep by u,,*,, {{{*}}} s,,*,, (of course only with [#prandtl_layer prandtl_layer] switched on). Here, s,,*,, is calculated from the Prandtl law assuming a logarithmic scalar concentration profile between k=0 and k=1. In this case a Dirichlet condition (see bc_s_b) must be used as bottom boundary condition for the scalar concentration.
     1658If no surface scalar flux is assigned ('''surface_scalarflux''' = ''0.0''), it is calculated at each timestep by u,,*,, {{{*}}} s,,*,, (of course only with [#constant_flux_layer constant_flux_layer] switched on). Here, s,,*,, is calculated from Monin-Obukhov similarity theory assuming a logarithmic scalar concentration profile between k=0 and k=1. In this case a Dirichlet condition (see bc_s_b) must be used as bottom boundary condition for the scalar concentration.
    16871659}}}
    16881660|----------------
     
    17001672Kinematic water flux near the surface (in m/s).\\\\
    17011673If a non-zero value is assigned to this parameter, the respective water flux value is used as bottom (horizontally homogeneous) boundary condition for the humidity equation. This additionally requires that a Neumann condition must be used for the specific humidity / total water content (see [#bc_q_b bc_q_b]), because otherwise the resolved scale may contribute to the surface flux so that a constant value cannot be guaranteed. Also, changes of the surface humidity (see [#q_surface_initial_change q_surface_initial_change]) are not allowed.\\\\
    1702 If no surface water flux is assigned ('''surface_waterflux''' = ''0.0''), it is calculated at each timestep by u,,*,, {{{*}}} q,,*,, (of course only with Prandtl layer switched on). Here, q,,*,, is calculated from the Prandtl law assuming a logarithmic temperature profile between k=0 and k=1. In this case a Dirichlet condition (see bc_q_b) must be used as the bottom boundary condition for the humidity.
     1674If no surface water flux is assigned ('''surface_waterflux''' = ''0.0''), it is calculated at each timestep by u,,*,, {{{*}}} q,,*,, (of course only with a constant flux layer switched on). Here, q,,*,, is calculated from Monin-Obukhov similarity theory assuming a logarithmic temperature profile between k=0 and k=1. In this case a Dirichlet condition (see bc_q_b) must be used as the bottom boundary condition for the humidity.
    17031675}}}
    17041676|----------------
     
    17181690'''Note:'''\\
    17191691The application of a top heat flux additionally requires the setting of initial parameter [#use_top_fluxes use_top_fluxes] = ''.T.''.\\\\
    1720 No Prandtl-layer is available at the top boundary so far.\\\\
     1692No constant flux layer is available at the top boundary so far.\\\\
    17211693Non-zero values must not be given for '''top_heatflux''' in case of simulations with pure neutral stratification (see parameter [#neutral neutral]).\\\\
    17221694See also [#surface_heatflux surface_heatflux].
     
    17391711The application of a top momentum flux additionally requires the setting of initial parameter [#use_top_fluxes use_top_fluxes] = ''.T.''. Setting of '''top_momentumflux_u''' requires setting of [#top_momentumflux_v top_momentumflux_v] also.\\\\
    17401712A Neumann condition should be used for the u velocity component (see [#bc_uv_t bc_uv_t]), because otherwise the resolved scale may contribute to the top flux so that a constant flux value cannot be guaranteed.\\\\
    1741 No Prandtl-layer is available at the top boundary so far.\\\\
     1713No constant flux layer is available at the top boundary so far.\\\\
    17421714The coupled ocean parameter file [../iofiles#PARIN_O PARIN_O] should include dummy REAL value assignments to both '''top_momentumflux_u''' and [#top_momentumflux_v top_momentumflux_v] (e.g. '''top_momentumflux_u''' = ''0.0,'' [#top_momentumflux_v top_momentumflux_v] = ''0.0'') to enable the momentum flux coupling.
    17431715}}}
     
    17591731The application of a top momentum flux additionally requires the setting of initial parameter [#use_top_fluxes use_top_fluxes] = ''.T.''. Setting of '''top_momentumflux_v''' requires setting of [#top_momentumflux_u top_momentumflux_u] also.\\\\
    17601732A Neumann condition should be used for the v velocity component (see [#bc_uv_t bc_uv_t]), because otherwise the resolved scale may contribute to the top flux so that a constant flux value cannot be guaranteed.\\\\
    1761 No Prandtl-layer is available at the top boundary so far.\\\\
     1733No constant flux layer is available at the top boundary so far.\\\\
    17621734The coupled ocean parameter file [../iofiles#PARIN_O PARIN_O] should include dummy REAL value assignments to both [#top_momentumflux_u top_momentumflux_u] and '''top_momentumflux_v''' (e.g. [#top_momentumflux_u top_momentumflux_u] = ''0.0,'' '''top_momentumflux_'''v = ''0.0'') to enable the momentum flux coupling.
    17631735}}}
     
    18311803{{{#!td
    18321804Parameter to steer the treatment of the subgrid-scale vertical fluxes within the diffusion terms at k=1 (bottom boundary).\\\\
    1833 By default, the near-surface subgrid-scale fluxes are parameterized (like in the remaining model domain) using the gradient approach. If '''use_surface_fluxes''' = ''.T.,'' the user-assigned surface fluxes are used instead (see [#surface_heatflux surface_heatflux], [#surface_waterflux surface_waterflux] and [#surface_scalarflux surface_scalarflux]) or the surface fluxes are calculated via the Prandtl layer relation (depends on the bottom boundary conditions, see [#bc_pt_b bc_pt_b], [#bc_q_b bc_q_b] and [#bc_s_b bc_s_b]).\\\\
    1834 '''use_surface_fluxes''' is automatically set ''.T.,'' if a Prandtl layer is used (see [#prandtl_layer prandtl_layer]).\\\\
    1835 The user may prescribe the surface fluxes at the bottom boundary without using a Prandtl layer by setting '''use_surface_fluxes''' = ''.T.'' and [#prandtl_layer prandtl_layer] = ''.F.''. If , in this case, the momentum flux (u,,*,,^2^) should also be prescribed, the user must assign an appropriate value within the [../userint user-defined code].
     1805By default, the near-surface subgrid-scale fluxes are parameterized (like in the remaining model domain) using the gradient approach. If '''use_surface_fluxes''' = ''.T.,'' the user-assigned surface fluxes are used instead (see [#surface_heatflux surface_heatflux], [#surface_waterflux surface_waterflux] and [#surface_scalarflux surface_scalarflux]) or the surface fluxes are calculated via Monin-Obukhov similarity theory (depends on the bottom boundary conditions, see [#bc_pt_b bc_pt_b], [#bc_q_b bc_q_b] and [#bc_s_b bc_s_b]).\\\\
     1806'''use_surface_fluxes''' is automatically set ''.T.,'' if a constant flux layer is used (see [#constant_flux_layer constant_flux_layer]).\\\\
     1807The user may prescribe the surface fluxes at the bottom boundary without using a constant flux layer by setting '''use_surface_fluxes''' = ''.T.'' and [#constant_flux_layer constant_flux_layer] = ''.F.''. If , in this case, the momentum flux (u,,*,,^2^) should also be prescribed, the user must assign an appropriate value within the [../userint user-defined code].
    18361808}}}
    18371809|----------------
     
    18791851This parameter can be used to define a value for the roughness length for scalars (potential temperature, humidity/scalar) which differs from the one for momentum. The roughness length for scalars z0h is calculated as: \\
    18801852      z0h = z0h_factor * [#roughness_length roughness_length]. \\
    1881 This parameter is effective only in case that a Prandtl layer is switched on (see [#prandtl_layer prandtl_layer]).
     1853This parameter is effective only in case that a constant flux layer is switched on at the bottom boundary (see [#constant_flux_layer constant_flux_layer]).
    18821854}}}
    18831855
     
    20091981Instead of using the geostrophic wind for constructing the initial u,v-profiles, these profiles can also be directly set using parameters [#u_profile u_profile], [#v_profile v_profile], and [#uv_heights uv_heights], e.g. if observed profiles shall be used as initial values. In runs with non-cyclic horizontal boundary conditions these profiles are also used as fixed mean inflow profiles.\\\\
    20101982'' 'set_1d-model_profiles' ''\\\\
    2011       The arrays of the 3d-model are initialized with the (stationary) solution of the [../../tec/1dmodel 1d-model]. These are the variables e, K,,h,,{{{,}}} K,,m,,{{{,}}} u, v and with Prandtl layer switched on rif, us, usws, vsws. The temperature (humidity) profile consisting of linear sections is set as for '' 'set_constant_profiles' '' and assumed as constant in time within the 1d-model. For steering of the 1d-model a set of parameters with suffix "_1d" (e.g. [#end_time_1d end_time_1d], [#damp_level_1d damp_level_1d]) is available.\\\\
     1983      The arrays of the 3d-model are initialized with the (stationary) solution of the [../../tec/1dmodel 1d-model]. These are the variables e, K,,h,,{{{,}}} K,,m,,{{{,}}} u, v and with a constant flux layer switched on ol, us, usws, vsws. The temperature (humidity) profile consisting of linear sections is set as for '' 'set_constant_profiles' '' and assumed as constant in time within the 1d-model. For steering of the 1d-model a set of parameters with suffix "_1d" (e.g. [#end_time_1d end_time_1d], [#damp_level_1d damp_level_1d]) is available.\\\\
    20121984'' 'by_user' ''\\\\
    20131985      The initialization of the arrays of the 3d-model is under complete control of the user and has to be done in routine {{{user_init_3d_model}}} of the [../userint user-interface].\\\\
     
    25612533Alternatively, the user may add code to the user interface subroutine [#user_init_grid user_init_grid] to allow further topography modes. These require to explicitly set the [#topography_grid_convention topography_grid_convention] to either '' 'cell_edge' '' or '' 'cell_center' ''.\\\\
    25622534Non-flat '''topography''' modes may assign a kinematic sensible [#wall_heatflux wall_heatflux] and a kinematic [#wall_humidityflux wall_humidityflux] (requires [#humidity humidity] = .T.) or a [#wall_scalarflux wall_scalarflux] (requires [#passive_scalar passive_scalar] = .T.) at the five topography faces.\\\\
    2563 All non-flat '''topography''' modes require the use of [#psolver psolver] /= '' 'sor' '',  [#alpha_surface alpha_surface] = 0.0, [#galilei_transformation galilei_transformation] = ''.F.'', [#cloud_droplets cloud_droplets] = ''.F.'' (has not been tested), and [#prandtl_layer prandtl_layer] = ''.T.''.\\\\
     2535All non-flat '''topography''' modes require the use of [#psolver psolver] /= '' 'sor' '',  [#alpha_surface alpha_surface] = 0.0, [#galilei_transformation galilei_transformation] = ''.F.'', [#cloud_droplets cloud_droplets] = ''.F.'' (has not been tested), and [#constant_flux_layer constant_flux_layer] = ''.T.''.\\\\
    25642536Note that an inclined model domain requires the use of [#topography topography] = '' 'flat' '' and a nonzero alpha_surface.
    25652537}}}
     
    28072779Data for the total domain and all defined subdomains are output to the same file(s) ([../iofiles#DATA_1D_PR_NETCDF DATA_1D_PR_NETCDF], [../iofiles#DATA_1D_TS_NETCDF DATA_1D_TS_NETCDF]). In case of '''statistic_regions''' > 0, data on the file for the different domains can be distinguished by a suffix which is appended to the quantity names. Suffix 0 means data for the total domain, suffix 1 means data for subdomain 1, etc.
    28082780}}}
     2781|----------------
     2782{{{#!td style="vertical-align:top"
     2783[=#zeta_max '''zeta_max''']
     2784}}}
     2785{{{#!td style="vertical-align:top"
     2786R
     2787}}}
     2788{{{#!td style="vertical-align:top"
     278920.0
     2790}}}
     2791{{{#!td
     2792Upper limit of the stability parameter {{{[zeta = z_mo/L}}}, with {{{z_mo}}} being the height of the constant flux layer, and {{{L}}} being the Obukhov length.\\\\
     2793With a constant flux layer switched on (see [#constant_flux_layer constant_flux_layer]), the Obukhov length ('''ol''') is calculated for {{{z=z_mo (k=1)}}} in the 3d-model (in the [../../tec/1dmodel 1d-model] for all heights) for each horizontal grid point. Its particular values determine the values of the friction velocity (1d- and 3d-model) and the values of the eddy diffusivity (1d-model). With small wind velocities at the top of the constant flux layer or small vertical wind shears in the 1d-model, the stability parameter '''zeta = z_mo/ol''' can take up unrealistic values. They are limited by an upper ('''zeta_max''') and lower limit (see [#zeta_min zeta_min]). The condition '''zeta_max''' > zeta_min must be met.
     2794}}}
     2795|----------------
     2796{{{#!td style="vertical-align:top"
     2797[=#zeta_min '''zeta_min''']
     2798}}}
     2799{{{#!td style="vertical-align:top"
     2800R
     2801}}}
     2802{{{#!td style="vertical-align:top"
     2803-9990.0
     2804}}}
     2805{{{#!td
     2806Lower limit of the stability parameter {{{[zeta = z_mo/L}}}, with {{{z_mo}}} being the height of the constant flux layer, and {{{L}}} being the Obukhov length.\\\\
     2807For further explanations see [#zeta_max zeta_max]. The condition zeta_max > '''zeta_min''' must be met.
     2808}}}