== Initialization parameters ==

----


'''Mode:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#ocean '''ocean''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
L
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
''.F.''
}}}
{{{#!td
Parameter to switch on ocean runs.\\\\
By default PALM is configured to simulate atmospheric flows. However, starting from version 3.3, '''ocean''' = ''.T.'' allows simulation of ocean turbulent flows. Setting this switch has several effects:\\\\
    * An additional prognostic equation for salinity is solved.
    * Potential temperature in buoyancy and stability-related terms is replaced by potential density.
    * Potential density is calculated from the equation of state for seawater after each timestep, using the algorithm proposed by Jackett et al. (2006, J. Atmos. Oceanic Technol., '''23''', 1709-1728).
      So far, only the initial hydrostatic pressure is entered into this equation.
    * z=0 (sea surface) is assumed at the model top (vertical grid index k=nzt on the w-grid), with negative values of z indicating the depth.
    * Initial profiles are constructed (e.g. from [#pt_vertical_gradient pt_vertical_gradient] / [#pt_vertical_gradient_level pt_vertical_gradient_level]) starting from the sea surface, using surface values given by [#pt_surface pt_surface], [#sa_surface sa_surface], [#ug_surface ug_surface], and [#vg_surface vg_surface].
    * Zero salinity flux is used as default boundary condition at the bottom of the sea.
    * If switched on, random perturbations are by default imposed to the upper model domain from zu(nzt*2/3) to zu(nzt-3).\\\\
Relevant 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].\\\\
Section 4.4.2 gives an example for appropriate settings of these and other parameters neccessary for ocean runs.\\\\
'''ocean''' = ''.T.'' does not allow settings of timestep_scheme = '' 'leapfrog' '' or '' 'leapfrog+euler' '' as well as scalar_advec = '' 'ups-scheme' ''.

}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}
[[BR]]

'''Grid:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#averaging_interval '''averaging_interval''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
0.0
}}}
{{{#!td
Averaging interval for all output of temporally averaged data (in s).\\\\
This parameter defines the time interval length for temporally averaged data (vertical profiles, spectra, 2d cross-sections, 3d volume data). By default, data are not subject to temporal averaging. The interval length is limited by the parameter
[[#dt_data_output_av dt_data_output_av]]. In any case, '''averaging_interval <= dt_data_output_av''' must hold.\\\\
If an interval is defined, then by default the average is calculated from the data values of all timesteps lying within this interval. The number of time levels entering into the average can be reduced with the parameter [#dt_averaging_input dt_averaging_input].\\\\
If an averaging interval can not be completed at the end of a run, it will be finished at the beginning of the next restart run. Thus for restart runs, averaging intervals do not necessarily begin at the beginning of the run.\\\\
Parameters [#averaging_interval_pr averaging_interval_pr] and [#averaging_interval_sp averaging_interval_sp] can be used to define different averaging intervals for vertical profile data and spectra, respectively.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}
[[BR]]

'''Numerics:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#averaging_interval '''averaging_interval''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
0.0
}}}
{{{#!td
Averaging interval for all output of temporally averaged data (in s).\\\\
This parameter defines the time interval length for temporally averaged data (vertical profiles, spectra, 2d cross-sections, 3d volume data). By default, data are not subject to temporal averaging. The interval length is limited by the parameter
[[#dt_data_output_av dt_data_output_av]]. In any case, '''averaging_interval <= dt_data_output_av''' must hold.\\\\
If an interval is defined, then by default the average is calculated from the data values of all timesteps lying within this interval. The number of time levels entering into the average can be reduced with the parameter [#dt_averaging_input dt_averaging_input].\\\\
If an averaging interval can not be completed at the end of a run, it will be finished at the beginning of the next restart run. Thus for restart runs, averaging intervals do not necessarily begin at the beginning of the run.\\\\
Parameters [#averaging_interval_pr averaging_interval_pr] and [#averaging_interval_sp averaging_interval_sp] can be used to define different averaging intervals for vertical profile data and spectra, respectively.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}
[[BR]]

'''Boundary conditions:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#bc_e_b '''bc_e_b''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
C*20
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
'' 'neumann' ''
}}}
{{{#!td
Bottom boundary condition of the TKE.\\\\
'''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' ''.\\\\
At the top boundary a Neumann boundary condition is generally used: (e(nz+1) = e(nz)).
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}
[[BR]]

'''Initialization:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#averaging_interval '''averaging_interval''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
0.0
}}}
{{{#!td
Averaging interval for all output of temporally averaged data (in s).\\\\
This parameter defines the time interval length for temporally averaged data (vertical profiles, spectra, 2d cross-sections, 3d volume data). By default, data are not subject to temporal averaging. The interval length is limited by the parameter
[[#dt_data_output_av dt_data_output_av]]. In any case, '''averaging_interval <= dt_data_output_av''' must hold.\\\\
If an interval is defined, then by default the average is calculated from the data values of all timesteps lying within this interval. The number of time levels entering into the average can be reduced with the parameter [#dt_averaging_input dt_averaging_input].\\\\
If an averaging interval can not be completed at the end of a run, it will be finished at the beginning of the next restart run. Thus for restart runs, averaging intervals do not necessarily begin at the beginning of the run.\\\\
Parameters [#averaging_interval_pr averaging_interval_pr] and [#averaging_interval_sp averaging_interval_sp] can be used to define different averaging intervals for vertical profile data and spectra, respectively.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}
[[BR]]

'''Topography:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#averaging_interval '''averaging_interval''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
0.0
}}}
{{{#!td
Averaging interval for all output of temporally averaged data (in s).\\\\
This parameter defines the time interval length for temporally averaged data (vertical profiles, spectra, 2d cross-sections, 3d volume data). By default, data are not subject to temporal averaging. The interval length is limited by the parameter
[[#dt_data_output_av dt_data_output_av]]. In any case, '''averaging_interval <= dt_data_output_av''' must hold.\\\\
If an interval is defined, then by default the average is calculated from the data values of all timesteps lying within this interval. The number of time levels entering into the average can be reduced with the parameter [#dt_averaging_input dt_averaging_input].\\\\
If an averaging interval can not be completed at the end of a run, it will be finished at the beginning of the next restart run. Thus for restart runs, averaging intervals do not necessarily begin at the beginning of the run.\\\\
Parameters [#averaging_interval_pr averaging_interval_pr] and [#averaging_interval_sp averaging_interval_sp] can be used to define different averaging intervals for vertical profile data and spectra, respectively.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}
[[BR]]

'''Canopy:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#averaging_interval '''averaging_interval''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
0.0
}}}
{{{#!td
Averaging interval for all output of temporally averaged data (in s).\\\\
This parameter defines the time interval length for temporally averaged data (vertical profiles, spectra, 2d cross-sections, 3d volume data). By default, data are not subject to temporal averaging. The interval length is limited by the parameter
[[#dt_data_output_av dt_data_output_av]]. In any case, '''averaging_interval <= dt_data_output_av''' must hold.\\\\
If an interval is defined, then by default the average is calculated from the data values of all timesteps lying within this interval. The number of time levels entering into the average can be reduced with the parameter [#dt_averaging_input dt_averaging_input].\\\\
If an averaging interval can not be completed at the end of a run, it will be finished at the beginning of the next restart run. Thus for restart runs, averaging intervals do not necessarily begin at the beginning of the run.\\\\
Parameters [#averaging_interval_pr averaging_interval_pr] and [#averaging_interval_sp averaging_interval_sp] can be used to define different averaging intervals for vertical profile data and spectra, respectively.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}
[[BR]]

'''Others:'''\\
||='''Parameter Name'''  =||='''Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#averaging_interval '''averaging_interval''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 100px"
0.0
}}}
{{{#!td
Averaging interval for all output of temporally averaged data (in s).\\\\
This parameter defines the time interval length for temporally averaged data (vertical profiles, spectra, 2d cross-sections, 3d volume data). By default, data are not subject to temporal averaging. The interval length is limited by the parameter
[[#dt_data_output_av dt_data_output_av]]. In any case, '''averaging_interval <= dt_data_output_av''' must hold.\\\\
If an interval is defined, then by default the average is calculated from the data values of all timesteps lying within this interval. The number of time levels entering into the average can be reduced with the parameter [#dt_averaging_input dt_averaging_input].\\\\
If an averaging interval can not be completed at the end of a run, it will be finished at the beginning of the next restart run. Thus for restart runs, averaging intervals do not necessarily begin at the beginning of the run.\\\\
Parameters [#averaging_interval_pr averaging_interval_pr] and [#averaging_interval_sp averaging_interval_sp] can be used to define different averaging intervals for vertical profile data and spectra, respectively.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#<insert_parameter_name> '''<insert_parameter_name>''']
}}}
{{{#!td style="vertical-align:top"
<insert type>
}}}
{{{#!td style="vertical-align:top"
<insert value>
}}}
{{{#!td
<insert explanation>
}}}