Changes between Version 299 and Version 300 of doc/app/initialization_parameters

Timestamp:

Sep 20, 2016 2:55:20 PM (8 years ago)

Author:

kanani

Comment:

--

doc/app/initialization_parameters

@@ -279 +279 @@
 Parameter to choose large-scale forcing from an external file. By means of '''large_scale_forcing''' = ''.T.'' the time-dependent surface heat flux '''shf''', surface water flux '''qsws''', surface temperature '''pt_surface''', surface humidity and surface pressure '''surface_pressure''' as well as vertical profiles of the geostrophic wind components '''ug''' and '''vg''', the large-scale vertical subsidence profile '''w_subs''', the horizontal large-scale advection tendencies of temperature '''td_lsa_lpt''' and humidity '''td_lsa_q''' and the large-scale subsidence tendencies of temperature '''td_sub_lpt''' and humidity '''td_sub_q''' are provided in the simulation. An example can be found [../examples/lsf here].\\
 
-'''large_scale_forcing''' = ''.T.'' requires [#humidity humidity] = .T.. It is not implemented for [#ocean ocean] runs, and it does also not work for non-cyclic lateral boundary conditions and non-flat topography. It is possible to drive the simulations either by means of surface fluxes or by means of prescribed surface values for temperature and humidity. \\
-
-If  '''large_scale_forcing''' is set to ''.T.'' the input file [../iofiles#LSF_DATA LSF_DATA] is required. This file has to contain two kinds of information: time-dependent surface values and time-dependent profile information which can be provided by measurements or larger scale models.\\
+'''large_scale_forcing''' = ''.T.'' requires [#humidity humidity] = .T.. It is not implemented for [#ocean ocean] runs, and it does also not work for non-cyclic lateral boundary conditions and non-flat topography. It is possible to drive the simulations either by means of surface fluxes or by means of prescribed surface values for temperature and humidity.\\
+In case of simulating moderately tall buildings on otherwise flat terrain, the user might choose to nevertheless apply large_scale_forcing. This can be done by setting [#lsf_exception lsf_exception] = ''.T.''. However, it has not been tested so far and thus should be handled with care. \\
+
+If  '''large_scale_forcing''' = ''.T.'', the input file [../iofiles#LSF_DATA LSF_DATA] is required. This file has to contain two kinds of information: time-dependent surface values and time-dependent profile information which can be provided by measurements or larger scale models.\\
 
 In case large-scale forcing shall be used without nudging ([#nudging nudging] = .F.) initial profiles of potential temperature, humidity, and horizontal wind components have to be provided by means of [#pt_surface pt_surface], [#pt_vertical_gradient pt_vertical_gradient], [#pt_vertical_gradient_level pt_vertical_gradient_level] and so forth.
@@ -306 +307 @@
 '''Attention:'''\\
 The large-scale vertical motion is only applied to the prognostic equation for the scalar quantities (potential temperature, humidity if [#humidity humidity] = ''.T.'' or passive scalar if [#passive_scalar passive_scalar] = ''.T.''). It should not be applied to the momentum equations due to incompressibility. Applying it also to the horizontal velocity components would result in mass inconsistencies.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#lsf_exception '''lsf_exception''']
+}}}
+{{{#!td style="vertical-align:top"
+L
+}}}
+{{{#!td style="vertical-align:top"
+.F. 
+}}}
+{{{#!td
+Parameter to explicitly allow large-scale forcing in case of [#topography topography] /= '' 'flat' ''. \\
+
+So far, [#large_scale_forcing large_scale_forcing] is not implemented to be used together with topography. However, in case of simulating moderately tall buildings on otherwise flat terrain, the user might choose to nevertheless apply large_scale_forcing. This can be done by setting '''lsf_exception''' = ''.T.''.
+
+'''Attention:'''\\
+This has not been tested so far and thus should be handled with care.
 }}}
 |----------------