Home

Context Navigation

source: palm/trunk/SOURCE/modules.f90 @ 4828

Last change on this file since 4828 was 4828, checked in by Giersch, 4 years ago
Copyright updated to year 2021, interface pmc_sort removed to accelarate the nesting code
Property svn:keywords set to `Id`
File size: 145.4 KB

Line
1	!> @file modules.f90
2	!--------------------------------------------------------------------------------------------------!
3	! This file is part of the PALM model system.
4	!
5	! PALM is free software: you can redistribute it and/or modify it under the terms of the GNU General
6	! Public License as published by the Free Software Foundation, either version 3 of the License, or
7	! (at your option) any later version.
8	!
9	! PALM is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
10	! implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
11	! Public License for more details.
12	!
13	! You should have received a copy of the GNU General Public License along with PALM. If not, see
14	! <http://www.gnu.org/licenses/>.
15	!
16	! Copyright 1997-2021 Leibniz Universitaet Hannover
17	!--------------------------------------------------------------------------------------------------!
18	!
19	! Current revisions:
20	! ------------------
21	!
22	!
23	! Former revisions:
24	! -----------------
25	! $Id: modules.f90 4828 2021-01-05 11:21:41Z Giersch $
26	! file re-formatted to follow the PALM coding standard
27	!
28	! 4742 2020-10-14 15:11:02Z schwenkel
29	! Implement snow and graupel (bulk microphysics)
30	!
31	! 4721 2020-10-02 10:21:52Z suehring
32	! Change default value spinup_pt_amplitude to 0.0 K
33	!
34	! 4680 2020-09-16 10:20:34Z gronemeier
35	! Add option to fix date or time of the simulation
36	!
37	! 4658 2020-08-28 18:15:50Z suehring
38	! Change default value of dt_spinup
39	!
40	! 4629 2020-07-29 09:37:56Z raasch
41	! support for MPI Fortran77 interface (mpif.h) removed
42	!
43	! 4581 2020-06-29 08:49:58Z suehring
44	! +sums_wschs_ws_l
45	!
46	! 4574 2020-06-24 16:33:32Z pavelkrc
47	!
48	! 4572 2020-06-24 10:09:41Z gronemeier
49	! Revise description of rotation_angle
50	!
51	! 4565 2020-06-15 08:30:38Z oliver.maas
52	! added pt_surface_heating_rate
53	!
54	! 4536 2020-05-17 17:24:13Z raasch
55	! +qsurf_av, ssurf_av
56	!
57	! 4505 2020-04-20 15:37:15Z schwenkel
58	! Add flag for saturation check
59	!
60	! 4502 2020-04-17 16:14:16Z raasch
61	! Implementation of ice microphysics
62	!
63	! 4495 2020-04-13 20:11:20Z raasch
64	! +restart_data_format, restart_data_format_input\|output, include_total_domain_boundaries
65	!
66	! 4476 2020-03-27 12:56:41Z maronga
67	! Renamed variables for subgrids-scale model steering
68	!
69	! 4473 2020-03-25 21:04:07Z gronemeier
70	! moved wall_adjustment_factor to turbulence_closure_mod
71	!
72	! 4472 2020-03-24 12:21:00Z Giersch
73	! Additional switch added to activate calculations in flow_statistics for the kolmogorov length
74	! scale
75	!
76	! 4461 2020-03-12 16:51:59Z raasch
77	! +virtual_pe_grid, communicator_configurations
78	!
79	! 4414 2020-02-19 20:16:04Z suehring
80	! - nzb_diff_s_inner, nzb_diff_s_outer, nzb_inner,nzb_outer, nzb_s_inner, nzb_s_outer, nzb_u_inner,
81	! nzb_u_outer, nzb_v_inner, nzb_v_outer, nzb_w_inner, nzb_w_outer
82	!
83	!
84	! 4360 2020-01-07 11:25:50Z suehring
85	! Introduction of wall_flags_total_0, which currently sets bits based on static topography
86	! information used in wall_flags_static_0
87	!
88	! 4340 2019-12-16 08:17:03Z Giersch
89	! Flag for topography closed channel flow with symmetric boundaries introduced
90	!
91	! 4331 2019-12-10 18:25:02Z suehring
92	! - do_output_at_2m, pt_2m_av
93	!
94	! 4329 2019-12-10 15:46:36Z motisi
95	! Renamed wall_flags_0 to wall_flags_static_0
96	!
97	! 4301 2019-11-22 12:09:09Z oliver.maas
98	! removed recycling_yshift
99	!
100	! 4297 2019-11-21 10:37:50Z oliver.maas
101	! changed variable type of recycling_yshift from LOGICAL to INTEGER
102	!
103	! 4293 2019-11-12 14:44:01Z Giersch
104	! Add origin_date_time
105	!
106	! 4146 2019-08-07 07:47:36Z gronemeier
107	! Added rotation_angle
108	!
109	! 4184 2019-08-23 08:07:40Z oliver.maas
110	! changed allocated length of recycling_method_for_thermodynamic_quantities from 20 to 80 characters
111	!
112	! 4183 2019-08-23 07:33:16Z oliver.maas
113	! removed recycle_absolute_quantities and raq
114	! added recycling_method_for_thermodynamic_quantities
115	!
116	! 4182 2019-08-22 15:20:23Z scharf
117	! Corrected "Former revisions" section
118	!
119	! 4173 2019-08-20 12:04:06Z gronemeier
120	! add vdi_internal_controls
121	!
122	! 4172 2019-08-20 11:55:33Z oliver.maas
123	! added recycle_absolute_quantities and raq
124	!
125	! 4168 2019-08-16 13:50:17Z suehring
126	! +topo_top_ind
127	!
128	! 4131 2019-08-02 11:06:18Z monakurppa
129	! Add max_pr_salsa to control_parameters. Used in creating profile output for salsa.
130	!
131	! 4110 2019-07-22 17:05:21Z suehring
132	! -advc_flags_1, advc_flags_2
133	! +advc_flags_m, advc_flags_s
134	!
135	! 4109 2019-07-22 17:00:34Z suehring
136	! remove old_dt
137	!
138	! 4079 2019-07-09 18:04:41Z suehring
139	! + monotonic_limiter_z
140	!
141	! 4069 2019-07-01 14:05:51Z Giersch
142	! Masked output running index mid has been introduced as a local variable to avoid runtime error
143	! (Loop variable has been modified) in time_integration
144	!
145	! 4017 2019-06-06 12:16:46Z schwenkel
146	! increase maximum number of virtual flights
147	!
148	! 3987 2019-05-22 09:52:13Z kanani
149	! Introduce alternative switch for debug output during timestepping
150	!
151	! 3885 2019-04-11 11:29:34Z kanani
152	! Changes related to global restructuring of location messages and introduction of additional debug
153	! messages
154	!
155	! 3871 2019-04-08 14:38:39Z knoop
156	! Initialized parameter region
157	!
158	! 3746 2019-02-16 12:41:27Z gronemeier
159	! Removed most_method
160	!
161	! 3648 2019-01-02 16:35:46Z suehring
162	! -surface_data_output +surface_output
163	!
164	!--------------------------------------------------------------------------------------------------!
165	! Description:
166	! ------------
167	!> Definition of global variables
168	!--------------------------------------------------------------------------------------------------!
169
170
171	!--------------------------------------------------------------------------------------------------!
172	! Description:
173	! ------------
174	!> Definition of variables for special advection schemes.
175	!--------------------------------------------------------------------------------------------------!
176	MODULE advection
177
178	USE kinds
179
180	REAL(wp), DIMENSION(:), ALLOCATABLE :: aex !< exponential coefficient for the Bott-Chlond advection scheme
181	REAL(wp), DIMENSION(:), ALLOCATABLE :: bex !< exponential coefficient for the Bott-Chlond advection scheme
182	REAL(wp), DIMENSION(:), ALLOCATABLE :: dex !< exponential coefficient for the Bott-Chlond advection scheme
183	REAL(wp), DIMENSION(:), ALLOCATABLE :: eex !< exponential coefficient for the Bott-Chlond advection scheme
184
185	SAVE
186
187	END MODULE advection
188
189
190
191	!--------------------------------------------------------------------------------------------------!
192	! Description:
193	! ------------
194	!> The variable in this module is used by multi_agent_system_mod AND netcdf_interface_mod. It must
195	!> be here to avoid circular dependency.
196	!> This is a workaround.
197	!--------------------------------------------------------------------------------------------------!
198	MODULE mas_global_attributes
199
200	USE kinds
201
202	INTEGER(iwp) :: dim_size_agtnum !< size of agent number dimension for netCDF output
203
204	SAVE
205
206	END MODULE mas_global_attributes
207
208
209	!--------------------------------------------------------------------------------------------------!
210	! Description:
211	! ------------
212	!> Definition of all arrays defined on the computational grid.
213	!--------------------------------------------------------------------------------------------------!
214	MODULE arrays_3d
215
216	USE kinds
217
218	REAL(wp), DIMENSION(:), ALLOCATABLE :: c_u_m !< mean phase velocity at outflow for u-component used
219	!< in radiation boundary condition
220	REAL(wp), DIMENSION(:), ALLOCATABLE :: c_u_m_l !< mean phase velocity at outflow for u-component used
221	!< in radiation boundary condition (local subdomain value)
222	REAL(wp), DIMENSION(:), ALLOCATABLE :: c_v_m !< mean phase velocity at outflow for v-component used
223	!< in radiation boundary condition
224	REAL(wp), DIMENSION(:), ALLOCATABLE :: c_v_m_l !< mean phase velocity at outflow for v-component used
225	!< in radiation boundary condition (local subdomain value)
226	REAL(wp), DIMENSION(:), ALLOCATABLE :: c_w_m !< mean phase velocity at outflow for w-component used
227	!< in radiation boundary condition
228	REAL(wp), DIMENSION(:), ALLOCATABLE :: c_w_m_l !< mean phase velocity at outflow for w-component used
229	!< in radiation boundary condition (local subdomain value)
230	REAL(wp), DIMENSION(:), ALLOCATABLE :: d_exner !< ratio of potential and actual temperature
231	REAL(wp), DIMENSION(:), ALLOCATABLE :: ddzu !< 1/dzu
232	REAL(wp), DIMENSION(:), ALLOCATABLE :: ddzu_pres !< modified ddzu for pressure solver
233	REAL(wp), DIMENSION(:), ALLOCATABLE :: dd2zu !< 1/(dzu(k)+dzu(k+1))
234	REAL(wp), DIMENSION(:), ALLOCATABLE :: drho_air !< inverse air density profile on the uv grid
235	REAL(wp), DIMENSION(:), ALLOCATABLE :: drho_air_zw !< inverse air density profile on the w grid
236	REAL(wp), DIMENSION(:), ALLOCATABLE :: dzu !< vertical grid size (u-grid)
237	REAL(wp), DIMENSION(:), ALLOCATABLE :: ddzw !< 1/dzw
238	REAL(wp), DIMENSION(:), ALLOCATABLE :: dzw !< vertical grid size (w-grid)
239	REAL(wp), DIMENSION(:), ALLOCATABLE :: exner !< ratio of actual and potential temperature
240	REAL(wp), DIMENSION(:), ALLOCATABLE :: heatflux_input_conversion !< conversion factor array for heatflux input
241	REAL(wp), DIMENSION(:), ALLOCATABLE :: heatflux_output_conversion !< conversion factor array for heatflux output
242	REAL(wp), DIMENSION(:), ALLOCATABLE :: hyp !< hydrostatic pressure
243	REAL(wp), DIMENSION(:), ALLOCATABLE :: hyrho !< density of air calculated with hydrostatic pressure
244	REAL(wp), DIMENSION(:), ALLOCATABLE :: inflow_damping_factor !< used for turbulent inflow
245	!< (non-cyclic boundary conditions)
246	REAL(wp), DIMENSION(:), ALLOCATABLE :: momentumflux_input_conversion !< conversion factor array for momentumflux input
247	REAL(wp), DIMENSION(:), ALLOCATABLE :: momentumflux_output_conversion !< conversion factor array for momentumflux output
248	REAL(wp), DIMENSION(:), ALLOCATABLE :: ptdf_x !< damping factor for potential temperature in
249	!< x-direction
250	REAL(wp), DIMENSION(:), ALLOCATABLE :: ptdf_y !< damping factor for potential temperature in
251	!< y-direction
252	REAL(wp), DIMENSION(:), ALLOCATABLE :: pt_init !< initial profile of potential temperature
253	REAL(wp), DIMENSION(:), ALLOCATABLE :: q_init !< initial profile of total water mixing ratio
254	!< (or total water content with active cloud physics)
255	REAL(wp), DIMENSION(:), ALLOCATABLE :: rdf !< rayleigh damping factor for velocity components
256	REAL(wp), DIMENSION(:), ALLOCATABLE :: rdf_sc !< rayleigh damping factor for scalar quantities
257	REAL(wp), DIMENSION(:), ALLOCATABLE :: ref_state !< reference state of potential temperature
258	!< (and density in case of ocean simulation)
259	REAL(wp), DIMENSION(:), ALLOCATABLE :: rho_air !< air density profile on the uv grid
260	REAL(wp), DIMENSION(:), ALLOCATABLE :: rho_air_zw !< air density profile on the w grid
261	REAL(wp), DIMENSION(:), ALLOCATABLE :: s_init !< initial profile of passive scalar concentration
262	REAL(wp), DIMENSION(:), ALLOCATABLE :: sa_init !< initial profile of salinity (ocean)
263	REAL(wp), DIMENSION(:), ALLOCATABLE :: ug !< geostrophic wind component in x-direction
264	REAL(wp), DIMENSION(:), ALLOCATABLE :: u_init !< initial profile of horizontal velocity component u
265	REAL(wp), DIMENSION(:), ALLOCATABLE :: u_stokes_zu !< u-component of Stokes drift velocity at zu levels
266	REAL(wp), DIMENSION(:), ALLOCATABLE :: u_stokes_zw !< u-component of Stokes drift velocity at zw levels
267	REAL(wp), DIMENSION(:), ALLOCATABLE :: vg !< geostrophic wind component in y-direction
268	REAL(wp), DIMENSION(:), ALLOCATABLE :: v_init !< initial profile of horizontal velocity component v
269	REAL(wp), DIMENSION(:), ALLOCATABLE :: v_stokes_zu !< v-component of Stokes drift velocity at zu levels
270	REAL(wp), DIMENSION(:), ALLOCATABLE :: v_stokes_zw !< v-component of Stokes drift velocity at zw levels
271	REAL(wp), DIMENSION(:), ALLOCATABLE :: waterflux_input_conversion !< conversion factor array for waterflux input
272	REAL(wp), DIMENSION(:), ALLOCATABLE :: waterflux_output_conversion !< conversion factor array for waterflux output
273	REAL(wp), DIMENSION(:), ALLOCATABLE :: w_subs !< subsidence/ascent velocity
274	REAL(wp), DIMENSION(:), ALLOCATABLE :: x !< horizontal grid coordinate of v-grid (in m)
275	REAL(wp), DIMENSION(:), ALLOCATABLE :: xu !< horizontal grid coordinate of u-grid (in m)
276	REAL(wp), DIMENSION(:), ALLOCATABLE :: y !< horizontal grid coordinate of u-grid (in m)
277	REAL(wp), DIMENSION(:), ALLOCATABLE :: yv !< horizontal grid coordinate of v-grid (in m)
278	REAL(wp), DIMENSION(:), ALLOCATABLE :: zu !< vertical grid coordinate of u-grid (in m)
279	REAL(wp), DIMENSION(:), ALLOCATABLE :: zw !< vertical grid coordinate of w-grid (in m)
280
281
282	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: c_u !< phase speed of u-velocity component
283	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: c_v !< phase speed of v-velocity component
284	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: c_w !< phase speed of w-velocity component
285	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_diss !< artificial numerical dissipation flux at south face of grid
286	!< box - TKE dissipation
287	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_e !< artificial numerical dissipation flux at south face of grid
288	!< box - subgrid-scale TKE
289	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_nc !< artificial numerical dissipation flux at south face of grid
290	!< box - clouddrop-number concentration
291	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_ng !< artificial numerical dissipation flux at south face of grid
292	!< box - graupel number concentration
293	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_ni !< artificial numerical dissipation flux at south face of grid
294	!< box - ice crystal-number concentration
295	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_nr !< artificial numerical dissipation flux at south face of grid
296	!< box - raindrop-number concentration
297	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_ns !< artificial numerical dissipation flux at south face of grid
298	!< box - snow-number concentration
299	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_pt !< artificial numerical dissipation flux at south face of grid
300	!< box - potential temperature
301	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_q !< artificial numerical dissipation flux at south face of grid
302	!< box - total water mixing ratio
303	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_qc !< artificial numerical dissipation flux at south face of grid
304	!< box - cloudwater mixing ratio
305	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_qg !< artificial numerical dissipation flux at south face of grid
306	!< box - graupel mixing ratio
307	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_qi !< artificial numerical dissipation flux at south face of grid
308	!< box - ice crystal mixing ratio
309	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_qr !< artificial numerical dissipation flux at south face of grid
310	!< box - rainwater mixing ratio
311	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_qs !< artificial numerical dissipation flux at south face of grid
312	!< box - snow mixing ratio
313	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_s !< artificial numerical dissipation flux at south face of grid
314	!< box - passive scalar
315	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_sa !< artificial numerical dissipation flux at south face of grid
316	!< box - salinity
317	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_u !< artificial numerical dissipation flux at south face of grid
318	!< box - u-component
319	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_v !< artificial numerical dissipation flux at south face of grid
320	!< box - v-component
321	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: diss_s_w !< artificial numerical dissipation flux at south face of grid
322	!< box - w-component
323	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: dzu_mg !< vertical grid size (u-grid) for multigrid pressure solver
324	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: dzw_mg !< vertical grid size (w-grid) for multigrid pressure solver
325	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_diss !< 6th-order advective flux at south face of grid box -
326	!< TKE dissipation
327	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_e !< 6th-order advective flux at south face of grid box -
328	!< subgrid-scale TKE
329	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_nc !< 6th-order advective flux at south face of grid box -
330	!< clouddrop-number concentration
331	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_ng !< 6th-order advective flux at south face of grid box -
332	!< graupel-number concentration
333	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_ni !< 6th-order advective flux at south face of grid box -
334	!< icecrystal-number concentration
335	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_nr !< 6th-order advective flux at south face of grid box -
336	!< raindrop-number concentration
337	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_ns !< 6th-order advective flux at south face of grid box -
338	!< graupel-number concentration
339	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_pt !< 6th-order advective flux at south face of grid box -
340	!< potential temperature
341	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_q !< 6th-order advective flux at south face of grid box -
342	!< total water mixing ratio
343	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_qc !< 6th-order advective flux at south face of grid box -
344	!< cloudwater mixing ratio
345	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_qg !< 6th-order advective flux at south face of grid box -
346	!< graupel mixing ratio
347	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_qi !< 6th-order advective flux at south face of grid box -
348	!< ice crystal mixing ratio
349	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_qr !< 6th-order advective flux at south face of grid box -
350	!< rainwater mixing ratio
351	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_qs !< 6th-order advective flux at south face of grid box -
352	!< snow mixing ratio
353	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_s !< 6th-order advective flux at south face of grid box -
354	!< passive scalar
355	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_sa !< 6th-order advective flux at south face of grid box -
356	!< salinity
357	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_u !< 6th-order advective flux at south face of grid box -
358	!< u-component
359	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_v !< 6th-order advective flux at south face of grid box -
360	!< v-component
361	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: flux_s_w !< 6th-order advective flux at south face of grid box -
362	!< w-component
363	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: f1_mg !< grid factor used in right hand side of Gauss-Seidel equation
364	!< (multigrid)
365	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: f2_mg !< grid factor used in right hand side of Gauss-Seidel equation
366	!< (multigrid)
367	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: f3_mg !< grid factor used in right hand side of Gauss-Seidel equation
368	!< (multigrid)
369	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: mean_inflow_profiles !< used for turbulent inflow (non-cyclic boundary conditions)
370	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: precipitation_amount !< precipitation amount due to gravitational settling
371	!< (bulk microphysics)
372	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: pt_slope_ref !< potential temperature in rotated coordinate system
373	!< (in case of sloped surface)
374	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: rho_air_mg !< air density profiles on the uv grid for multigrid
375	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: rho_air_zw_mg !< air density profiles on the w grid for multigrid
376	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: total_2d_a !< horizontal array to store the total domain data, used for
377	!< atmosphere-ocean coupling (atmosphere data)
378	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: total_2d_o !< horizontal array to store the total domain data, used for
379	!< atmosphere-ocean coupling (ocean data)
380
381	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: d !< divergence
382	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: de_dx !< gradient of sgs tke in x-direction (lpm)
383	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: de_dy !< gradient of sgs tke in y-direction (lpm)
384	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: de_dz !< gradient of sgs tke in z-direction (lpm)
385	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_diss !< artificial numerical dissipation flux at left face of grid box -
386	!< TKE dissipation
387	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_e !< artificial numerical dissipation flux at left face of grid box -
388	!< subgrid-scale TKE
389	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_nc !< artificial numerical dissipation flux at left face of grid box -
390	!< clouddrop-number concentration
391	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_ng !< artificial numerical dissipation flux at left face of grid box -
392	!< graupel-number concentration
393	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_ni !< artificial numerical dissipation flux at left face of grid box -
394	!< ice crystal-number concentration
395	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_nr !< artificial numerical dissipation flux at left face of grid box -
396	!< raindrop-number concentration
397	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_ns !< artificial numerical dissipation flux at left face of grid box -
398	!< snow-number concentration
399	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_pt !< artificial numerical dissipation flux at left face of grid box -
400	!< potential temperature
401	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_q !< artificial numerical dissipation flux at left face of grid box -
402	!< total water mixing ratio
403	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_qc !< artificial numerical dissipation flux at left face of grid box -
404	!< cloudwater
405	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_qg !< artificial numerical dissipation flux at left face of grid box -
406	!< graupel
407	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_qi !< artificial numerical dissipation flux at left face of grid box -
408	!< ice crystal
409	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_qr !< artificial numerical dissipation flux at left face of grid box -
410	!< rainwater
411	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_qs !< artificial numerical dissipation flux at left face of grid box -
412	!< snow
413	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_s !< artificial numerical dissipation flux at left face of grid box -
414	!< passive scalar
415	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_sa !< artificial numerical dissipation flux at left face of grid box -
416	!< salinity
417	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_u !< artificial numerical dissipation flux at left face of grid box -
418	!< u-component
419	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_v !< artificial numerical dissipation flux at left face of grid box -
420	!< v-component
421	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: diss_l_w !< artificial numerical dissipation flux at left face of grid box -
422	!< w-component
423	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_diss !< 6th-order advective flux at south face of grid box - TKE dissipation
424	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_e !< 6th-order advective flux at south face of grid box - subgrid-scale
425	!< TKE
426	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_nc !< 6th-order advective flux at south face of grid box - clouddrop-number
427	!< concentration
428	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_ng !< 6th-order advective flux at south face of grid box -
429	!< graupel-number concentration
430	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_ni !< 6th-order advective flux at south face of grid box -
431	!< ice crystal-number concentration
432	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_nr !< 6th-order advective flux at south face of grid box - raindrop-number
433	!< concentration
434	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_ns !< 6th-order advective flux at south face of grid box - snow-number concentration
435	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_pt !< 6th-order advective flux at south face of grid box - potential
436	!< temperature
437	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_q !< 6th-order advective flux at south face of grid box - mixing ratio
438	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_qc !< 6th-order advective flux at south face of grid box - cloudwater
439	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_qg !< 6th-order advective flux at south face of grid box - graupel
440	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_qi !< 6th-order advective flux at south face of grid box - ice crystal
441	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_qr !< 6th-order advective flux at south face of grid box - rainwater
442	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_qs !< 6th-order advective flux at south face of grid box - snow
443	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_s !< 6th-order advective flux at south face of grid box - passive scalar
444	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_sa !< 6th-order advective flux at south face of grid box - salinity
445	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_u !< 6th-order advective flux at south face of grid box - u-component
446	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_v !< 6th-order advective flux at south face of grid box - v-component
447	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: flux_l_w !< 6th-order advective flux at south face of grid box - w-component
448	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: kh !< eddy diffusivity for heat
449	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: km !< eddy diffusivity for momentum
450	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: prr !< rain rate
451	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: p_loc !< local array in multigrid/sor solver containing the pressure which is
452	!< iteratively advanced in each iteration step
453	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: tend !< tendency field (time integration)
454	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: tric !< coefficients of the tridiagonal matrix for solution of the Poisson
455	!< equation in Fourier space
456	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: u_m_l !< velocity data (u at left boundary) from time level t-dt required for
457	!< radiation boundary condition
458	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: u_m_n !< velocity data (u at north boundary) from time level t-dt required for
459	!< radiation boundary condition
460	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: u_m_r !< velocity data (u at right boundary) from time level t-dt required for
461	!< radiation boundary condition
462	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: u_m_s !< velocity data (u at south boundary) from time level t-dt required for
463	!< radiation boundary condition
464	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: v_m_l !< velocity data (v at left boundary) from time level t-dt required for
465	!< radiation boundary condition
466	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: v_m_n !< velocity data (v at north boundary) from time level t-dt required for
467	!< radiation boundary condition
468	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: v_m_r !< velocity data (v at right boundary) from time level t-dt required for
469	!< radiation boundary condition
470	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: v_m_s !< velocity data (v at south boundary) from time level t-dt required for
471	!< radiation boundary condition
472	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: w_m_l !< velocity data (w at left boundary) from time level t-dt required for
473	!< radiation boundary condition
474	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: w_m_n !< velocity data (w at north boundary) from time level t-dt required for
475	!< radiation boundary condition
476	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: w_m_r !< velocity data (w at right boundary) from time level t-dt required for
477	!< radiation boundary condition
478	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: w_m_s !< velocity data (w at south boundary) from time level t-dt required for
479	!< radiation boundary condition
480
481	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: diss_1 !< pointer for swapping of timelevels for respective quantity
482	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: diss_2 !< pointer for swapping of timelevels for respective quantity
483	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: diss_3 !< pointer for swapping of timelevels for respective quantity
484	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: e_1 !< pointer for swapping of timelevels for respective quantity
485	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: e_2 !< pointer for swapping of timelevels for respective quantity
486	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: e_3 !< pointer for swapping of timelevels for respective quantity
487	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: p !< pointer: perturbation pressure
488	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: prho_1 !< pointer for swapping of timelevels for respective quantity
489	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nc_1 !< pointer for swapping of timelevels for respective quantity
490	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nc_2 !< pointer for swapping of timelevels for respective quantity
491	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nc_3 !< pointer for swapping of timelevels for respective quantity
492	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ng_1 !< pointer for swapping of timelevels for respective quantity
493	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ng_2 !< pointer for swapping of timelevels for respective quantity
494	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ng_3 !< pointer for swapping of timelevels for respective quantity
495	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ni_1 !< pointer for swapping of timelevels for respective quantity
496	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ni_2 !< pointer for swapping of timelevels for respective quantity
497	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ni_3 !< pointer for swapping of timelevels for respective quantity
498	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nr_1 !< pointer for swapping of timelevels for respective quantity
499	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nr_2 !< pointer for swapping of timelevels for respective quantity
500	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nr_3 !< pointer for swapping of timelevels for respective quantity
501	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ns_1 !< pointer for swapping of timelevels for respective quantity
502	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ns_2 !< pointer for swapping of timelevels for respective quantity
503	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ns_3 !< pointer for swapping of timelevels for respective quantity
504	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: pt_1 !< pointer for swapping of timelevels for respective quantity
505	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: pt_2 !< pointer for swapping of timelevels for respective quantity
506	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: pt_3 !< pointer for swapping of timelevels for respective quantity
507	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: q_1 !< pointer for swapping of timelevels for respective quantity
508	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: q_2 !< pointer for swapping of timelevels for respective quantity
509	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: q_3 !< pointer for swapping of timelevels for respective quantity
510	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qc_1 !< pointer for swapping of timelevels for respective quantity
511	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qc_2 !< pointer for swapping of timelevels for respective quantity
512	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qc_3 !< pointer for swapping of timelevels for respective quantity
513	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qf_1 !< pointer for swapping of timelevels for respective quantity
514	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qg_1 !< pointer for swapping of timelevels for respective quantity
515	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qg_2 !< pointer for swapping of timelevels for respective quantity
516	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qg_3 !< pointer for swapping of timelevels for respective quantity
517	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qi_1 !< pointer for swapping of timelevels for respective quantity
518	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qi_2 !< pointer for swapping of timelevels for respective quantity
519	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qi_3 !< pointer for swapping of timelevels for respective quantity
520	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_v !< pointer: volume of liquid water
521	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_vp !< pointer: liquid water weighting factor
522	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_1 !< pointer for swapping of timelevels for respective quantity
523	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_2 !< pointer for swapping of timelevels for respective quantity
524	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qr_1 !< pointer for swapping of timelevels for respective quantity
525	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qr_2 !< pointer for swapping of timelevels for respective quantity
526	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qr_3 !< pointer for swapping of timelevels for respective quantity
527	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qs_1 !< pointer for swapping of timelevels for respective quantity
528	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qs_2 !< pointer for swapping of timelevels for respective quantity
529	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qs_3 !< pointer for swapping of timelevels for respective quantity
530	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: rho_1 !< pointer for swapping of timelevels for respective quantity
531	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: s_1 !< pointer for swapping of timelevels for respective quantity
532	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: s_2 !< pointer for swapping of timelevels for respective quantity
533	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: s_3 !< pointer for swapping of timelevels for respective quantity
534	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: sa_1 !< pointer for swapping of timelevels for respective quantity
535	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: sa_2 !< pointer for swapping of timelevels for respective quantity
536	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: sa_3 !< pointer for swapping of timelevels for respective quantity
537	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: u_1 !< pointer for swapping of timelevels for respective quantity
538	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: u_2 !< pointer for swapping of timelevels for respective quantity
539	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: u_3 !< pointer for swapping of timelevels for respective quantity
540	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: v_1 !< pointer for swapping of timelevels for respective quantity
541	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: v_2 !< pointer for swapping of timelevels for respective quantity
542	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: v_3 !< pointer for swapping of timelevels for respective quantity
543	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: vpt_1 !< pointer for swapping of timelevels for respective quantity
544	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: w_1 !< pointer for swapping of timelevels for respective quantity
545	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: w_2 !< pointer for swapping of timelevels for respective quantity
546	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: w_3 !< pointer for swapping of timelevels for respective quantity
547
548	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: diss !< pointer: TKE dissipation
549	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: diss_p !< pointer: prognostic value of TKE dissipation
550	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: e !< pointer: subgrid-scale turbulence kinetic energy (sgs tke)
551	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: e_p !< pointer: prognostic value of sgs tke
552	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: nc !< pointer: cloud drop number density
553	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: nc_p !< pointer: prognostic value of cloud drop number density
554	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ng !< pointer: graupel number density
555	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ng_p !< pointer: prognostic value of graupel number density
556	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ni !< pointer: ice crystal number density
557	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ni_p !< pointer: prognostic value of ice crystal number density
558	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: nr !< pointer: rain drop number density
559	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: nr_p !< pointer: prognostic value of rain drop number density
560	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ns !< pointer: snow number density
561	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ns_p !< pointer: prognostic value of snow number density
562	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: prho !< pointer: potential density
563	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: pt !< pointer: potential temperature
564	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: pt_p !< pointer: prognostic value of potential temperature
565	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: q !< pointer: mixing ratio
566	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: q_p !< pointer: prognostic value of mixing ratio
567	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qc !< pointer: cloud water content
568	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qc_p !< pointer: prognostic value cloud water content
569	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qf !< pointer: frozen water content
570	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qg !< pointer: graupel water content
571	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qg_p !< pointer: prognostic value graupel water content
572	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qi !< pointer: ice crystal content
573	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qi_p !< pointer: prognostic value ice crystal content
574	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ql !< pointer: liquid water content
575	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ql_c !< pointer: change in liquid water content due to
576	!< condensation/evaporation during last time step
577	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qr !< pointer: rain water content
578	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qr_p !< pointer: prognostic value of rain water content
579	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qs !< pointer: rain water content
580	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: qs_p !< pointer: prognostic value of rain water content
581	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: rho_ocean !< pointer: density of ocean
582	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: s !< pointer: passive scalar
583	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: s_p !< pointer: prognostic value of passive scalar
584	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: sa !< pointer: ocean salinity
585	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: sa_p !< pointer: prognostic value of ocean salinity
586	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tdiss_m !< pointer: weighted tendency of diss for previous sub-timestep
587	!< (Runge-Kutta)
588	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: te_m !< pointer: weighted tendency of e for previous sub-timestep
589	!< (Runge-Kutta)
590	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tnc_m !< pointer: weighted tendency of nc for previous sub-timestep
591	!< (Runge-Kutta)
592	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tng_m !< pointer: weighted tendency of ng for previous sub-timestep (Runge-Kutta)
593	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tni_m !< pointer: weighted tendency of ni for previous sub-timestep
594	!< (Runge-Kutta)
595	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tnr_m !< pointer: weighted tendency of nr for previous sub-timestep
596	!< (Runge-Kutta)
597	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tns_m !< pointer: weighted tendency of ns for previous sub-timestep (Runge-Kutta)
598	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tpt_m !< pointer: weighted tendency of pt for previous sub-timestep
599	!< (Runge-Kutta)
600	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tq_m !< pointer: weighted tendency of q for previous sub-timestep
601	!< (Runge-Kutta)
602	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tqc_m !< pointer: weighted tendency of qc for previous sub-timestep
603	!< (Runge-Kutta)
604	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tqg_m !< pointer: weighted tendency of qg for previous sub-timestep (Runge-Kutta)
605	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tqi_m !< pointer: weighted tendency of qi for previous sub-timestep
606	!< (Runge-Kutta)
607	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tqr_m !< pointer: weighted tendency of qr for previous sub-timestep
608	!< (Runge-Kutta)
609	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tqs_m !< pointer: weighted tendency of qs for previous sub-timestep (Runge-Kutta)
610	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: ts_m !< pointer: weighted tendency of s for previous sub-timestep
611	!< (Runge-Kutta)
612	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tsa_m !< pointer: weighted tendency of sa for previous sub-timestep
613	!< (Runge-Kutta)
614	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tu_m !< pointer: weighted tendency of u for previous sub-timestep
615	!< (Runge-Kutta)
616	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tv_m !< pointer: weighted tendency of v for previous sub-timestep
617	!< (Runge-Kutta)
618	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: tw_m !< pointer: weighted tendency of w for previous sub-timestep
619	!< (Runge-Kutta)
620	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: u !< pointer: horizontal velocity component u (x-direction)
621	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: u_p !< pointer: prognostic value of u
622	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: v !< pointer: horizontal velocity component v (y-direction)
623	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: v_p !< pointer: prognostic value of v
624	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: vpt !< pointer: virtual potential temperature
625	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: w !< pointer: vertical velocity component w (z-direction)
626	REAL(wp), DIMENSION(:,:,:), POINTER, CONTIGUOUS :: w_p !< pointer: prognostic value of w
627
628	REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE :: tri !< array to hold the tridiagonal matrix for solution of the Poisson
629	!< equation in Fourier space (4th dimension for threads)
630
631	SAVE
632
633	END MODULE arrays_3d
634
635
636	!--------------------------------------------------------------------------------------------------!
637	! Description:
638	! ------------
639	!> Definition of variables needed for time-averaging of 2d/3d data.
640	!--------------------------------------------------------------------------------------------------!
641	MODULE averaging
642
643	USE kinds
644
645	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: ghf_av !< avg. ground heat flux
646	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: lwp_av !< avg. liquid water path
647	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: ol_av !< avg. Obukhov length
648	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: qsurf_av !< avg. surface mixing ratio
649	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: qsws_av !< avg. surface moisture flux
650	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: r_a_av !< avg. resistance
651	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: ssurf_av !< avg. surface passive scalar
652	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: ssws_av !< avg. surface scalar flux
653	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: shf_av !< avg. surface heat flux
654	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: tsurf_av !< avg. surface temperature
655	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: ts_av !< avg. characteristic temperature scale
656	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: us_av !< avg. friction velocity
657	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: z0_av !< avg. roughness length for momentum
658	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: z0h_av !< avg. roughness length for heat
659	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: z0q_av !< avg. roughness length for moisture
660
661	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: diss_av !< avg. tke dissipation rate
662	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: e_av !< avg. subgrid-scale tke
663	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: kh_av !< avg. eddy diffusivity for heat
664	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: km_av !< avg. eddy diffusivity for momentum
665	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: lpt_av !< avg. liquid water potential temperature
666	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nc_av !< avg. cloud drop number density
667	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ng_av !< avg. graupel drop number density
668	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ni_av !< avg. ice crystal number density
669	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: nr_av !< avg. rain drop number density
670	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ns_av !< avg. snow drop number density
671	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: p_av !< avg. perturbation pressure
672	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: pc_av !< avg. particle/droplet concentration
673	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: pr_av !< avg. particle/droplet radius
674	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: prr_av !< avg. precipitation rate
675	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: pt_av !< avg. potential temperature
676	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: q_av !< avg. mixing ratio
677	!< (or total water content with active cloud physics)
678	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qc_av !< avg. cloud water content
679	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qg_av !< avg. graupel water content
680	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qi_av !< avg. ice crystal content
681	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_av !< avg. liquid water content
682	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_c_av !< avg. change in liquid water content due to
683	!< condensation/evaporation during last time step
684	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_v_av !< avg. volume of liquid water
685	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: ql_vp_av !< avg. liquid water weighting factor
686	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qr_av !< avg. rain water content
687	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qs_av !< avg. snow water content
688	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: qv_av !< avg. water vapor content (mixing ratio)
689	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: rho_ocean_av !< avg. ocean density
690	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: s_av !< avg. passive scalar
691	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: sa_av !< avg. salinity
692	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: u_av !< avg. horizontal velocity component u
693	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: v_av !< avg. horizontal velocity component v
694	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: vpt_av !< avg. virtual potential temperature
695	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: w_av !< avg. vertical velocity component
696
697	END MODULE averaging
698
699
700	!--------------------------------------------------------------------------------------------------!
701	! Description:
702	! ------------
703	!> Definition of parameters for program control
704	!--------------------------------------------------------------------------------------------------!
705	MODULE control_parameters
706
707	USE kinds
708
709	TYPE file_status
710	LOGICAL :: opened !< file is currently open
711	LOGICAL :: opened_before !< file is currently closed, but has been openend before
712	END TYPE file_status
713
714	INTEGER(iwp), PARAMETER :: fl_max = 500 !< maximum number of virtual-flight measurements
715	INTEGER, PARAMETER :: mask_xyz_dimension = 100 !< limit of mask dimensions (100 points in each direction)
716	INTEGER, PARAMETER :: max_masks = 50 !< maximum number of masks
717	INTEGER(iwp), PARAMETER :: var_fl_max = 20 !< maximum number of different sampling variables in virtual flight
718	!< measurements
719	INTEGER(iwp), PARAMETER :: varnamelength = 30 !< length of output variable names
720
721	TYPE(file_status), DIMENSION(200+2*max_masks) :: & !< indicates if file is open or if it has been opened before
722	openfile = file_status(.FALSE.,.FALSE.)
723
724	CHARACTER (LEN=1) :: cycle_mg = 'w' !< namelist parameter (see documentation)
725	CHARACTER (LEN=1) :: timestep_reason = ' ' !< 'A'dvection or 'D'iffusion criterion, written to
726	!< RUN_CONTROL file
727	CHARACTER (LEN=5) :: run_zone = ' ' !< time zone of simulation run
728	CHARACTER (LEN=8) :: coupling_char = '' !< appended to filenames in coupled or nested runs
729	!< ('_O': ocean PE,
730	!< '_NV': vertically nested atmosphere PE, '_N##': PE of
731	!< nested domain ##
732	CHARACTER (LEN=8) :: run_time = ' ' !< time of simulation run
733	CHARACTER (LEN=9) :: simulated_time_chr !< simulated time, printed to RUN_CONTROL file
734	CHARACTER (LEN=10) :: run_date = ' ' !< date of simulation run
735	CHARACTER (LEN=11) :: topography_grid_convention = ' ' !< namelist parameter
736	CHARACTER (LEN=12) :: revision = ' ' !< PALM revision number
737	CHARACTER (LEN=12) :: version = ' ' !< PALM version number
738	CHARACTER (LEN=12) :: user_interface_current_revision = ' ' !< revision number of the currently used user-interface
739	!< (must match user_interface_required_revision)
740	CHARACTER (LEN=12) :: user_interface_required_revision = ' ' !< required user-interface revision number
741	CHARACTER (LEN=16) :: conserve_volume_flow_mode = 'default' !< namelist parameter
742	CHARACTER (LEN=16) :: loop_optimization = 'cache' !< namelist parameter
743	CHARACTER (LEN=16) :: momentum_advec = 'ws-scheme' !< namelist parameter
744	CHARACTER (LEN=16) :: psolver = 'poisfft' !< namelist parameter
745	CHARACTER (LEN=16) :: scalar_advec = 'ws-scheme' !< namelist parameter
746	CHARACTER (LEN=20) :: approximation = 'boussinesq' !< namelist parameter
747	CHARACTER (LEN=20) :: bc_e_b = 'neumann' !< namelist parameter
748	CHARACTER (LEN=20) :: bc_lr = 'cyclic' !< namelist parameter
749	CHARACTER (LEN=20) :: bc_ns = 'cyclic' !< namelist parameter
750	CHARACTER (LEN=20) :: bc_p_b = 'neumann' !< namelist parameter
751	CHARACTER (LEN=20) :: bc_p_t = 'dirichlet' !< namelist parameter
752	CHARACTER (LEN=20) :: bc_pt_b = 'dirichlet' !< namelist parameter
753	CHARACTER (LEN=20) :: bc_pt_t = 'initial_gradient' !< namelist parameter
754	CHARACTER (LEN=20) :: bc_q_b = 'dirichlet' !< namelist parameter
755	CHARACTER (LEN=20) :: bc_q_t = 'neumann' !< namelist parameter
756	CHARACTER (LEN=20) :: bc_s_b = 'dirichlet' !< namelist parameter
757	CHARACTER (LEN=20) :: bc_s_t = 'initial_gradient' !< namelist parameter
758	CHARACTER (LEN=20) :: bc_uv_b = 'dirichlet' !< namelist parameter
759	CHARACTER (LEN=20) :: bc_uv_t = 'dirichlet' !< namelist parameter
760	CHARACTER (LEN=20) :: coupling_mode = 'uncoupled' !< coupling mode for atmosphere-ocean coupling
761	CHARACTER (LEN=20) :: coupling_mode_remote = 'uncoupled' !< coupling mode of the remote process in case of coupled
762	!< atmosphere-ocean runs
763	CHARACTER (LEN=20) :: dissipation_1d = 'detering' !< namelist parameter
764	CHARACTER (LEN=20) :: fft_method = 'temperton-algorithm' !< namelist parameter
765	CHARACTER (LEN=20) :: mixing_length_1d = 'blackadar' !< namelist parameter
766	CHARACTER (LEN=20) :: random_generator = 'random-parallel' !< namelist parameter
767	CHARACTER (LEN=20) :: reference_state = 'initial_profile' !< namelist parameter
768	CHARACTER (LEN=20) :: restart_data_format = 'fortran_binary' !< namelist parameter
769	CHARACTER (LEN=20) :: restart_data_format_input = 'undefined' !< namelist parameter
770	CHARACTER (LEN=20) :: restart_data_format_output = 'undefined' !< namelist parameter
771	CHARACTER (LEN=20) :: timestep_scheme = 'runge-kutta-3' !< namelist parameter
772	CHARACTER (LEN=20) :: turbulence_closure = '1.5-order' !< namelist parameter
773	CHARACTER (LEN=23) :: origin_date_time = '2019-06-21 12:00:00 +00' !< date and time to be simulated
774	CHARACTER (LEN=40) :: flux_input_mode = 'approximation-specific' !< type of flux input: dynamic or kinematic
775	CHARACTER (LEN=40) :: flux_output_mode = 'approximation-specific' !< type of flux output: dynamic or kinematic
776	CHARACTER (LEN=40) :: topography = 'flat' !< namelist parameter
777	CHARACTER (LEN=64) :: host = '????' !< configuration identifier as given by palmrun option -c,
778	!< ENVPAR namelist parameter provided by palmrun
779	CHARACTER (LEN=80) :: log_message !< user-defined message for debugging (sse data_log.f90)
780	CHARACTER (LEN=80) :: recycling_method_for_thermodynamic_quantities = 'turbulent_fluctuation' !< namelist parameter
781	CHARACTER (LEN=80) :: run_identifier !< run identifier as given by palmrun option -r, ENVPAR
782	!< namelist parameter provided by palmrun
783	CHARACTER (LEN=100) :: initializing_actions = ' ' !< namelist parameter
784	CHARACTER (LEN=100) :: restart_string = ' ' !< for storing strings in case of writing/reading restart
785	!< data
786	CHARACTER (LEN=210) :: run_description_header !< string containing diverse run informations as run
787	!< identifier, coupling mode, host, ensemble number, run
788	!< date and time
789	CHARACTER (LEN=1000) :: debug_string = ' ' !<.....
790	CHARACTER (LEN=1000) :: message_string = ' ' !< dynamic string for error message output
791
792	CHARACTER (LEN=varnamelength), DIMENSION(200) :: data_output_pr_user = ' ' !< namelist parameter
793	CHARACTER (LEN=varnamelength), DIMENSION(300) :: data_output_pr = ' ' !< namelist parameter
794	CHARACTER (LEN=varnamelength), DIMENSION(500) :: data_output = ' ' !< namelist parameter
795	CHARACTER (LEN=varnamelength), DIMENSION(500) :: data_output_user = ' ' !< namelist parameter
796	CHARACTER (LEN=varnamelength), DIMENSION(500) :: doav = ' ' !< label array for multi-dimensional,
797	!< averaged output quantities
798
799	CHARACTER (LEN=varnamelength), DIMENSION(max_masks,100) :: data_output_masks = ' ' !< namelist parameter
800	CHARACTER (LEN=varnamelength), DIMENSION(max_masks,100) :: data_output_masks_user = ' ' !< namelist parameter
801	CHARACTER (LEN=varnamelength), DIMENSION(0:1,500) :: do2d = ' ' !< label array for 2d output
802	!< quantities
803	CHARACTER (LEN=varnamelength), DIMENSION(0:1,500) :: do3d = ' ' !< label array for 3d output
804	!< quantities
805
806	CHARACTER (LEN=varnamelength), DIMENSION(max_masks,0:1,100) :: domask = ' ' !< label array for multi-dimensional,
807	!< masked output quantities
808
809	INTEGER(iwp) :: abort_mode = 1 !< abort condition (nested runs)
810	INTEGER(iwp) :: agt_time_count = 0 !< number of output intervals for agent data output
811	INTEGER(iwp) :: average_count_pr = 0 !< number of samples in vertical-profile output
812	INTEGER(iwp) :: average_count_3d = 0 !< number of samples in 3d output
813	INTEGER(iwp) :: current_timestep_number = 0 !< current timestep number, printed to RUN_CONTROL file
814	INTEGER(iwp) :: coupling_topology = 0 !< switch for atmosphere-ocean-coupling: 0: same number of grid points and
815	!< PEs along x and y in atmosphere and ocean, otherwise 1
816	INTEGER(iwp) :: dist_range = 0 !< switch for steering the horizontal disturbance range, 1: inflow
817	!< disturbances in case of non-cyclic horizontal BC, 0: otherwise
818	INTEGER(iwp) :: disturbance_level_ind_b !< lowest grid index where flow disturbance is applied
819	INTEGER(iwp) :: disturbance_level_ind_t !< highest grid index where flow disturbance is applied
820	INTEGER(iwp) :: doav_n = 0 !< number of 2d/3d output quantities subject to time averaging
821	INTEGER(iwp) :: dopr_n = 0 !< number of profile output quantities subject to time averaging
822	INTEGER(iwp) :: dopr_time_count = 0 !< number of output intervals for profile output
823	INTEGER(iwp) :: dopts_time_count = 0 !< number of output intervals for particle data timeseries
824	INTEGER(iwp) :: dots_time_count = 0 !< number of output intervals for timeseries output
825	INTEGER(iwp) :: dp_level_ind_b = 0 !< lowest grid index for external pressure gradient forcing
826	INTEGER(iwp) :: ensemble_member_nr = 0 !< namelist parameter
827	INTEGER(iwp) :: gamma_mg !< switch for steering the multigrid cycle: 1: v-cycle, 2: w-cycle
828	INTEGER(iwp) :: gathered_size !< number of total domain grid points of the grid level which is gathered on
829	!< PE0 (multigrid solver)
830	INTEGER(iwp) :: grid_level !< current grid level handled in the multigrid solver
831	INTEGER(iwp) :: ibc_e_b !< integer flag for bc_e_b
832	INTEGER(iwp) :: ibc_p_b !< integer flag for bc_p_b
833	INTEGER(iwp) :: ibc_p_t !< integer flag for bc_p_t
834	INTEGER(iwp) :: ibc_pt_b !< integer flag for bc_pt_b
835	INTEGER(iwp) :: ibc_pt_t !< integer flag for bc_pt_t
836	INTEGER(iwp) :: ibc_q_b !< integer flag for bc_q_b
837	INTEGER(iwp) :: ibc_q_t !< integer flag for bc_q_t
838	INTEGER(iwp) :: ibc_s_b !< integer flag for bc_s_b
839	INTEGER(iwp) :: ibc_s_t !< integer flag for bc_s_t
840	INTEGER(iwp) :: ibc_uv_b !< integer flag for bc_uv_b
841	INTEGER(iwp) :: ibc_uv_t !< integer flag for bc_uv_t
842	INTEGER(iwp) :: inflow_disturbance_begin = -1 !< namelist parameter
843	INTEGER(iwp) :: inflow_disturbance_end = -1 !< namelist parameter
844	INTEGER(iwp) :: intermediate_timestep_count !< number of current Runge-Kutta substep
845	INTEGER(iwp) :: intermediate_timestep_count_max !< maximum number of Runge-Kutta substeps
846	INTEGER(iwp) :: io_group = 0 !< I/O group to which the PE belongs (= #PE / io_blocks)
847	INTEGER(iwp) :: io_blocks = 1 !< number of blocks for which I/O is done in sequence (total number of PEs /
848	!< maximum_parallel_io_streams)
849	INTEGER(iwp) :: iran = -1234567 !< integer random number used for flow disturbances
850	INTEGER(iwp) :: length = 0 !< integer that specifies the length of a string in case of writing/reading
851	!< restart data
852	INTEGER(iwp) :: masks = 0 !< counter for number of masked output quantities
853	INTEGER(iwp) :: maximum_grid_level !< number of grid levels that the multigrid solver is using
854	INTEGER(iwp) :: maximum_parallel_io_streams = -1 !< maximum number of parallel io streams that the underlying parallel file
855	!< system allows, set with palmrun option -w, ENVPAR namelist parameter, provided by palmrun
856	INTEGER(iwp) :: max_pr_salsa = 0 !< number of salsa profiles (must not change within a job chain)
857	INTEGER(iwp) :: max_pr_user = 0 !< number of user-defined profiles (must not change within a job chain)
858	INTEGER(iwp) :: max_pr_user_tmp = 0 !< number of user-defined profiles that is temporary stored to check it
859	!< against max_pr_user in case of restarts
860	INTEGER(iwp) :: mgcycles = 0 !< number of multigrid cycles that the multigrid solver has actually carried
861	!< out
862	INTEGER(iwp) :: mg_cycles = 4 !< namelist parameter
863	INTEGER(iwp) :: mg_switch_to_pe0_level = -1 !< namelist parameter
864	INTEGER(iwp) :: ngsrb = 2 !< namelist parameter
865	INTEGER(iwp) :: nr_timesteps_this_run = 0 !< number of timesteps (cpu time measurements)
866	INTEGER(iwp) :: nsor = 20 !< namelist parameter
867	INTEGER(iwp) :: nsor_ini = 100 !< namelist parameter
868	INTEGER(iwp) :: n_sor !< number of iterations to be used in SOR-scheme
869	INTEGER(iwp) :: normalizing_region = 0 !< namelist parameter
870	INTEGER(iwp) :: num_mean_inflow_profiles = 7 !< number of mean inflow profiles in case of turbulent inflow
871	INTEGER(iwp) :: num_leg=0 !< number of different legs in virtual flight measurements
872	INTEGER(iwp) :: num_var_fl !< number of sampling/output variables in virtual flight measurements
873	INTEGER(iwp) :: num_var_fl_user=0 !< number of user-defined sampling/output variables in virtual flight
874	!< measurements
875	INTEGER(iwp) :: number_stretch_level_start !< number of user-specified start levels for stretching
876	INTEGER(iwp) :: number_stretch_level_end !< number of user-specified end levels for stretching
877	INTEGER(iwp) :: nz_do3d = -9999 !< namelist parameter
878	INTEGER(iwp) :: prt_time_count = 0 !< number of output intervals for particle data output
879	INTEGER(iwp) :: recycling_plane !< position of recycling plane along x (in grid points) in case of turbulence
880	!< recycling
881	INTEGER(iwp) :: runnr = 0 !< number of run in job chain
882	INTEGER(iwp) :: subdomain_size !< number of grid points in (3d) subdomain including ghost points
883	INTEGER(iwp) :: symmetry_flag = 0 !< flag for sterring the symmetric behavior of the bottom and top boundary
884	INTEGER(iwp) :: terminate_coupled = 0 !< switch for steering termination in case of coupled runs
885	INTEGER(iwp) :: terminate_coupled_remote = 0 !< switch for steering termination in case of coupled runs (condition of the
886	!< remote model)
887	INTEGER(iwp) :: timestep_count = 0 !< number of timesteps carried out since the beginning of the initial run
888	INTEGER(iwp) :: y_shift = 0 !< namelist parameter
889
890	INTEGER(iwp) :: dist_nxl(0:1) !< left boundary of disturbance region
891	INTEGER(iwp) :: dist_nxr(0:1) !< right boundary of disturbance region
892	INTEGER(iwp) :: dist_nyn(0:1) !< north boundary of disturbance region
893	INTEGER(iwp) :: dist_nys(0:1) !< south boundary of disturbance region
894	INTEGER(iwp) :: do2d_no(0:1) = 0 !< number of 2d output quantities
895	INTEGER(iwp) :: do2d_xy_time_count(0:1) = 0 !< number of output intervals for 2d data (xy)
896	INTEGER(iwp) :: do2d_xz_time_count(0:1) = 0 !< number of output intervals for 2d data (xz)
897	INTEGER(iwp) :: do2d_yz_time_count(0:1) = 0 !< number of output intervals for 2d data (yz)
898	INTEGER(iwp) :: do3d_no(0:1) = 0 !< number of 3d output quantities
899	INTEGER(iwp) :: do3d_time_count(0:1) = 0 !< number of output intervals for 3d data
900	INTEGER(iwp) :: domask_no(max_masks,0:1) = 0 !< number of masked output quantities
901	INTEGER(iwp) :: domask_time_count(max_masks,0:1) !< number of output intervals for masked data
902	INTEGER(iwp) :: dz_stretch_level_end_index(9) !< vertical grid level index until which the vertical grid spacing
903	!< is stretched
904	INTEGER(iwp) :: dz_stretch_level_start_index(9) !< vertical grid level index above which the vertical grid spacing
905	!< is stretched
906	INTEGER(iwp) :: mask_size(max_masks,3) = -1 !< size of mask array per mask and dimension (for netcdf output)
907	INTEGER(iwp) :: mask_size_l(max_masks,3) = -1 !< subdomain size of mask array per mask and dimension
908	!< (for netcdf output)
909	INTEGER(iwp) :: mask_start_l(max_masks,3) = -1 !< subdomain start index of mask array (for netcdf output)
910	INTEGER(iwp) :: pt_vertical_gradient_level_ind(10) = -9999 !< grid index values of pt_vertical_gradient_level(s)
911	INTEGER(iwp) :: q_vertical_gradient_level_ind(10) = -9999 !< grid index values of q_vertical_gradient_level(s)
912	INTEGER(iwp) :: s_vertical_gradient_level_ind(10) = -9999 !< grid index values of s_vertical_gradient_level(s)
913	INTEGER(iwp) :: section(100,3) !< collective array for section_xy/xz/yz
914	INTEGER(iwp) :: section_xy(100) = -9999 !< namelist parameter
915	INTEGER(iwp) :: section_xz(100) = -9999 !< namelist parameter
916	INTEGER(iwp) :: section_yz(100) = -9999 !< namelist parameter
917	INTEGER(iwp) :: ug_vertical_gradient_level_ind(10) = -9999 !< grid index values of ug_vertical_gradient_level(s)
918	INTEGER(iwp) :: vg_vertical_gradient_level_ind(10) = -9999 !< grid index values of vg_vertical_gradient_level(s)
919	INTEGER(iwp) :: subs_vertical_gradient_level_i(10) = -9999 !< grid index values of subs_vertical_gradient_level(s)
920	INTEGER(iwp), DIMENSION(0:1) :: ntdim_2d_xy !< number of output intervals for 2d data (xy)
921	INTEGER(iwp), DIMENSION(0:1) :: ntdim_2d_xz !< number of output intervals for 2d data (xz)
922	INTEGER(iwp), DIMENSION(0:1) :: ntdim_2d_yz !< number of output intervals for 2d data (yz)
923	INTEGER(iwp), DIMENSION(0:1) :: ntdim_3d !< number of output intervals for 3d data
924
925	INTEGER(iwp), DIMENSION(max_masks,mask_xyz_dimension) :: mask_k_over_surface = -1 !< namelist parameter, k index of height
926	!<over surface
927
928	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: grid_level_count !< internal switch for steering the multigrid v- and w-cycles
929
930	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: mask_i !< subdomain grid index of masked output point on x-dimension
931	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: mask_j !< subdomain grid index of masked output point on y-dimension
932	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: mask_k !< subdomain grid index of masked output point on z-dimension
933	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: mask_i_global !< global grid index of masked output point on x-dimension
934	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: mask_j_global !< global grid index of masked output point on y-dimension
935	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: mask_k_global !< global grid index of masked output point on z-dimension
936
937
938	LOGICAL :: agent_time_unlimited = .FALSE. !< namelist parameter
939	LOGICAL :: air_chemistry = .FALSE. !< chemistry model switch
940	LOGICAL :: bc_dirichlet_l = .FALSE. !< flag indicating dirichlet boundary condition on left model
941	!< boundary
942	LOGICAL :: bc_dirichlet_n = .FALSE. !< flag indicating dirichlet boundary condition on north model
943	!< boundary
944	LOGICAL :: bc_dirichlet_r = .FALSE. !< flag indicating dirichlet boundary condition on right model
945	!< boundary
946	LOGICAL :: bc_dirichlet_s = .FALSE. !< flag indicating dirichlet boundary condition on south model
947	!< boundary
948	LOGICAL :: bc_lr_cyc =.TRUE. !< left-right boundary condition cyclic?
949	LOGICAL :: bc_lr_dirrad = .FALSE. !< left-right boundary condition dirichlet/radiation?
950	LOGICAL :: bc_lr_raddir = .FALSE. !< left-right boundary condition radiation/dirichlet?
951	LOGICAL :: bc_ns_cyc = .TRUE. !< north-south boundary condition cyclic?
952	LOGICAL :: bc_ns_dirrad = .FALSE. !< north-south boundary condition dirichlet/radiation?
953	LOGICAL :: bc_ns_raddir = .FALSE. !< north-south boundary condition radiation/dirichlet?
954	LOGICAL :: bc_radiation_l = .FALSE. !< radiation boundary condition for outflow at left domain boundary
955	LOGICAL :: bc_radiation_n = .FALSE. !< radiation boundary condition for outflow at north domain
956	!< boundary
957	LOGICAL :: bc_radiation_r = .FALSE. !< radiation boundary condition for outflow at right domain
958	!< boundary
959	LOGICAL :: bc_radiation_s = .FALSE. !< radiation boundary condition for outflow at south domain
960	!< boundary
961	LOGICAL :: biometeorology = .FALSE. !< biometeorology module switch
962	LOGICAL :: calc_soil_moisture_during_spinup = .FALSE. !< namelist parameter
963	LOGICAL :: call_psolver_at_all_substeps = .TRUE. !< namelist parameter
964	LOGICAL :: check_realistic_q = .TRUE. !< namelist parameter
965	LOGICAL :: child_domain = .FALSE. !< flag indicating that model is nested in a parent domain
966	LOGICAL :: cloud_droplets = .FALSE. !< namelist parameter
967	LOGICAL :: complex_terrain = .FALSE. !< namelist parameter
968	LOGICAL :: conserve_volume_flow = .FALSE. !< namelist parameter
969	LOGICAL :: constant_diffusion = .FALSE. !< diffusion coefficient constant?
970	LOGICAL :: constant_flux_layer = .TRUE. !< namelist parameter
971	LOGICAL :: constant_heatflux = .TRUE. !< heat flux at all surfaces constant?
972	LOGICAL :: constant_top_heatflux = .TRUE. !< heat flux at domain top constant?
973	LOGICAL :: constant_top_momentumflux = .FALSE. !< momentum flux at domain topconstant?
974	LOGICAL :: constant_top_salinityflux = .TRUE. !< constant salinity flux at ocean surface
975	LOGICAL :: constant_top_scalarflux = .TRUE. !< passive-scalar flux at domain top constant?
976	LOGICAL :: constant_scalarflux = .TRUE. !< passive-scalar flux at surfaces constant?
977	LOGICAL :: constant_waterflux = .TRUE. !< water flux at all surfaces constant?
978	LOGICAL :: create_disturbances = .TRUE. !< namelist parameter
979	LOGICAL :: data_output_during_spinup = .FALSE. !< namelist parameter
980	LOGICAL :: data_output_2d_on_each_pe = .TRUE. !< namelist parameter
981	LOGICAL :: debug_output = .FALSE. !< namelist parameter
982	LOGICAL :: debug_output_timestep = .FALSE. !< namelist parameter
983	LOGICAL :: disturbance_created = .FALSE. !< flow disturbance imposed?
984	LOGICAL :: do2d_at_begin = .FALSE. !< namelist parameter
985	LOGICAL :: do3d_at_begin = .FALSE. !< namelist parameter
986	LOGICAL :: do_sum = .FALSE. !< contribute to time average of profile data?
987	LOGICAL :: dp_external = .FALSE. !< namelist parameter
988	LOGICAL :: dp_smooth = .FALSE. !< namelist parameter
989	LOGICAL :: dt_fixed = .FALSE. !< fixed timestep (namelist parameter dt set)?
990	LOGICAL :: dt_3d_reached !< internal timestep for particle advection
991	LOGICAL :: dt_3d_reached_l !< internal timestep for particle advection
992	LOGICAL :: first_call_lpm = .TRUE. !< call lpm only once per timestep?
993	LOGICAL :: first_call_mas = .TRUE. !< call mas only once per timestep
994	LOGICAL :: force_print_header = .FALSE. !< namelist parameter
995	LOGICAL :: galilei_transformation = .FALSE. !< namelist parameter
996	LOGICAL :: humidity = .FALSE. !< namelist parameter
997	LOGICAL :: humidity_remote = .FALSE. !< switch for receiving near-surface humidity flux
998	!< (atmosphere-ocean coupling)
999	LOGICAL :: include_total_domain_boundaries = .FALSE. !< store outer boundaries in restart file (MPI-IO)
1000	LOGICAL :: indoor_model = .FALSE. !< switch for indoor-climate and energy-demand model
1001	LOGICAL :: kolmogorov_length_scale = .FALSE. !< switch to activate calculations in flow_statistics for the
1002	!< kolmogorov length scale
1003	LOGICAL :: large_scale_forcing = .FALSE. !< namelist parameter
1004	LOGICAL :: large_scale_subsidence = .FALSE. !< namelist parameter
1005	LOGICAL :: land_surface = .FALSE. !< use land surface model?
1006	LOGICAL :: les_dai = .FALSE. !< use Dai et al. turbulence closure (modified 1.5-order closure)
1007	!< for LES mode. Shall replace the default 1.5-order closure
1008	LOGICAL :: les_dynamic = .FALSE. !< use dynamic subgrid model as turbulence closure for LES mode
1009	LOGICAL :: les_default = .FALSE. !< use 1.5-order default turbulence closure for LES mode
1010	LOGICAL :: lsf_exception = .FALSE. !< use of lsf with buildings (temporary)?
1011	LOGICAL :: lsf_surf = .TRUE. !< use surface forcing (large scale forcing)?
1012	LOGICAL :: lsf_vert = .TRUE. !< use atmospheric forcing (large scale forcing)?
1013	LOGICAL :: masking_method = .FALSE. !< namelist parameter
1014	LOGICAL :: mg_switch_to_pe0 = .FALSE. !< internal multigrid switch for steering the ghost point exchange
1015	!< in case that data has been collected on PE0
1016	LOGICAL :: monotonic_limiter_z = .FALSE. !< use monotonic flux limiter for vertical scalar advection
1017	LOGICAL :: nesting_offline = .FALSE. !< flag controlling offline nesting in COSMO model
1018	LOGICAL :: neutral = .FALSE. !< namelist parameter
1019	LOGICAL :: nudging = .FALSE. !< namelist parameter
1020	LOGICAL :: ocean_mode = .FALSE. !< namelist parameter
1021	LOGICAL :: passive_scalar = .FALSE. !< namelist parameter
1022	LOGICAL :: plant_canopy = .FALSE. !< switch for use of plant canopy model
1023	LOGICAL :: random_heatflux = .FALSE. !< namelist parameter
1024	LOGICAL :: rans_mode = .FALSE. !< switch between RANS and LES mode
1025	LOGICAL :: rans_tke_e = .FALSE. !< use TKE-e turbulence closure for RANS mode
1026	LOGICAL :: rans_tke_l = .FALSE. !< use TKE-l turbulence closure for RANS mode
1027	LOGICAL :: read_svf = .FALSE. !< ENVPAR namelist parameter to steer input of svf
1028	!< (ENVPAR is provided by palmrun)
1029	LOGICAL :: run_control_header = .FALSE. !< onetime output of RUN_CONTROL header
1030	LOGICAL :: run_coupled = .TRUE. !< internal switch telling PALM to run in coupled mode
1031	!< (i.e. to exchange surface data) in case of atmosphere-ocean coupling
1032	LOGICAL :: salsa = .FALSE. !< switch for the sectional aerosol module salsa
1033	LOGICAL :: scalar_rayleigh_damping = .TRUE. !< namelist parameter
1034	LOGICAL :: sloping_surface = .FALSE. !< use sloped surface? (namelist parameter alpha_surface)
1035	LOGICAL :: spinup = .FALSE. !< perform model spinup without atmosphere code?
1036	LOGICAL :: surface_output = .FALSE. !< output of surface data
1037	LOGICAL :: stop_dt = .FALSE. !< internal switch to stop the time stepping
1038	LOGICAL :: synchronous_exchange = .FALSE. !< namelist parameter
1039	LOGICAL :: syn_turb_gen = .FALSE. !< flag for synthetic turbulence generator module
1040	LOGICAL :: terminate_run = .FALSE. !< terminate run (cpu-time limit, restarts)?
1041	LOGICAL :: topo_no_distinct = .FALSE. !< flag controlling classification of topography surfaces
1042	LOGICAL :: transpose_compute_overlap = .FALSE. !< namelist parameter
1043	LOGICAL :: turbulent_inflow = .FALSE. !< namelist parameter
1044	LOGICAL :: turbulent_outflow = .FALSE. !< namelist parameter
1045	LOGICAL :: urban_surface = .FALSE. !< use urban surface model?
1046	LOGICAL :: use_cmax = .TRUE. !< namelist parameter
1047	LOGICAL :: use_fixed_date = .FALSE. !< date of simulation does not change (namelist parameter)
1048	LOGICAL :: use_fixed_time = .FALSE. !< time of simulation does not change (namelist parameter)
1049	LOGICAL :: use_free_convection_scaling = .FALSE. !< namelist parameter to switch on free convection velocity scale
1050	!< in calculation of horizontal wind speed (surface_layer_fluxes)
1051	LOGICAL :: use_initial_profile_as_reference = .FALSE. !< use of initial profiles as reference state?
1052	LOGICAL :: use_prescribed_profile_data = .FALSE. !< use of prescribed wind profiles?
1053	!< (namelist parameters u_profile, v_profile)
1054	LOGICAL :: use_single_reference_value = .FALSE. !< use of single value as reference state?
1055	LOGICAL :: use_subsidence_tendencies = .FALSE. !< namelist parameter
1056	LOGICAL :: use_surface_fluxes = .FALSE. !< namelist parameter
1057	LOGICAL :: use_top_fluxes = .FALSE. !< namelist parameter
1058	LOGICAL :: use_ug_for_galilei_tr = .TRUE. !< namelist parameter
1059	LOGICAL :: use_upstream_for_tke = .FALSE. !< namelist parameter
1060	LOGICAL :: vdi_checks = .FALSE. !< do internal controls after VDI 3783 Part 9
1061	LOGICAL :: virtual_flight = .FALSE. !< use virtual flight model
1062	LOGICAL :: virtual_measurement = .FALSE. !< control parameter to switch-on virtual measurements
1063	LOGICAL :: wall_adjustment = .TRUE. !< namelist parameter
1064	LOGICAL :: wind_turbine = .FALSE. !< flag for use of wind turbine model
1065	LOGICAL :: write_binary = .FALSE. !< ENVPAR namelist parameter to steer restart I/O
1066	!< (ENVPAR is provided by palmrun)
1067	LOGICAL :: write_svf = .FALSE. !< ENVPAR namelist parameter to steer output of svf
1068	!< (ENVPAR is provided by palmrun)
1069	LOGICAL :: ws_scheme_sca = .FALSE. !< use Wicker-Skamarock scheme (scalar advection)?
1070	LOGICAL :: ws_scheme_mom = .FALSE. !< use Wicker-Skamarock scheme (momentum advection)?
1071
1072	LOGICAL :: data_output_xy(0:1) = .FALSE. !< output of xy cross-section data?
1073	LOGICAL :: data_output_xz(0:1) = .FALSE. !< output of xz cross-section data?
1074	LOGICAL :: data_output_yz(0:1) = .FALSE. !< output of yz cross-section data?
1075
1076	LOGICAL, DIMENSION(max_masks) :: mask_surface = .FALSE. !< flag for surface-following masked output
1077
1078	REAL(wp) :: advected_distance_x = 0.0_wp !< advected distance of model domain along x
1079	!< (galilei transformation)
1080	REAL(wp) :: advected_distance_y = 0.0_wp !< advected distance of model domain along y
1081	!< (galilei transformation)
1082	REAL(wp) :: alpha_surface = 0.0_wp !< namelist parameter
1083	REAL(wp) :: atmos_ocean_sign = 1.0_wp !< vertical-grid conversion factor
1084	!< (=1.0 in atmosphere, =-1.0 in ocean)
1085	REAL(wp) :: averaging_interval = 0.0_wp !< namelist parameter
1086	REAL(wp) :: averaging_interval_pr = 9999999.9_wp !< namelist parameter
1087	REAL(wp) :: bc_pt_t_val !< vertical gradient of pt near domain top
1088	REAL(wp) :: bc_q_t_val !< vertical gradient of humidity near domain top
1089	REAL(wp) :: bc_s_t_val !< vertical gradient of passive scalar near domain top
1090	REAL(wp) :: bottom_salinityflux = 0.0_wp !< namelist parameter
1091	REAL(wp) :: building_height = 50.0_wp !< namelist parameter
1092	REAL(wp) :: building_length_x = 50.0_wp !< namelist parameter
1093	REAL(wp) :: building_length_y = 50.0_wp !< namelist parameter
1094	REAL(wp) :: building_wall_left = 9999999.9_wp !< namelist parameter
1095	REAL(wp) :: building_wall_south = 9999999.9_wp !< namelist parameter
1096	REAL(wp) :: canyon_height = 50.0_wp !< namelist parameter
1097	REAL(wp) :: canyon_width_x = 9999999.9_wp !< namelist parameter
1098	REAL(wp) :: canyon_width_y = 9999999.9_wp !< namelist parameter
1099	REAL(wp) :: canyon_wall_left = 9999999.9_wp !< namelist parameter
1100	REAL(wp) :: canyon_wall_south = 9999999.9_wp !< namelist parameter
1101	REAL(wp) :: cfl_factor = -1.0_wp !< namelist parameter
1102	REAL(wp) :: cos_alpha_surface !< cosine of alpha_surface
1103	REAL(wp) :: coupling_start_time = 0.0_wp !< namelist parameter
1104	REAL(wp) :: days_since_reference_point = 0.0_wp !< days after atmosphere-ocean coupling has been activated,
1105	!< or after spinup phase of LSM has been finished
1106	REAL(wp) :: disturbance_amplitude = 0.25_wp !< namelist parameter
1107	REAL(wp) :: disturbance_energy_limit = 0.01_wp !< namelist parameter
1108	REAL(wp) :: disturbance_level_b = -9999999.9_wp !< namelist parameter
1109	REAL(wp) :: disturbance_level_t = -9999999.9_wp !< namelist parameter
1110	REAL(wp) :: dp_level_b = 0.0_wp !< namelist parameter
1111	REAL(wp) :: dt = -1.0_wp !< namelist parameter
1112	REAL(wp) :: dt_averaging_input = 0.0_wp !< namelist parameter
1113	REAL(wp) :: dt_averaging_input_pr = 9999999.9_wp !< namelist parameter
1114	REAL(wp) :: dt_coupling = 9999999.9_wp !< namelist parameter
1115	REAL(wp) :: dt_data_output = 9999999.9_wp !< namelist parameter
1116	REAL(wp) :: dt_data_output_av = 9999999.9_wp !< namelist parameter
1117	REAL(wp) :: dt_disturb = 9999999.9_wp !< namelist parameter
1118	REAL(wp) :: dt_dopr = 9999999.9_wp !< namelist parameter
1119	REAL(wp) :: dt_dopr_listing = 9999999.9_wp !< namelist parameter
1120	REAL(wp) :: dt_dopts = 9999999.9_wp !< namelist parameter
1121	REAL(wp) :: dt_dots = 9999999.9_wp !< namelist parameter
1122	REAL(wp) :: dt_do2d_xy = 9999999.9_wp !< namelist parameter
1123	REAL(wp) :: dt_do2d_xz = 9999999.9_wp !< namelist parameter
1124	REAL(wp) :: dt_do2d_yz = 9999999.9_wp !< namelist parameter
1125	REAL(wp) :: dt_do3d = 9999999.9_wp !< namelist parameter
1126	REAL(wp) :: dt_max = 20.0_wp !< namelist parameter
1127	REAL(wp) :: dt_restart = 9999999.9_wp !< namelist parameter
1128	REAL(wp) :: dt_run_control = 60.0_wp !< namelist parameter
1129	REAL(wp) :: dt_spinup = 5.0_wp !< namelist parameter
1130	REAL(wp) :: dt_write_agent_data = 9999999.9_wp !< namelist parameter
1131	REAL(wp) :: dt_3d = 0.01_wp !< time step
1132	REAL(wp) :: dz_max = 999.0_wp !< namelist parameter
1133	REAL(wp) :: dz_stretch_factor = 1.08_wp !< namelist parameter
1134	REAL(wp) :: dz_stretch_level = -9999999.9_wp !< namelist parameter
1135	REAL(wp) :: e_init = 0.0_wp !< namelist parameter
1136	REAL(wp) :: e_min = 0.0_wp !< namelist parameter
1137	REAL(wp) :: end_time = 0.0_wp !< namelist parameter
1138	REAL(wp) :: f = 0.0_wp !< Coriolis parameter
1139	REAL(wp) :: fs = 0.0_wp !< Coriolis parameter
1140	REAL(wp) :: inflow_damping_height = 9999999.9_wp !< namelist parameter
1141	REAL(wp) :: inflow_damping_width = 9999999.9_wp !< namelist parameter
1142	REAL(wp) :: km_constant = -1.0_wp !< namelist parameter
1143	REAL(wp) :: latitude = 55.0_wp !< namelist parameter
1144	REAL(wp) :: longitude = 0.0_wp !< namelist parameter
1145	REAL(wp) :: mask_scale_x = 1.0_wp !< namelist parameter
1146	REAL(wp) :: mask_scale_y = 1.0_wp !< namelist parameter
1147	REAL(wp) :: mask_scale_z = 1.0_wp !< namelist parameter
1148	REAL(wp) :: maximum_cpu_time_allowed = 0.0_wp !< given wall time for run
1149	REAL(wp) :: molecular_viscosity = 1.461E-5_wp !< molecular viscosity (used in lsm and lpm)
1150	REAL(wp) :: multi_agent_system_end = 9999999.9_wp !< namelist parameter (see documentation)
1151	REAL(wp) :: multi_agent_system_start = 0.0_wp !< namelist parameter (see documentation)
1152	REAL(wp) :: omega = 7.29212E-5_wp !< namelist parameter
1153	REAL(wp) :: omega_sor = 1.8_wp !< namelist parameter
1154	REAL(wp) :: outflow_source_plane = -9999999.9_wp !< namelist parameter
1155	REAL(wp) :: particle_maximum_age = 9999999.9_wp !< namelist parameter
1156	REAL(wp) :: prandtl_number = 1.0_wp !< namelist parameter
1157	REAL(wp) :: pt_damping_factor = 0.0_wp !< namelist parameter
1158	REAL(wp) :: pt_damping_width = 0.0_wp !< namelist parameter
1159	REAL(wp) :: pt_reference = 9999999.9_wp !< namelist parameter
1160	REAL(wp) :: pt_slope_offset = 0.0_wp !< temperature difference between left and right
1161	!< boundary of total domain
1162	REAL(wp) :: pt_surface = 300.0_wp !< namelist parameter
1163	REAL(wp) :: pt_surface_heating_rate = 0.0_wp !< namelist parameter
1164	REAL(wp) :: pt_surface_initial_change = 0.0_wp !< namelist parameter
1165	REAL(wp) :: q_surface = 0.0_wp !< namelist parameter
1166	REAL(wp) :: q_surface_initial_change = 0.0_wp !< namelist parameter
1167	REAL(wp) :: rayleigh_damping_factor = -1.0_wp !< namelist parameter
1168	REAL(wp) :: rayleigh_damping_height = -1.0_wp !< namelist parameter
1169	REAL(wp) :: recycling_width = 9999999.9_wp !< namelist parameter
1170	REAL(wp) :: residual_limit = 1.0E-4_wp !< namelist parameter
1171	REAL(wp) :: restart_file_size !< size of restart file in mbyte
1172	REAL(wp) :: restart_time = 9999999.9_wp !< namelist parameter
1173	REAL(wp) :: rho_reference !< reference state of density
1174	REAL(wp) :: rho_surface !< surface value of density
1175	REAL(wp) :: rotation_angle = 0.0_wp !< clockwise rotation of model North relative to real North [deg]
1176	REAL(wp) :: roughness_length = 0.1_wp !< namelist parameter
1177	REAL(wp) :: simulated_time = 0.0_wp !< elapsed simulated time
1178	REAL(wp) :: simulated_time_at_begin !< elapsed simulated time of previous run (job chain)
1179	REAL(wp) :: sin_alpha_surface !< sine of alpha_surface (sloped surface)
1180	REAL(wp) :: skip_time_data_output = 0.0_wp !< namelist parameter
1181	REAL(wp) :: skip_time_data_output_av = 9999999.9_wp !< namelist parameter
1182	REAL(wp) :: skip_time_dopr = 9999999.9_wp !< namelist parameter
1183	REAL(wp) :: skip_time_do2d_xy = 9999999.9_wp !< namelist parameter
1184	REAL(wp) :: skip_time_do2d_xz = 9999999.9_wp !< namelist parameter
1185	REAL(wp) :: skip_time_do2d_yz = 9999999.9_wp !< namelist parameter
1186	REAL(wp) :: skip_time_do3d = 9999999.9_wp !< namelist parameter
1187	REAL(wp) :: spinup_pt_amplitude = 0.0_wp !< namelist parameter
1188	REAL(wp) :: spinup_pt_mean = 9999999.9_wp !< namelist parameter
1189	REAL(wp) :: spinup_time = 0.0_wp !< namelist parameter
1190	REAL(wp) :: surface_heatflux = 9999999.9_wp !< namelist parameter
1191	REAL(wp) :: surface_pressure = 1013.25_wp !< namelist parameter
1192	REAL(wp) :: surface_scalarflux = 9999999.9_wp !< namelist parameter
1193	REAL(wp) :: surface_waterflux = 9999999.9_wp !< namelist parameter
1194	REAL(wp) :: s_surface = 0.0_wp !< namelist parameter
1195	REAL(wp) :: s_surface_initial_change = 0.0_wp !< namelist parameter
1196	REAL(wp) :: termination_time_needed = 35.0_wp !< namelist parameter
1197	REAL(wp) :: time_coupling = 0.0_wp !< time since last coupling (surface_coupler)
1198	REAL(wp) :: time_disturb = 0.0_wp !< time since last flow disturbance
1199	REAL(wp) :: time_dopr = 0.0_wp !< time since last profile output
1200	REAL(wp) :: time_dopr_av = 0.0_wp !< time since last averaged profile output
1201	REAL(wp) :: time_dopr_listing = 0.0_wp !< time since last profile output (ASCII) on file
1202	REAL(wp) :: time_dopts = 0.0_wp !< time since last particle timeseries output
1203	REAL(wp) :: time_dosp = 0.0_wp !< time since last spectra output
1204	REAL(wp) :: time_dosp_av = 0.0_wp !< time since last averaged spectra output
1205	REAL(wp) :: time_dots = 0.0_wp !< time since last timeseries output
1206	REAL(wp) :: time_do2d_xy = 0.0_wp !< time since last xy cross-section output
1207	REAL(wp) :: time_do2d_xz = 0.0_wp !< time since last xz cross-section output
1208	REAL(wp) :: time_do2d_yz = 0.0_wp !< time since last yz cross-section output
1209	REAL(wp) :: time_do3d = 0.0_wp !< time since last 3d output
1210	REAL(wp) :: time_do_av = 0.0_wp !< time since last averaged-data output
1211	REAL(wp) :: time_do_sla = 0.0_wp !< time since last
1212	REAL(wp) :: time_restart = 9999999.9_wp !< time at which run shall be terminated and restarted
1213	REAL(wp) :: time_run_control = 0.0_wp !< time since last RUN_CONTROL output
1214	REAL(wp) :: time_since_reference_point = 0.0_wp !< time after atmosphere-ocean coupling has been activated, or time
1215	!< after spinup phase of LSM has been finished
1216	REAL(wp) :: top_heatflux = 9999999.9_wp !< namelist parameter
1217	REAL(wp) :: top_momentumflux_u = 9999999.9_wp !< namelist parameter
1218	REAL(wp) :: top_momentumflux_v = 9999999.9_wp !< namelist parameter
1219	REAL(wp) :: top_salinityflux = 9999999.9_wp !< namelist parameter
1220	REAL(wp) :: top_scalarflux = 9999999.9_wp !< namelist parameter
1221	REAL(wp) :: tunnel_height = 9999999.9_wp !< namelist parameter
1222	REAL(wp) :: tunnel_length = 9999999.9_wp !< namelist parameter
1223	REAL(wp) :: tunnel_width_x = 9999999.9_wp !< namelist parameter
1224	REAL(wp) :: tunnel_width_y = 9999999.9_wp !< namelist parameter
1225	REAL(wp) :: tunnel_wall_depth = 9999999.9_wp !< namelist parameter
1226	REAL(wp) :: ug_surface = 0.0_wp !< namelist parameter
1227	REAL(wp) :: u_bulk = 0.0_wp !< namelist parameter
1228	REAL(wp) :: u_gtrans = 0.0_wp !< transformed wind component (galilei transformation)
1229	REAL(wp) :: vg_surface = 0.0_wp !< namelist parameter
1230	REAL(wp) :: vpt_reference = 9999999.9_wp !< reference state of virtual potential temperature
1231	REAL(wp) :: v_bulk = 0.0_wp !< namelist parameter
1232	REAL(wp) :: v_gtrans = 0.0_wp !< transformed wind component (galilei transformation)
1233	REAL(wp) :: zeta_max = 20.0_wp !< namelist parameter
1234	REAL(wp) :: zeta_min = -20.0_wp !< namelist parameter
1235	REAL(wp) :: z0h_factor = 1.0_wp !< namelist parameter
1236
1237	REAL(wp) :: do2d_xy_last_time(0:1) = -1.0_wp !< time of previous xy output
1238	REAL(wp) :: do2d_xz_last_time(0:1) = -1.0_wp !< time of previous xz output
1239	REAL(wp) :: do2d_yz_last_time(0:1) = -1.0_wp !< time of previous yz output
1240	REAL(wp) :: dpdxy(1:2) = 0.0_wp !< namelist parameter
1241	REAL(wp) :: dt_domask(max_masks) = 9999999.9_wp !< namelist parameter
1242	REAL(wp) :: dz(10) = -1.0_wp !< namelist parameter
1243	REAL(wp) :: dz_stretch_level_start(9) = -9999999.9_wp !< namelist parameter
1244	REAL(wp) :: dz_stretch_level_end(9) = 9999999.9_wp !< namelist parameter
1245	REAL(wp) :: dz_stretch_factor_array(9) = 1.08_wp !< namelist parameter
1246	REAL(wp) :: mask_scale(3) !< collective array for mask_scale_x/y/z
1247	REAL(wp) :: pt_vertical_gradient(10) = 0.0_wp !< namelist parameter
1248	REAL(wp) :: pt_vertical_gradient_level(10) = -999999.9_wp !< namelist parameter
1249	REAL(wp) :: q_vertical_gradient(10) = 0.0_wp !< namelist parameter
1250	REAL(wp) :: q_vertical_gradient_level(10) = -999999.9_wp !< namelist parameter
1251	REAL(wp) :: s_vertical_gradient(10) = 0.0_wp !< namelist parameter
1252	REAL(wp) :: s_vertical_gradient_level(10) = -999999.9_wp !< namelist parameter
1253	REAL(wp) :: skip_time_domask(max_masks) = 9999999.9_wp !< namelist parameter
1254	REAL(wp) :: threshold(20) = 0.0_wp !< namelist parameter
1255	REAL(wp) :: time_domask(max_masks) = 0.0_wp !< namelist parameter
1256	REAL(wp) :: tsc(10) = (/ 1.0_wp, 1.0_wp, 0.0_wp, 0.0_wp, & !< array used for controlling time-integration at different substeps
1257	0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp /)
1258	REAL(wp) :: u_profile(200) = 9999999.9_wp !< namelist parameter
1259	REAL(wp) :: uv_heights(200) = 9999999.9_wp !< namelist parameter
1260	REAL(wp) :: v_profile(200) = 9999999.9_wp !< namelist parameter
1261	REAL(wp) :: ug_vertical_gradient(10) = 0.0_wp !< namelist parameter
1262	REAL(wp) :: ug_vertical_gradient_level(10) = -9999999.9_wp !< namelist parameter
1263	REAL(wp) :: vg_vertical_gradient(10) = 0.0_wp !< namelist parameter
1264	REAL(wp) :: vg_vertical_gradient_level(10) = -9999999.9_wp !< namelist parameter
1265	REAL(wp) :: volume_flow(1:3) = 0.0_wp !< volume flow through 1:yz-plane, 2: xz-plane, 3: xy-plane
1266	!< (nest childs only)
1267	REAL(wp) :: volume_flow_area(1:3) = 0.0_wp !< area of the respective volume flow planes
1268	REAL(wp) :: volume_flow_initial(1:3) = 0.0_wp !< initial volume flow (t=0) through the respective volume flow
1269	!< planes
1270	REAL(wp) :: wall_heatflux(0:5) = 0.0_wp !< namelist parameter
1271	REAL(wp) :: wall_humidityflux(0:5) = 0.0_wp !< namelist parameter
1272	REAL(wp) :: wall_salinityflux(0:5) = 0.0_wp !< namelist parameter
1273	REAL(wp) :: wall_scalarflux(0:5) = 0.0_wp !< namelist parameter
1274	REAL(wp) :: subs_vertical_gradient(10) = 0.0_wp !< namelist parameter
1275	REAL(wp) :: subs_vertical_gradient_level(10) = -9999999.9_wp !< namelist parameter
1276
1277	REAL(wp), DIMENSION(:), ALLOCATABLE :: dp_smooth_factor !< smoothing factor for external pressure gradient forcing
1278
1279	REAL(wp), DIMENSION(max_masks,mask_xyz_dimension) :: mask_x = -1.0_wp !< namelist parameter
1280	REAL(wp), DIMENSION(max_masks,mask_xyz_dimension) :: mask_y = -1.0_wp !< namelist parameter
1281	REAL(wp), DIMENSION(max_masks,mask_xyz_dimension) :: mask_z = -1.0_wp !< namelist parameter
1282
1283	REAL(wp), DIMENSION(max_masks,3) :: mask_x_loop = -1.0_wp !< namelist parameter
1284	REAL(wp), DIMENSION(max_masks,3) :: mask_y_loop = -1.0_wp !< namelist parameter
1285	REAL(wp), DIMENSION(max_masks,3) :: mask_z_loop = -1.0_wp !< namelist parameter
1286
1287	!
1288	!-- Internal mask arrays ("mask,dimension,selection")
1289	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: mask !< collective array for mask_x/y/z
1290	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: mask_loop !< collective array for mask_x/y/z_loop
1291
1292	SAVE
1293
1294	END MODULE control_parameters
1295
1296
1297	!--------------------------------------------------------------------------------------------------!
1298	! Description:
1299	! ------------
1300	!> Definition of grid spacings.
1301	!--------------------------------------------------------------------------------------------------!
1302	MODULE grid_variables
1303
1304	USE kinds
1305
1306	REAL(wp) :: ddx !< 1/dx
1307	REAL(wp) :: ddx2 !< 1/dx2
1308	REAL(wp) :: dx = 1.0_wp !< horizontal grid size (along x-direction)
1309	REAL(wp) :: dx2 !< dx*dx
1310	REAL(wp) :: ddy !< 1/dy
1311	REAL(wp) :: ddy2 !< 1/dy2
1312	REAL(wp) :: dy = 1.0_wp !< horizontal grid size (along y-direction)
1313	REAL(wp) :: dy2 !< dy*dy
1314
1315	REAL(wp), DIMENSION(:), ALLOCATABLE :: ddx2_mg !< 1/dx_l**2 (dx_l: grid spacing along x on different multigrid level)
1316	REAL(wp), DIMENSION(:), ALLOCATABLE :: ddy2_mg !< 1/dy_l**2 (dy_l: grid spacing along y on different multigrid level)
1317
1318	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: zu_s_inner !< height of topography top on scalar grid
1319	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: zw_w_inner !< height of topography top on w grid
1320
1321	SAVE
1322
1323	END MODULE grid_variables
1324
1325
1326	!--------------------------------------------------------------------------------------------------!
1327	! Description:
1328	! ------------
1329	!> Definition of array bounds, number of gridpoints, and wall flag arrays.
1330	!--------------------------------------------------------------------------------------------------!
1331	MODULE indices
1332
1333	USE kinds
1334
1335	INTEGER(iwp) :: nbgp = 3 !< number of boundary ghost points
1336	INTEGER(iwp) :: ngp_sums !< number of vertical profile grid points time number of output profiles - used for allreduce
1337	!< statements in MPI calls
1338	INTEGER(iwp) :: ngp_sums_ls !< number of vertical profile grid points time number of large-scale forcing profiles - used for
1339	!< allreduce statements in MPI calls
1340	INTEGER(iwp) :: nnx !< number of subdomain grid points in x-direction
1341	INTEGER(iwp) :: nx = 0 !< nx+1 = total number of grid points in x-direction
1342	INTEGER(iwp) :: nx_a !< in coupled atmosphere-ocean runs: total number of grid points along x (atmosphere)
1343	INTEGER(iwp) :: nx_o !< in coupled atmosphere-ocean runs: total number of grid points along x (ocean)
1344	INTEGER(iwp) :: nxl !< left-most grid index of subdomain (excluding ghost points)
1345	INTEGER(iwp) :: nxlg !< left-most grid index of subdomain (including ghost points)
1346	INTEGER(iwp) :: nxlu !< =nxl+1 (at left domain boundary with inflow from left), else =nxl
1347	!< (used for u-velocity component)
1348	INTEGER(iwp) :: nxr !< right-most grid index of subdomain (excluding ghost points)
1349	INTEGER(iwp) :: nxrg !< right-most grid index of subdomain (including ghost points)
1350	INTEGER(iwp) :: nx_on_file !< nx of previous run in job chain
1351	INTEGER(iwp) :: nny !< number of subdomain grid points in y-direction
1352	INTEGER(iwp) :: ny = 0 !< ny+1 = total number of grid points in y-direction
1353	INTEGER(iwp) :: ny_a !< in coupled atmosphere-ocean runs: total number of grid points along y (atmosphere)
1354	INTEGER(iwp) :: ny_o !< in coupled atmosphere-ocean runs: total number of grid points along y (ocean)
1355	INTEGER(iwp) :: nyn !< north-most grid index of subdomain (excluding ghost points)
1356	INTEGER(iwp) :: nyng !< north-most grid index of subdomain (including ghost points)
1357	INTEGER(iwp) :: nys !< south-most grid index of subdomain (excluding ghost points)
1358	INTEGER(iwp) :: nysg !< south-most grid index of subdomain (including ghost points)
1359	INTEGER(iwp) :: nysv !< =nys+1 (at south domain boundary with inflow from south), else =nys
1360	!< (used for v-velocity component)
1361	INTEGER(iwp) :: ny_on_file !< ny of previous run in job chain
1362	INTEGER(iwp) :: nnz !< number of subdomain grid points in z-direction
1363	INTEGER(iwp) :: nz = 0 !< total number of grid points in z-direction
1364	INTEGER(iwp) :: nzb !< bottom grid index of computational domain
1365	INTEGER(iwp) :: nzb_diff !< will be removed
1366	INTEGER(iwp) :: nzb_max !< vertical index of topography top
1367	INTEGER(iwp) :: nzt !< nzt+1 = top grid index of computational domain
1368	INTEGER(iwp) :: topo_min_level !< minimum topography-top index (usually equal to nzb)
1369
1370	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: ngp_2dh !< number of grid points of a horizontal cross section through the
1371	!< total domain
1372	INTEGER(idp), DIMENSION(:), ALLOCATABLE :: ngp_3d !< number of grid points of the total domain
1373	INTEGER(idp), DIMENSION(:), ALLOCATABLE :: ngp_3d_inner !< ! need to have 64 bit for grids > 2E9
1374	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: nxl_mg !< left-most grid index of subdomain on different multigrid level
1375	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: nxr_mg !< right-most grid index of subdomain on different multigrid level
1376	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: nyn_mg !< north-most grid index of subdomain on different multigrid level
1377	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: nys_mg !< south-most grid index of subdomain on different multigrid level
1378	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: nzt_mg !< top-most grid index of subdomain on different multigrid level
1379
1380
1381	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: mg_loc_ind !< internal array to store index bounds of all PEs of that
1382	!< multigrid level where data is collected to PE0
1383	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: ngp_2dh_outer !< number of horizontal grid points which are non-topography and
1384	!< non-surface-bounded
1385	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: ngp_2dh_s_inner !< number of horizontal grid points which are non-topography
1386
1387	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_1 !< topograpyh masking flag on multigrid level 1
1388	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_2 !< topograpyh masking flag on multigrid level 2
1389	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_3 !< topograpyh masking flag on multigrid level 3
1390	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_4 !< topograpyh masking flag on multigrid level 4
1391	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_5 !< topograpyh masking flag on multigrid level 5
1392	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_6 !< topograpyh masking flag on multigrid level 6
1393	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_7 !< topograpyh masking flag on multigrid level 7
1394	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_8 !< topograpyh masking flag on multigrid level 8
1395	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_9 !< topograpyh masking flag on multigrid level 9
1396	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE, TARGET :: wall_flags_10 !< topograpyh masking flag on multigrid level 10
1397
1398	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE :: advc_flags_m !< flags used to degrade order of advection scheme for
1399	!< momentum
1400	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE :: advc_flags_s !< flags used to degrade order of advection scheme for
1401	!< scalar quantities
1402	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE :: topo_top_ind !< precalculated topography top indices
1403	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE :: wall_flags_static_0 !< flags to mask topography and surface-bounded grid
1404	!< points
1405	INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE :: wall_flags_total_0 !< merged array, which contains the static and dynamic
1406	!< flags
1407
1408	INTEGER(iwp), DIMENSION(:,:,:), POINTER :: flags !< pointer to wall_flags_1-10
1409
1410	SAVE
1411
1412	END MODULE indices
1413
1414
1415	!--------------------------------------------------------------------------------------------------!
1416	! Description:
1417	! ------------
1418	!> Interfaces for special subroutines which use optional parameters.
1419	!--------------------------------------------------------------------------------------------------!
1420	MODULE interfaces
1421
1422	INTERFACE
1423
1424	!--------------------------------------------------------------------------------------------------!
1425	! Description:
1426	! ------------
1427	!> @todo Missing subroutine description.
1428	!--------------------------------------------------------------------------------------------------!
1429	SUBROUTINE global_min_max ( i1, i2, j1, j2, k1, k2, array, mode, offset, result, result_ijk,&
1430	result1, result1_ijk )
1431
1432	USE kinds
1433
1434	CHARACTER (LEN=*), INTENT(IN) :: mode !< mode of global min/max function: can be 'min', 'max',
1435	!< 'minmax', 'abs', or 'absoff'
1436
1437	INTEGER(iwp), INTENT(IN) :: i1 !< internal index of min/max function
1438	INTEGER(iwp), INTENT(IN) :: i2 !< internal index of min/max function
1439	INTEGER(iwp), INTENT(IN) :: j1 !< internal index of min/max function
1440	INTEGER(iwp), INTENT(IN) :: j2 !< internal index of min/max function
1441	INTEGER(iwp), INTENT(IN) :: k1 !< internal index of min/max function
1442	INTEGER(iwp), INTENT(IN) :: k2 !< internal index of min/max function
1443
1444	INTEGER(iwp) :: result_ijk(3) !< grid index result of min/max function
1445	INTEGER(iwp), OPTIONAL :: result1_ijk(3) !< optional grid index result of min/max function
1446
1447	REAL(wp) :: offset !< min/max function calculates absolute value with respect to
1448	!< an offset
1449	REAL(wp) :: result !< result of min/max function
1450	REAL(wp), OPTIONAL :: result1 !< optional result of min/max function
1451
1452	REAL(wp), INTENT(IN) :: array(i1:i2,j1:j2,k1:k2) !< input array of min/max function
1453
1454	END SUBROUTINE global_min_max
1455
1456	END INTERFACE
1457
1458	SAVE
1459
1460	END MODULE interfaces
1461
1462
1463	!--------------------------------------------------------------------------------------------------!
1464	! Description:
1465	! ------------
1466	!> Interfaces for subroutines with pointer arguments called in prognostic_equations.
1467	!--------------------------------------------------------------------------------------------------!
1468	MODULE pointer_interfaces
1469
1470	INTERFACE
1471
1472	!--------------------------------------------------------------------------------------------------!
1473	! Description:
1474	! ------------
1475	!> @todo Missing subroutine description.
1476	!--------------------------------------------------------------------------------------------------!
1477	SUBROUTINE advec_s_bc( sk, sk_char )
1478
1479	USE kinds
1480
1481	CHARACTER (LEN=*), INTENT(IN) :: sk_char !< string for treated scalar in Bott-Chlond scheme
1482
1483	REAL(wp), DIMENSION(:,:,:), POINTER :: sk !< treated scalar array in Bott-Chlond scheme
1484
1485	END SUBROUTINE advec_s_bc
1486
1487	END INTERFACE
1488
1489	SAVE
1490
1491	END MODULE pointer_interfaces
1492
1493
1494	!--------------------------------------------------------------------------------------------------!
1495	! Description:
1496	! ------------
1497	!> Definition of variables which define processor topology and the exchange of ghost point layers.
1498	!> This module must be placed in all routines containing MPI-calls.
1499	!--------------------------------------------------------------------------------------------------!
1500	MODULE pegrid
1501
1502	USE kinds
1503
1504	#if defined( __parallel )
1505	USE MPI
1506	#endif
1507
1508	CHARACTER(LEN=2) :: send_receive = 'al' !<
1509	CHARACTER(LEN=7) :: myid_char = '' !< character string containing processor id number
1510
1511	INTEGER(iwp) :: comm1dx !< communicator for domain decomposition along x
1512	INTEGER(iwp) :: comm1dy !< communicator for domain decomposition along y
1513	INTEGER(iwp) :: comm2d !< standard 2d (xy) communicator used in PALM for the process group the PE belongs
1514	!< to
1515	INTEGER(iwp) :: comm_inter !< intercommunicator that connects atmosphere/ocean process groups
1516	INTEGER(iwp) :: comm_palm !< internal communicator used during the MPI setup at the beginning of a run
1517	INTEGER(iwp) :: id_inflow = 0 !< myidx of procs at inflow (turbulent inflow method)
1518	INTEGER(iwp) :: id_outflow = 0 !< myidx of procs at outflow (turbulent outflow method)
1519	INTEGER(iwp) :: id_outflow_source = 0 !< myidx of procs including ouflow source plane (turbulent outflow method)
1520	INTEGER(iwp) :: id_recycling = 0 !< myidx of procs containing the recycling plane (turbulence recycling method)
1521	INTEGER(iwp) :: ierr !< standard error parameter in MPI calls
1522	INTEGER(iwp) :: myid = 0 !< id number of processor element
1523	INTEGER(iwp) :: myidx = 0 !< id number of processor elements with same position along x-direction
1524	INTEGER(iwp) :: myidy = 0 !< id number of processor elements with same position along y-direction
1525	INTEGER(iwp) :: ndim = 2 !< dimension of the virtual PE grid
1526	INTEGER(iwp) :: ngp_a !< used in atmosphere/ocean coupling: total number of horizontal grid points
1527	!< (atmosphere)
1528	INTEGER(iwp) :: ngp_o !< used in atmosphere/ocean coupling: total number of horizontal grid points
1529	!< (ocean)
1530	INTEGER(iwp) :: ngp_xy !< used in atmosphere/ocean coupling: number of grid points of the subdomain
1531	INTEGER(iwp) :: ngp_y !< number of subdomain grid points along y including ghost points
1532	INTEGER(iwp) :: npex = -1 !< number of processor elements in x-direction
1533	INTEGER(iwp) :: npey = -1 !< number of processor elements in y-direction
1534	INTEGER(iwp) :: numprocs = 1 !< total number of appointed processor elements
1535	INTEGER(iwp) :: numprocs_previous_run = -1 !< total number of appointed processor elements in previous run (job chain)
1536	INTEGER(iwp) :: pleft !< MPI id of left neigbour pe
1537	INTEGER(iwp) :: pnorth !< MPI id of right neigbour pe
1538	INTEGER(iwp) :: pright !< MPI id of south neigbour pe
1539	INTEGER(iwp) :: psouth !< MPI id of north neigbour pe
1540	INTEGER(iwp) :: req_count = 0 !< MPI return variable - checks if Send-Receive operation is already finished
1541	INTEGER(iwp) :: sendrecvcount_xy !< number of subdomain gridpoints to be exchanged in direct transpositions
1542	!< (y --> x, or x --> y) or second (2d) transposition x --> y
1543	INTEGER(iwp) :: sendrecvcount_yz !< number of subdomain gridpoints to be exchanged in third (2d) transposition
1544	!< y --> z
1545	INTEGER(iwp) :: sendrecvcount_zx !< number of subdomain gridpoints to be exchanged in first (2d) transposition
1546	!< z --> x
1547	INTEGER(iwp) :: sendrecvcount_zyd !< number of subdomain gridpoints to be exchanged in direct transpositions z --> y (used for calculating spectra)
1548	INTEGER(iwp) :: target_id !< in atmosphere/ocean coupling: id of the ocean/atmosphere counterpart PE with
1549	!< whom the atmosphere/ocean PE exchanges data
1550	INTEGER(iwp) :: tasks_per_node = -9999 !< MPI tasks per compute node
1551	INTEGER(iwp) :: threads_per_task = 1 !< number of OPENMP threads per MPI task
1552	INTEGER(iwp) :: type_x !< derived MPI datatype for 2-D ghost-point exchange - north / south
1553	INTEGER(iwp) :: type_xy !< derived MPI datatype for 2-D ghost-point exchange - north / south
1554	INTEGER(iwp) :: type_y !< derived MPI datatype for 2-D exchange in atmosphere-ocean coupler
1555
1556	INTEGER(iwp) :: pdims(2) = 1 !< number of processors along x-y dimension
1557	INTEGER(iwp) :: req(100) !< MPI return variable indicating if send-receive operation is finished
1558
1559	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: hor_index_bounds !< horizontal index bounds
1560	INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: hor_index_bounds_previous_run !< horizontal index bounds of previous run
1561
1562	LOGICAL :: collective_wait = .FALSE. !< switch to set an explicit MPI barrier in front of all collective MPI calls
1563
1564	TYPE virtual_pe_grid
1565	INTEGER(iwp) :: mpi_communicator !< MPI communicator id
1566	INTEGER(iwp) :: pleft !< MPI id of left neigbour pe
1567	INTEGER(iwp) :: pright !< MPI id of right neigbour pe
1568	INTEGER(iwp) :: psouth !< MPI id of south neigbour pe
1569	INTEGER(iwp) :: pnorth !< MPI id of north neigbour pe
1570	END TYPE virtual_pe_grid
1571
1572	TYPE(virtual_pe_grid) :: communicator_configurations(4) !< stores the four possible 2d virtual grids:
1573	!< cyclic, cyclic along x, cyclic along y, non-cyclic
1574
1575	#if defined( __parallel )
1576	INTEGER(iwp) :: ibuf(12) !< internal buffer for calculating MPI settings
1577	INTEGER(iwp) :: pcoord(2) !< PE coordinates along x and y
1578	INTEGER(iwp) :: status(MPI_STATUS_SIZE) !< MPI status variable used in various MPI calls
1579	INTEGER(iwp) :: type_x_byte !< derived MPI datatype for 2-D 8-bit integer ghost-point exchange - north / south
1580	INTEGER(iwp) :: type_y_byte !< derived MPI datatype for 2-D integer ghost-point exchange - left / right
1581
1582	INTEGER(iwp), DIMENSION(MPI_STATUS_SIZE,100) :: wait_stat !< MPI status variable used in various MPI calls
1583
1584	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: ngp_xz !< number of ghost points in xz-plane on different multigrid level
1585	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: ngp_xz_int !< number of ghost points in xz-plane on different multigrid level
1586	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: ngp_yz !< number of ghost points in yz-plane on different multigrid level
1587	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: ngp_yz_int !< number of ghost points in yz-plane on different multigrid level
1588	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: type_x_int !< derived MPI datatype for 2-D integer ghost-point exchange - north /
1589	!< south
1590	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: type_xz !< derived MPI datatype for 3-D integer ghost-point exchange - north /
1591	!< south
1592	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: type_xz_int !< derived MPI datatype for 3-D integer ghost-point exchange - north /
1593	!< south
1594	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: type_y_int !< derived MPI datatype for 2-D integer ghost-point exchange - left /
1595	!< right
1596	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: type_yz !< derived MPI datatype for 3-D integer ghost-point exchange - left /
1597	!< right
1598	INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: type_yz_int !< derived MPI datatype for 3-D integer ghost-point exchange - left /
1599	!< right
1600
1601	LOGICAL :: left_border_pe = .FALSE. !< = .TRUE. if PE is on left border of computational domain
1602	LOGICAL :: north_border_pe = .FALSE. !< = .TRUE. if PE is on north border of computational domain
1603	LOGICAL :: reorder = .TRUE. !< switch to allow MPI the reorder of ranking (e.g. row-major or column-major)
1604	LOGICAL :: right_border_pe = .FALSE. !< = .TRUE. if PE is on right border of computational domain
1605	LOGICAL :: south_border_pe = .FALSE. !< = .TRUE. if PE is on south border of computational domain
1606
1607	LOGICAL, DIMENSION(2) :: cyclic = (/ .TRUE. , .TRUE. /) !< boundary conditions of the virtual PE grid
1608	LOGICAL, DIMENSION(2) :: remain_dims !< internal array used to determine sub-topologies for transpositions
1609	#endif
1610
1611	SAVE
1612
1613	END MODULE pegrid
1614
1615
1616	!--------------------------------------------------------------------------------------------------!
1617	! Description:
1618	! ------------
1619	!> Definition of variables which control PROFIL-output.
1620	!--------------------------------------------------------------------------------------------------!
1621	MODULE profil_parameter
1622
1623	USE kinds
1624
1625	INTEGER(iwp), PARAMETER :: crmax = 100 !< maximum number of coordinate systems for profile output
1626
1627	CHARACTER (LEN=27), DIMENSION(20) :: cross_ts_profiles = & !< time series to be plotted into one coordinate system, respectively
1628	(/ ' E E* ', &
1629	' dt ', &
1630	' u* w* ', &
1631	' th* ', &
1632	' umax vmax wmax ', &
1633	' div_old div_new ', &
1634	' zi_wtheta zi_theta ', &
1635	' w"theta"0 w"theta" wtheta ', &
1636	' theta(0) theta(zp) ', &
1637	' splux spluy spluz ', &
1638	' L ', &
1639	( ' ', i9 = 1, 9 ) /)
1640
1641	CHARACTER (LEN=100), DIMENSION(crmax) :: cross_profiles = & !< quantities to be plotted into one coordinate system, respectively
1642	(/ ' u v ', &
1643	' pt ', &
1644	' w"theta" wtheta wthetaBC wtheta wthetaBC ', &
1645	' w"u" wu wu w"v" wv wv ', &
1646	' km kh ', &
1647	' l ', &
1648	( ' ', i9 = 1, 94 ) /)
1649
1650	INTEGER(iwp) :: profile_columns = 2 !< number of coordinate systems on a profile plot per column
1651	INTEGER(iwp) :: profile_rows = 3 !< number of coordinate systems on a profile plot per row
1652
1653	INTEGER(iwp) :: dopr_index(300) = 0 !< index number of respective profile quantity
1654	INTEGER(iwp) :: dopr_initial_index(300) = 0 !< index number of initial profiles to be output
1655
1656	SAVE
1657
1658	END MODULE profil_parameter
1659
1660	!--------------------------------------------------------------------------------------------------!
1661	! Description:
1662	! ------------
1663	!> Definition of statistical quantities, e.g. global sums.
1664	!--------------------------------------------------------------------------------------------------!
1665	MODULE statistics
1666
1667	USE kinds
1668
1669	CHARACTER (LEN=40) :: region(0:9) = 'total domain ' !< label for statistic region
1670
1671	INTEGER(iwp) :: pr_palm = 200 !< maximum number of output profiles
1672	INTEGER(iwp) :: statistic_regions = 0 !< identifier for statistic regions
1673
1674	INTEGER(iwp) :: u_max_ijk(3) = -1 !< index values (i,j,k) of location where u_max occurs
1675	INTEGER(iwp) :: v_max_ijk(3) = -1 !< index values (i,j,k) of location where v_max occurs
1676	INTEGER(iwp) :: w_max_ijk(3) = -1 !< index values (i,j,k) of location where w_max occurs
1677
1678	LOGICAL :: flow_statistics_called = .FALSE. !< flag that tells other routines if flow statistics was executed
1679	!< (after each timestep)
1680
1681	REAL(wp) :: u_max = 0.0_wp !< maximum of absolute u-veloctiy in entire domain
1682	REAL(wp) :: v_max = 0.0_wp !< maximum of absolute v-veloctiy in entire domain
1683	REAL(wp) :: w_max = 0.0_wp !< maximum of absolute w-veloctiy in entire domain
1684
1685	REAL(wp), DIMENSION(2) :: z_i !< inversion height
1686
1687	REAL(wp), DIMENSION(:), ALLOCATABLE :: mean_surface_level_height !< mean surface level height for the different statistic
1688	!< regions
1689	REAL(wp), DIMENSION(:), ALLOCATABLE :: sums_divnew_l !< subdomain sum (_l) of divergence after pressure
1690	!< solver call (new)
1691	REAL(wp), DIMENSION(:), ALLOCATABLE :: sums_divold_l !< subdomain sum (_l) of divergence before pressure
1692	!< solver call (old)
1693	REAL(wp), DIMENSION(:), ALLOCATABLE :: weight_pres !< substep weighting factor for pressure solver
1694	REAL(wp), DIMENSION(:), ALLOCATABLE :: weight_substep !< weighting factor for substeps in timestepping
1695
1696	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums !< global sum array for the various output quantities
1697	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_ls_l !< subdomain sum of large scale forcing and nudging tendencies
1698	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_salsa_ws_l !< subdomain sum of vertical salsa flux w's'
1699	!< (5th-order advection scheme only)
1700	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_us2_ws_l !< subdomain sum of horizontal momentum flux u'u'
1701	!< (5th-order advection scheme only)
1702	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_vs2_ws_l !< subdomain sum of horizontal momentum flux v'v'
1703	!< (5th-order advection scheme only)
1704	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_ws2_ws_l !< subdomain sum of vertical momentum flux w'w'
1705	!< (5th-order advection scheme only)
1706	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsncs_ws_l !< subdomain sum of vertical clouddrop-number concentration flux
1707	!< w'nc' (5th-order advection scheme only)
1708	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsngs_ws_l !< subdomain sum of vertical graupel-number concentration flux w'nc' (5th-order advection scheme only)
1709	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsnis_ws_l !< subdomain sum of vertical ice crystal concentration flux w'ni'
1710	!< (5th-order advection scheme only)
1711	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsnrs_ws_l !< subdomain sum of vertical raindrop-number concentration flux w'nr'
1712	!< (5th-order advection scheme only)
1713	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsnss_ws_l !< subdomain sum of vertical snow-number concentration flux w'ns' (5th-order advection scheme only)
1714	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wssas_ws_l !< subdomain sum of vertical salinity flux w'sa'
1715	!< (5th-order advection scheme only)
1716	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsss_ws_l !< subdomain sum of vertical passive scalar flux w's'
1717	!< (5th-order advection scheme only)
1718	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wspts_ws_l !< subdomain sum of vertical sensible heat flux w'pt'
1719	!< (5th-order advection scheme only)
1720	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsqcs_ws_l !< subdomain sum of vertical cloudwater flux w'qc'
1721	!< (5th-order advection scheme only)
1722	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsqgs_ws_l !< subdomain sum of vertical graupel flux w'qg' (5th-order advection scheme only)
1723	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsqis_ws_l !< subdomain sum of vertical ice crystal flux w'qi'
1724	!< (5th-order advection scheme only)
1725	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsqrs_ws_l !< subdomain sum of vertical rainwater flux w'qr'
1726	!< (5th-order advection scheme only)
1727	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsqss_ws_l !< subdomain sum of vertical snow flux w'qs' (5th-order advection scheme only)
1728	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsqs_ws_l !< subdomain sum of vertical latent heat flux w'q'
1729	!< (5th-order advection scheme only)
1730	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsts_bc_l !< subdomain sum of sensible heat flux in Bott-Chlond scheme
1731	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsus_ws_l !< subdomain sum of vertical momentum flux w'u'
1732	!< (5th-order advection scheme only)
1733	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: sums_wsvs_ws_l !< subdomain sum of vertical momentum flux w'v'
1734	!< (5th-order advection scheme only)
1735	REAL(wp), DIMENSION(:,:), ALLOCATABLE :: ts_value !< timeseries output array for the various output quantities
1736
1737	REAL(wp), DIMENSION(:,:), POINTER :: sums_wschs_ws_l !< subdomain sum of vertical chemistry flux w'ch'
1738
1739	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: hom_sum !< sum array for horizontal mean
1740	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: rmask !< REAL flag array (0.0 or 1.0) for statistic regions
1741	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: sums_l !< subdomain sum (_l) gathered for various quantities
1742	REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: sums_l_l !< subdomain sum (_l) of mixing length from diffusivities
1743
1744	REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE :: hom !< horizontal mean of various quantities (profiles/timeseries)
1745
1746	SAVE
1747
1748	END MODULE statistics
1749
1750
1751
1752	!--------------------------------------------------------------------------------------------------!
1753	! Description:
1754	! ------------
1755	!> Definition of indices for transposed arrays.
1756	!--------------------------------------------------------------------------------------------------!
1757	MODULE transpose_indices
1758
1759	USE kinds
1760
1761	INTEGER(iwp) :: nxl_y !< internal index bound for transpositions
1762	INTEGER(iwp) :: nxl_yd !< internal index bound for transpositions
1763	INTEGER(iwp) :: nxl_z !< internal index bound for transpositions
1764	INTEGER(iwp) :: nxr_y !< internal index bound for transpositions
1765	INTEGER(iwp) :: nxr_yd !< internal index bound for transpositions
1766	INTEGER(iwp) :: nxr_z !< internal index bound for transpositions
1767	INTEGER(iwp) :: nyn_x !< internal index bound for transpositions
1768	INTEGER(iwp) :: nyn_z !< internal index bound for transpositions
1769	INTEGER(iwp) :: nys_x !< internal index bound for transpositions
1770	INTEGER(iwp) :: nys_z !< internal index bound for transpositions
1771	INTEGER(iwp) :: nzb_x !< internal index bound for transpositions
1772	INTEGER(iwp) :: nzb_y !< internal index bound for transpositions
1773	INTEGER(iwp) :: nzb_yd !< internal index bound for transpositions
1774	INTEGER(iwp) :: nzt_x !< internal index bound for transpositions
1775	INTEGER(iwp) :: nzt_y !< internal index bound for transpositions
1776	INTEGER(iwp) :: nzt_yd !< internal index bound for transpositions
1777
1778	SAVE
1779
1780	END MODULE transpose_indices

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

| Impressum | ©Leibniz Universität Hannover |