Changes between Version 22 and Version 23 of doc/app/initialization_parameters


Ignore:
Timestamp:
Sep 13, 2010 2:17:26 PM (14 years ago)
Author:
kanani
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • doc/app/initialization_parameters

    v22 v23  
    11
    2 == Initialization parameters (Namelist @inipar) ==
    3 
     2== Initialization parameters ==
     3==== [#mode Mode] ====
     4==== [#grid Grid] ====
     5==== [#num Numerics] ====
     6==== [#bc Boundary Conditions] ====
     7==== [#ini Initialization] ====
     8==== [#topo Topography] ====
     9==== [#canopy Canopy] ====
     10==== [#others Others] ====
     11\\\\
     12NAMELIST group name: '''inipar'''\\
    413----
    514
    615
    7 '''Mode:'''\\
    8 ||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
     16[=#mode '''Mode:]\\
     17||='''Parameter Name'''  =||='''FORTRAN Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    918|----------------
    1019{{{#!td style="vertical-align:top; text-align:left;width: 150px"
     
    2938    * If switched on, random perturbations are by default imposed to the upper model domain from zu(nzt*2/3) to zu(nzt-3).\\\\
    3039Relevant parameters to be exclusively used for steering ocean runs are [#bc_sa_t bc_sa_t], [#bottom_salinityflux bottom_salinityflux], [#sa_surface sa_surface], [#sa_vertical_gradient sa_vertical_gradient], [#sa_vertical_gradient_level sa_vertical_gradient_level], and [#top_salinityflux top_salinityflux].\\\\
    31 Section 4.4.2 gives an example for appropriate settings of these and other parameters neccessary for ocean runs.\\\\
    32 '''ocean''' = ''.T.'' does not allow settings of timestep_scheme = '' 'leapfrog' '' or '' 'leapfrog+euler' '' as well as scalar_advec = '' 'ups-scheme' ''.
    33 
    34 }}}
    35 |----------------
    36 {{{#!td style="vertical-align:top"
    37 [=#<insert_parameter_name> '''<insert_parameter_name>''']
    38 }}}
    39 {{{#!td style="vertical-align:top"
    40 <insert type>
    41 }}}
    42 {{{#!td style="vertical-align:top"
    43 <insert value>
    44 }}}
    45 {{{#!td
    46 <insert explanation>
    47 }}}
    48 [[BR]]
    49 
    50 '''Grid:'''\\
    51 ||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    52 |----------------
    53 {{{#!td style="vertical-align:top; text-align:left;width: 150px"
    54 [=# '''''']
    55 }}}
    56 {{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
    57 
    58 }}}
    59 {{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
    60 
    61 }}}
    62 {{{#!td
    63 
    64 }}}
    65 |----------------
    66 {{{#!td style="vertical-align:top"
    67 [=#<insert_parameter_name> '''<insert_parameter_name>''']
    68 }}}
    69 {{{#!td style="vertical-align:top"
    70 <insert type>
    71 }}}
    72 {{{#!td style="vertical-align:top"
    73 <insert value>
    74 }}}
    75 {{{#!td
    76 <insert explanation>
    77 }}}
    78 [[BR]]
    79 
    80 '''Numerics:'''\\
    81 ||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    82 |----------------
    83 {{{#!td style="vertical-align:top; text-align:left;width: 150px"
    84 [=# '''''']
    85 }}}
    86 {{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
    87 
    88 }}}
    89 {{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
    90 
    91 }}}
    92 {{{#!td
    93 
    94 }}}
    95 |----------------
    96 {{{#!td style="vertical-align:top"
    97 [=#<insert_parameter_name> '''<insert_parameter_name>''']
    98 }}}
    99 {{{#!td style="vertical-align:top"
    100 <insert type>
    101 }}}
    102 {{{#!td style="vertical-align:top"
    103 <insert value>
    104 }}}
    105 {{{#!td
    106 <insert explanation>
    107 }}}
    108 [[BR]]
    109 
    110 '''Boundary conditions:'''\\
    111 ||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    112 |----------------
    113 {{{#!td style="vertical-align:top; text-align:left;width: 150px"
     40[#d3par d3par] [Section 4.4.2] gives an example for appropriate settings of these and other parameters neccessary for ocean runs.\\\\
     41'''ocean''' = ''.T.'' does not allow settings of [#timestep_scheme timestep_scheme] = '' 'leapfrog' '' or '' 'leapfrog+euler' '' as well as [#scalar_advec scalar_advec] = '' 'ups-scheme' ''.
     42
     43}}}
     44|----------------
     45{{{#!td style="vertical-align:top"
     46[=#<insert_parameter_name> '''<insert_parameter_name>''']
     47}}}
     48{{{#!td style="vertical-align:top"
     49<insert type>
     50}}}
     51{{{#!td style="vertical-align:top"
     52<insert value>
     53}}}
     54{{{#!td
     55<insert explanation>
     56}}}
     57[[BR]]
     58
     59[=#grid '''Grid:]\\
     60||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
     61|----------------
     62{{{#!td style="vertical-align:top; text-align:left;width: 150px"
     63[=# '''''']
     64}}}
     65{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
     66
     67}}}
     68{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
     69
     70}}}
     71{{{#!td
     72
     73}}}
     74|----------------
     75{{{#!td style="vertical-align:top"
     76[=#<insert_parameter_name> '''<insert_parameter_name>''']
     77}}}
     78{{{#!td style="vertical-align:top"
     79<insert type>
     80}}}
     81{{{#!td style="vertical-align:top"
     82<insert value>
     83}}}
     84{{{#!td
     85<insert explanation>
     86}}}
     87[[BR]]
     88
     89[=#num '''Numerics:]\\
     90||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
     91|----------------
     92{{{#!td style="vertical-align:top; text-align:left;width: 150px"
     93[=# '''''']
     94}}}
     95{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
     96
     97}}}
     98{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
     99
     100}}}
     101{{{#!td
     102
     103}}}
     104|----------------
     105{{{#!td style="vertical-align:top"
     106[=#<insert_parameter_name> '''<insert_parameter_name>''']
     107}}}
     108{{{#!td style="vertical-align:top"
     109<insert type>
     110}}}
     111{{{#!td style="vertical-align:top"
     112<insert value>
     113}}}
     114{{{#!td
     115<insert explanation>
     116}}}
     117[[BR]]
     118
     119[=#bc '''Boundary Conditions:]\\
     120||='''Parameter Name'''  =||='''FORTRAN Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
     121|----------------
     122{{{#!td style="vertical-align:top;width: 150px"
     123[=#adjust_mixing_length '''adjust_mixing_length''']
     124}}}
     125{{{#!td style="vertical-align:top;width: 50px"
     126L
     127}}}
     128{{{#!td style="vertical-align:top;width: 100px"
     129.F.
     130}}}
     131{{{#!td
     132Near-surface adjustment of the mixing length to the Prandtl-layer law.\\\\
     133Usually the mixing length in LES models l,,LES,, depends (as in PALM) on the grid size and is possibly restricted further in case of stable stratification and near the lower wall (see parameter [#wall_adjustment]). With '''adjust_mixing_length''' = ''.T.'' the Prandtl' mixing length l,,PR,, = kappa * z/phi is calculated and the mixing length actually used in the model is set l = MIN (l,,LES,, , l,,PR,,). This usually gives a decrease of the mixing length at the bottom boundary and considers the fact that eddy sizes decrease in the vicinity of the wall.\\\\
     134'''Warning:''' So far, there is no good experience with '''adjust_mixing_length''' = ''.T.''{{{!}}}\\\\
     135With '''adjust_mixing_length''' = ''.T.'' and the Prandtl-layer being switched on (see [#prandtl_layer prandtl_layer]) '' '(u*){{{**}}} 2+neumann' '' should always be set as the lower boundary condition for the TKE (see [#bc_e_b bc_e_b]), otherwise the near-surface value of the TKE is not in agreement with the Prandtl-layer law (Prandtl-layer law and Prandtl-Kolmogorov-Ansatz should provide the same value for K,,m,,). A warning is given, if this is not the case.
     136}}}
     137|----------------
     138{{{#!td style="vertical-align:top"
    114139[=#bc_e_b '''bc_e_b''']
    115140}}}
    116 {{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
     141{{{#!td style="vertical-align:top"
    117142C*20
    118143}}}
    119 {{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
    120 '' 'neumann' ''
     144{{{#!td style="vertical-align:top"
     145'neumann'
    121146}}}
    122147{{{#!td
    123148Bottom boundary condition of the TKE.\\\\
    124 '''bc_e_b''' may be set to '' 'neumann' '' or '' '(u*){{{**}}}2+neumann' ''. '''bc_e_b''' = '' 'neumann' '' yields to e(k=0)=e(k=1) (Neumann boundary condition), where e(k=1) is calculated via the prognostic TKE equation. Choice of '' '(u*){{{**}}}2+neumann' '' also yields to e(k=0)=e(k=1), but the TKE at the Prandtl-layer top (k=1) is calculated diagnostically by e(k=1)=(us/0.1)**2. However, this is only allowed if a Prandtl-layer is used (#prandtl_layer). If this is not the case, a warning is given and '''bc_e_b''' is reset to '' 'neumann' ''.\\\\
     149'''bc_e_b''' may be set to '' 'neumann' '' or '' '(u*){{{**}}}2+neumann' ''. '''bc_e_b''' = '' 'neumann' '' yields to e(k=0)=e(k=1) (Neumann boundary condition), where e(k=1) is calculated via the prognostic TKE equation. Choice of '' '(u*){{{**}}}2+neumann' '' also yields to e(k=0)=e(k=1), but the TKE at the Prandtl-layer top (k=1) is calculated diagnostically by e(k=1)=(us/0.1){{{**}}}2. However, this is only allowed if a Prandtl-layer is used ([#prandtl_layer prandtl_layer]). If this is not the case, a warning is given and '''bc_e_b''' is reset to '' 'neumann' ''.\\\\
    125150At the top boundary a Neumann boundary condition is generally used: (e(nz+1) = e(nz)).
    126151}}}
    127152|----------------
    128153{{{#!td style="vertical-align:top"
    129 [=#<insert_parameter_name> '''<insert_parameter_name>''']
    130 }}}
    131 {{{#!td style="vertical-align:top"
    132 <insert type>
    133 }}}
    134 {{{#!td style="vertical-align:top"
    135 <insert value>
    136 }}}
    137 {{{#!td
    138 <insert explanation>
    139 }}}
    140 [[BR]]
    141 
    142 '''Initialization:'''\\
    143 ||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    144 |----------------
    145 {{{#!td style="vertical-align:top; text-align:left;width: 150px"
    146 [=# '''''']
    147 }}}
    148 {{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
    149 
    150 }}}
    151 {{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
    152 
    153 }}}
    154 {{{#!td
    155 
    156 }}}
    157 |----------------
    158 {{{#!td style="vertical-align:top"
    159 [=#<insert_parameter_name> '''<insert_parameter_name>''']
    160 }}}
    161 {{{#!td style="vertical-align:top"
    162 <insert type>
    163 }}}
    164 {{{#!td style="vertical-align:top"
    165 <insert value>
    166 }}}
    167 {{{#!td
    168 <insert explanation>
    169 }}}
    170 [[BR]]
    171 
    172 '''Topography:'''\\
     154[=#bc_lr '''bc_lr''']
     155}}}
     156{{{#!td style="vertical-align:top"
     157C*20
     158}}}
     159{{{#!td style="vertical-align:top"
     160'cyclic'
     161}}}
     162{{{#!td
     163Boundary condition along x (for all quantities).\\\\
     164By default, a cyclic boundary condition is used along x.\\\\
     165'''bc_lr''' may also be assigned the values '' 'dirichlet/radiation' '' (inflow from left, outflow to the right) or '' 'radiation/dirichlet' '' (inflow from right, outflow to the left). This requires the multi-grid method to be used for solving the Poisson equation for perturbation pressure (see [../d3par#psolver psolver]) and it also requires cyclic boundary conditions along y (see [#bc_ns bc_ns]).\\\\
     166In case of these non-cyclic lateral boundaries, a Dirichlet condition is used at the inflow for all quantities (initial vertical profiles - see [#initializing_actions initializing_actions] - are fixed during the run) except u, to which a Neumann (zero gradient) condition is applied. At the outflow, a radiation condition is used for all velocity components, while a Neumann (zero gradient) condition is used for the scalars. For perturbation pressure Neumann (zero gradient) conditions are assumed both at the inflow and at the outflow.\\\\
     167When using non-cyclic lateral boundaries, a filter is applied to the velocity field in the vicinity of the outflow in order to suppress any reflections of outgoing disturbances (see [#km_damp_max km_damp_max] and [#outflow_damping_width outflow_damping_width]).\\\\
     168In order to maintain a turbulent state of the flow, it may be neccessary to continuously impose perturbations on the horizontal velocity field in the vicinity of the inflow throughout the whole run. This can be switched on using [../d3par#create_disturbances create_disturbances]. The horizontal range to which these perturbations are applied is controlled by the parameters [#inflow_disturbance_begin inflow_disturbance_begin] and [#inflow_disturbance_end inflow_disturbance_end]. The vertical range and the perturbation amplitude are given by [../d3par#disturbance_level_b disturbance_level_b], [../d3par#disturbance_level_t disturbance_level_t], and [../d3par#disturbance_amplitude disturbance_amplitude]. The time interval at which perturbations are to be imposed is set by [../d3par#dt_disturb dt_disturb].\\\\
     169In case of non-cyclic horizontal boundaries [../d3par#call_psolver_at_all_substeps call_psolver_at_all_substeps] = ''.T.'' should be used.
     170
     171'''Note:'''
     172Using non-cyclic lateral boundaries requires very sensitive adjustments of the inflow (vertical profiles) and the bottom boundary conditions, e.g. a surface heating should not be applied near the inflow boundary because this may significantly disturb the inflow. Please check the model results very carefully.
     173}}}
     174|----------------
     175{{{#!td style="vertical-align:top"
     176[=#<insert_parameter_name> '''<insert_parameter_name>''']
     177}}}
     178{{{#!td style="vertical-align:top"
     179<insert type>
     180}}}
     181{{{#!td style="vertical-align:top"
     182<insert value>
     183}}}
     184{{{#!td
     185<insert explanation>
     186}}}
     187|----------------
     188{{{#!td style="vertical-align:top"
     189[=#<insert_parameter_name> '''<insert_parameter_name>''']
     190}}}
     191{{{#!td style="vertical-align:top"
     192<insert type>
     193}}}
     194{{{#!td style="vertical-align:top"
     195<insert value>
     196}}}
     197{{{#!td
     198<insert explanation>
     199}}}
     200[[BR]]
     201
     202[=#ini '''Initialization:]\\
     203||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
     204|----------------
     205{{{#!td style="vertical-align:top; text-align:left;width: 150px"
     206[=# '''''']
     207}}}
     208{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
     209
     210}}}
     211{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
     212
     213}}}
     214{{{#!td
     215
     216}}}
     217|----------------
     218{{{#!td style="vertical-align:top"
     219[=#<insert_parameter_name> '''<insert_parameter_name>''']
     220}}}
     221{{{#!td style="vertical-align:top"
     222<insert type>
     223}}}
     224{{{#!td style="vertical-align:top"
     225<insert value>
     226}}}
     227{{{#!td
     228<insert explanation>
     229}}}
     230[[BR]]
     231
     232[=#topo '''Topography:]\\
    173233||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    174234|----------------
     
    216276[[BR]]
    217277
    218 '''Canopy:'''\\
    219 ||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    220 |----------------
    221 {{{#!td style="vertical-align:top; text-align:left;width: 150px"
    222 [=# '''''']
    223 }}}
    224 {{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
    225 
    226 }}}
    227 {{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
    228 
    229 }}}
    230 {{{#!td
    231 
    232 }}}
    233 |----------------
    234 {{{#!td style="vertical-align:top"
    235 [=#<insert_parameter_name> '''<insert_parameter_name>''']
    236 }}}
    237 {{{#!td style="vertical-align:top"
    238 <insert type>
    239 }}}
    240 {{{#!td style="vertical-align:top"
    241 <insert value>
    242 }}}
    243 {{{#!td
    244 <insert explanation>
    245 }}}
    246 [[BR]]
    247 
    248 '''Others:'''\\
    249 ||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
    250 |----------------
    251 {{{#!td style="vertical-align:top; text-align:left;width: 150px"
    252 [=# '''''']
    253 }}}
    254 {{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
    255 
    256 }}}
    257 {{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
    258 
    259 }}}
    260 {{{#!td
    261 
    262 }}}
    263 |----------------
    264 {{{#!td style="vertical-align:top"
    265 [=#<insert_parameter_name> '''<insert_parameter_name>''']
    266 }}}
    267 {{{#!td style="vertical-align:top"
    268 <insert type>
    269 }}}
    270 {{{#!td style="vertical-align:top"
    271 <insert value>
    272 }}}
    273 {{{#!td
    274 <insert explanation>
    275 }}}
     278[=#canopy '''Canopy:]\\
     279||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
     280|----------------
     281{{{#!td style="vertical-align:top; text-align:left;width: 150px"
     282[=# '''''']
     283}}}
     284{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
     285
     286}}}
     287{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
     288
     289}}}
     290{{{#!td
     291
     292}}}
     293|----------------
     294{{{#!td style="vertical-align:top"
     295[=#<insert_parameter_name> '''<insert_parameter_name>''']
     296}}}
     297{{{#!td style="vertical-align:top"
     298<insert type>
     299}}}
     300{{{#!td style="vertical-align:top"
     301<insert value>
     302}}}
     303{{{#!td
     304<insert explanation>
     305}}}
     306[[BR]]
     307
     308[=#others '''Others:]\\
     309||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
     310|----------------
     311{{{#!td style="vertical-align:top; text-align:left;width: 150px"
     312[=# '''''']
     313}}}
     314{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
     315
     316}}}
     317{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
     318
     319}}}
     320{{{#!td
     321
     322}}}
     323|----------------
     324{{{#!td style="vertical-align:top"
     325[=#<insert_parameter_name> '''<insert_parameter_name>''']
     326}}}
     327{{{#!td style="vertical-align:top"
     328<insert type>
     329}}}
     330{{{#!td style="vertical-align:top"
     331<insert value>
     332}}}
     333{{{#!td
     334<insert explanation>
     335}}}