Home

Context Navigation

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

Last change on this file since 4581 was 4581, checked in by suehring, 4 years ago
mesoscale nesting: omit explicit pressure forcing via geostrophic wind components; chemistry: enable profile output of vertical fluxes; urban-surface: bugfix in initialization in case of cyclic_fill
Property svn:keywords set to `Id`
File size: 123.3 KB

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

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

Download in other formats:

| Impressum | ©Leibniz Universität Hannover |