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

Last change on this file since 2101 was 2101, checked in by suehring, 7 years ago

last commit documented

  • Property svn:keywords set to Id
File size: 60.4 KB
Line 
1!> @file modules.f90
2!------------------------------------------------------------------------------!
3! This file is part of PALM.
4!
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.
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!
17! Copyright 1997-2017 Leibniz Universitaet Hannover
18!------------------------------------------------------------------------------!
19!
20! Current revisions:
21! ------------------
22!
23!
24! Former revisions:
25! -----------------
26! $Id: modules.f90 2101 2017-01-05 16:42:31Z suehring $
27!
28! 2050 2016-11-08 15:00:55Z gronemeier
29! Implement turbulent outflow condition
30!
31! 2037 2016-10-26 11:15:40Z knoop
32! Anelastic approximation implemented
33!
34! 2031 2016-10-21 15:11:58Z knoop
35! renamed variable rho to rho_ocean and rho_av to rho_ocean_av
36!
37! 2011 2016-09-19 17:29:57Z kanani
38! +urban_surface, +lsf_exception, +varnamelength
39!
40! 2007 2016-08-24 15:47:17Z kanani
41! Increased DIMENSION of data_output, data_output_user, do2d, do3d
42!
43! 2000 2016-08-20 18:09:15Z knoop
44! Forced header and separation lines into 80 columns
45!
46! 1992 2016-08-12 15:14:59Z suehring
47! +constant_top_scalarflux, top_scalarflux
48! default of bc_s_t adjusted
49!
50! 1968 2016-07-18 12:01:49Z suehring
51! Changed dimension for MPI-datatypes type_x_int and type_y_int
52!
53! 1960 2016-07-12 16:34:24Z suehring
54! Separate humidity and passive scalar
55! +bc_s_t_val, diss_s_s, diss_l_s, flux_s_s, flux_l_s, s, sp, s1, s2, s3, ssws_av,
56!  s_init, s_surf, sums_wsss_ws_l, ss, ssws, sswst, ts_m, wall_sflux
57! +constant_scalarflux, ibc_s_b, ibc_s_t, s_vertical_gradient_level_ind
58!
59! Unused variables removed
60! -gamma_x, gamma_y, gamma_z, var_x, var_y, var_z
61!
62! Change initial values (in order to unify gradient calculation):
63! pt_vertical_gradient_level, sa_vertical_gradient_level
64!
65! 1957 2016-07-07 10:43:48Z suehring
66! +fl_max, num_leg, num_var_fl, num_var_fl_user, var_fl_max, virtual_flight
67!
68! 1918 2016-05-27 14:35:57Z raasch
69! default timestep switched from -1.0 to +1.0 in order to avoid wrong sign of
70! initially calculated divergence
71!
72! 1906 2016-05-24 14:38:08Z suehring
73! default value of mg_switch_to_pe0_level changed to -1
74!
75! 1849 2016-04-08 11:33:18Z hoffmann
76! bfactor, mass_of_solute, molecular_weight_of_solute, molecular_weight_of_water,
77! vanthoff moved to mod_particle_attributes.
78! dt_micro and several cloud_parameters moved to microphysics_mod.
79! 1d-microphysics profiles moved to microphysics_mod.
80!
81! 1845 2016-04-08 08:29:13Z raasch
82! -nzb_2d
83!
84! 1833 2016-04-07 14:23:03Z raasch
85! spectra parameter moved to spectra module
86!
87! 1831 2016-04-07 13:15:51Z hoffmann
88! curvature_solution_effects removed
89! turbulence renamed collision_turbulence, drizzle renamed
90! cloud_water_sedimentation
91!
92! 1822 2016-04-07 07:49:42Z hoffmann
93! icloud_scheme removed. microphysics_sat_adjust, microphysics_kessler,
94! microphysics_seifert added.
95!
96! 1815 2016-04-06 13:49:59Z raasch
97! cpp-directive for decalpha removed
98!
99! 1808 2016-04-05 19:44:00Z raasch
100! MPI module used by default on all machines
101!
102! 1804 2016-04-05 16:30:18Z maronga
103! Removed code for parameter file check (__check)
104!
105! 1788 2016-03-10 11:01:04Z maronga
106! Added roughness length for moisture (z0q)
107!
108! 1786 2016-03-08 05:49:27Z raasch
109! module spectrum moved to new separate module
110!
111! 1783 2016-03-06 18:36:17Z raasch
112! netcdf variables moved to the netcdf-interface module
113!
114! 1779 2016-03-03 08:01:28Z raasch
115! coupling_char extended to LEN=3
116!
117! 1764 2016-02-28 12:45:19Z raasch
118! some reformatting
119!
120! 1762 2016-02-25 12:31:13Z hellstea
121! +nest_* variables, size of volume_flow arrays increased by one element
122!
123! 1738 2015-12-18 13:56:05Z raasch
124! +mean_surface_level_height
125!
126! 1695 2015-10-27 10:03:11Z maronga
127! Removed rif (forgotten in last revision)
128!
129! 1693 2015-10-27 08:35:45Z maronga
130! Renamed zp -> z_mo
131!
132! 1691 2015-10-26 16:17:44Z maronga
133! Renamed Obukhov length. Added ol, removed rif. Increased number of profiles
134! (pr_palm). Changed default values for dissipation_1d to 'detering' and
135! (mixing_length_1d to 'blackadar'. Added most_method. rif_min and rif_max
136! renamed to zeta_min and zeta_max and new values assigned.
137!
138! 1682 2015-10-07 23:56:08Z knoop
139! Code annotations made doxygen readable
140!
141! 1677 2015-10-02 13:25:23Z boeske
142! +ngp_yz_int, type_xz_int, type_yz_int
143!
144! 1666 2015-09-23 07:31:10Z raasch
145! +user_interface_current_revision, user_interface_required_revision in
146! control_parameters
147!
148! 1639 2015-08-31 14:46:48Z knoop
149! Bugfix: string 'unknown' extended to match LEN=13
150!
151! 1575 2015-03-27 09:56:27Z raasch
152! +ngp_xz
153!
154! 1560 2015-03-06 10:48:54Z keck
155! +recycling_yshift
156!
157! 1557 2015-03-05 16:43:04Z suehring
158! +monotonic_adjustment
159!
160! 1551 2015-03-03 14:18:16Z maronga
161! Increased pr_palm to 120. Increased length of dots_unit and dots_label to 13
162! digits. Increased length of domask, do2d, and do3d to 20 digits.
163!
164! 1496 2014-12-02 17:25:50Z maronga
165! Renamed "radiation" -> "cloud_top_radiation"
166!
167! 1484 2014-10-21 10:53:05Z kanani
168! Changes due to new module structure of the plant canopy model:
169!   canopy-model related parameters/variables moved to module
170!   plant_canopy_model_mod
171!
172! 1468 2014-09-24 14:06:57Z maronga
173! Adapted for use on up to 6-digit processor cores.
174! Increased identifier string length for user-defined quantities to 20.
175!
176! 1450 2014-08-21 07:31:51Z heinze
177! ntnudge from 100 to 1000 increased to allow longer simulations
178!
179! 1431 2014-07-15 14:47:17Z suehring
180! +var_d
181!
182! 1429 2014-07-15 12:53:45Z knoop
183! +ensemble_member_nr to prepare the random_generator for ensemble runs
184!
185! 1382 2014-04-30 12:15:41Z boeske
186! Renamed variables which store large scale forcing tendencies
187! pt_lsa -> td_lsa_lpt, pt_subs -> td_sub_lpt,
188! q_lsa  -> td_lsa_q,   q_subs  -> td_sub_q
189!
190! 1365 2014-04-22 15:03:56Z boeske
191! Usage of large scale forcing enabled:
192! increase pr_palm from 90 to 100 to allow for more standard profiles
193! + ngp_sums_ls, pt_lsa, pt_subs, q_lsa, q_subs, tmp_tnudge, sums_ls_l,
194! use_subsidence_tendencies
195!
196! 1361 2014-04-16 15:17:48Z hoffmann
197! tend_* removed
198! call_microphysics_at_all_substeps added
199! default of drizzle set to true
200!
201! 1359 2014-04-11 17:15:14Z hoffmann
202! particle_attributes moved to mod_particle_attributes.f90
203!
204! 1353 2014-04-08 15:21:23Z heinze
205! REAL constants provided with KIND-attribute
206!
207! 1327 2014-03-21 11:00:16Z raasch
208! REAL constants defined as wp-kind
209! -avs_output, data_output_format, do3d_compress, iso2d_output, netcdf_output
210!
211! 1320 2014-03-20 08:40:49Z raasch
212! ONLY-attribute added to USE-statements,
213! kind-parameters added to all INTEGER and REAL declaration statements,
214! kinds are defined in new module kinds,
215! old module precision_kind is removed,
216! revision history before 2012 removed,
217! comment fields (!:) to be used for variable explanations added to
218! all variable declaration statements
219!
220! 1318 2014-03-17 13:35:16Z raasch
221! module cpulog moved to new separate module-file
222! interface for cpu_log removed
223!
224! 1314 2014-03-14 18:25:17Z suehring
225! + log_z_z0, number_of_sublayers, z0_av_global
226! 1308 2014-03-13 14:58:42Z fricke
227! +ntdim_2d_xy, ntdim_2d_xz, ntdim_2d_yz, ntdim_3d
228!
229! 1257 2013-11-08 15:18:40Z raasch
230! set default values for grid indices of maximum velocity components
231! u|v|w_max_ijk
232!
233! 1241 2013-10-30 11:36:58Z heinze
234! Usage of nudging enabled
235! +nudging, ntnudge, ptnudge, qnudge, tnudge, unudge, vnudge, wnudge
236! increase pr_palm from 80 to 90 to allow for more standard profiles
237!
238! Enable prescribed time depenend surface fluxes and geostrophic wind read in
239! from external file LSF_DATA
240! +large_scale_forcing, lsf_surf, lsf_vert, nlsf, time_surf, shf_surf, qsws_surf,
241!  pt_surf, q_surf, p_surf, time_vert, ug_vert, vg_vert, wsubs_vert
242!
243! 1221 2013-09-10 08:59:13Z raasch
244! wall_flags_0 changed to 32bit int, +wall_flags_00,
245! +rflags_s_inner, rflags_invers
246!
247! 1216 2013-08-26 09:31:42Z raasch
248! +transpose_compute_overlap,
249! several variables are now defined in the serial (non-parallel) case also
250!
251! 1212 2013-08-15 08:46:27Z raasch
252! +tri
253!
254! 1179 2013-06-14 05:57:58Z raasch
255! +reference_state, ref_state, use_initial_profile_as_reference, vpt_reference,
256! use_reference renamed use_single_reference_value
257!
258! 1159 2013-05-21 11:58:22Z fricke
259! -bc_lr_dirneu, bc_lr_neudir, bc_ns_dirneu, bc_ns_neudir
260! +use_cmax
261!
262! 1128 2013-04-12 06:19:32Z raasch
263! +background_communication, i_left, i_right, j_north, j_south, req, req_count,
264! send_receive, sendrecv_in_background, wait_stat
265!
266! 1115 2013-03-26 18:16:16Z hoffmann
267! unused variables removed
268!
269! 1113 2013-03-10 02:48:14Z raasch
270! +on_device
271!
272! 1111 2013-03-08 23:54:10Z raasch
273! +tric, nr_timesteps_this_run
274!
275! 1106 2013-03-04 05:31:38Z raasch
276! array_kind renamed precision_kind, pdims defined in serial code
277! bugfix: default value assigned to coupling_start_time
278!
279! 1095 2013-02-03 02:21:01Z raasch
280! FORTRAN error in r1092 removed
281!
282! 1092 2013-02-02 11:24:22Z raasch
283! character length in some derived type changed for better alignment
284!
285! 1065 2012-11-22 17:42:36Z hoffmann
286! + c_sedimentation, limiter_sedimentation, turbulence, a_1, a_2, a_3, b_1, b_2,
287! + b_3, c_1, c_2, c_3, beta_cc
288!
289! bottom boundary condition of qr, nr changed from Dirichlet to Neumann
290!
291! 1053 2012-11-13 17:11:03Z hoffmann
292! necessary expansions according to the two new prognostic equations (nr, qr)
293! of the two-moment cloud physics scheme:
294! +*_init, flux_l_*, diss_l_*, flux_s_*, diss_s_*, *sws, *swst, tend_*, *, *_p
295! +t*_m, *_1, *_2, *_3, *_av, bc_*_b, bc_*_t, ibc_*_b, ibc_*_t, bc_*_t_val,
296! +*_vertical_gradient, *_surface_initial_change, *_vertical_gradient_level,
297! +*_vertical_gradient_level_ind, *_surface, constant_waterflux_*, 
298! +cloud_scheme, icloud_scheme, surface_waterflux_*, sums_ws*s_ws_l, wall_*flux
299!
300! constants for the two-moment scheme:
301! +a_vent, a_term, b_vent, b_term, c_evap, c_term, cof, eps_sb, k_cc, k_cr, k_rr,
302! +k_br, kappa_rr, kin_vis_air, mu_constant_value, nc, pirho_l, dpirho_l, rho_1,
303! +schmidt, schmidt_p_1d3, stp, x0, xmin, xmax, dt_precipitation, w_precipitation
304!
305! steering parameters for the two_moment scheme:
306! +mu_constant, ventilation_effect
307!
308! 1036 2012-10-22 13:43:42Z raasch
309! code put under GPL (PALM 3.9)
310!
311! 1031 2012-10-19 14:35:30Z raasch
312! +output_format_netcdf
313!
314! 1015 2012-09-27 09:23:24Z raasch
315! +acc_rank, num_acc_per_node,
316! -adjust_mixing_length
317!
318! 1010 2012-09-20 07:59:54Z raasch
319! pointer free version can be generated with cpp switch __nopointer
320!
321! 1003 2012-09-14 14:35:53Z raasch
322! -grid_matching, nxa, nya, etc., nnx_pe, nny_pe, spl_*
323!
324! 1001 2012-09-13 14:08:46Z raasch
325! -asselin_filter_factor, cut_spline_overshoot, dt_changed, last_dt_change,
326! last_dt_change_1d, long_filter_factor, overshoot_limit_*, ups_limit_*
327! several pointer/target arrays converted to normal ones
328!
329! 996 2012-09-07 10:41:47Z raasch
330! -use_prior_plot1d_parameters
331!
332! 978 2012-08-09 08:28:32Z fricke
333! +c_u_m, c_u_m_l, c_v_m, c_v_m_l, c_w_m, c_w_m_l,
334! +bc_lr_dirneu, bc_lr_neudir, bc_ns_dirneu, bc_ns_neudir
335! -km_damp_x, km_damp_y, km_damp_max, outflow_damping_width
336! +z0h, z0h_av, z0h_factor, z0h1d
337! +ptdf_x, ptdf_y, pt_damping_width, pt_damping_factor
338!
339! 964 2012-07-26 09:14:24Z raasch
340! -cross_linecolors, cross_linestyles, cross_normalized_x, cross_normx_factor,
341! cross_normalized_y, cross_normy_factor, cross_pnc_local,
342! cross_profile_numbers, cross_profile_number_counter, cross_uxmax,
343! cross_uxmax_computed, cross_uxmax_normalized,
344! cross_uxmax_normalized_computed, cross_uxmin, cross_uxmin_computed,
345! cross_uxmin_normalized, cross_uxmin_normalized_computed, cross_uymax,
346! cross_uymin, cross_xtext, dopr_crossindex, dopr_label, linecolors, linestyles,
347! nz_do1d, profil_output, z_max_do1d, z_max_do1d_normalized
348!
349! 951 2012-07-19 14:22:52Z hoffmann
350! changing profile_columns and profile_rows
351!
352! 940 2012-07-09 14:31:00Z raasch
353! +neutral
354!
355! 927 2012-06-06 19:15:04Z raasch
356! +masking_method
357!
358! 880 2012-04-13 06:28:59Z raasch
359! gathered_size, subdomain_size moved to control_parameters
360!
361! 866 2012-03-28 06:44:41Z raasch
362! interface for global_min_max changed
363!
364! 861 2012-03-26 14:18:34Z suehring
365! +wall_flags_0
366! -boundary_flags
367! +nzb_max
368! +adv_sca_1, +adv_mom_1
369!
370! 849 2012-03-15 10:35:09Z raasch
371! +deleted_particles, deleted_tails, tr.._count_sum, tr.._count_recv_sum in
372! particle_attributes,
373! +de_dx, de_dy, de_dz in arrays_3d,
374! first_call_advec_particles renamed first_call_lpm
375!
376! 828 2012-02-21 12:00:36Z raasch
377! +dissipation_classes, radius_classes, use_kernel_tables,
378! particle feature color renamed class
379!
380! 825 2012-02-19 03:03:44Z raasch
381! +bfactor, curvature_solution_effects, eps_ros, molecular_weight_of_water,
382! vanthoff, -b_cond in cloud_parameters,
383! dopts_num increased to 29, particle attributes speed_x|y|z_sgs renamed
384! rvar1|2|3
385! wang_collision_kernel and turbulence_effects_on_collision replaced by
386! collision_kernel, hall_kernel, palm_kernel, wang_kernel
387!
388! 809 2012-01-30 13:32:58Z marongas
389! Bugfix: replaced .AND. and .NOT. with && and ! in the preprocessor directives
390!
391! 807 2012-01-25 11:53:51Z maronga
392! New cpp directive "__check" implemented which is used by check_namelist_files.
393! New parameter check_restart has been defined which is needed by
394! check_namelist_files only.
395!
396! 805 2012-01-17 15:53:28Z franke
397! Bugfix collective_wait must be out of parallel branch for runs in serial mode
398!
399! 801 2012-01-10 17:30:36Z suehring
400! Dimesion of sums_wsus_ws_l, ! sums_wsvs_ws_l, sums_us2_ws_l, sums_vs2_ws_l,
401! sums_ws2_ws_l, sums_wspts_ws_l, sums_wsqs_ws_l, sums_wssas_ws_l increased.
402! for thread-safe summation in advec_ws.
403!
404! RCS Log replace by Id keyword, revision history cleaned up
405!
406! Revision 1.95  2007/02/11 13:18:30  raasch
407! version 3.1b (last under RCS control)
408!
409! Revision 1.1  1997/07/24 11:21:26  raasch
410! Initial revision
411!
412!
413!------------------------------------------------------------------------------!
414! Description:
415! ------------
416!> Definition of all variables
417!>
418!> @todo Add description for each variable
419!------------------------------------------------------------------------------!
420
421
422!------------------------------------------------------------------------------!
423! Description:
424! ------------
425!> Definition of variables for special advection schemes.
426!------------------------------------------------------------------------------!
427 MODULE advection
428 
429    USE kinds
430
431    REAL(wp), DIMENSION(:), ALLOCATABLE   ::  aex, bex, dex, eex
432
433    SAVE
434
435 END MODULE advection
436
437
438!------------------------------------------------------------------------------!
439! Description:
440! ------------
441!> Definition of all arrays defined on the computational grid.
442!------------------------------------------------------------------------------!
443 MODULE arrays_3d
444
445    USE kinds
446
447    REAL(wp), DIMENSION(:), ALLOCATABLE ::                                     &
448          c_u_m, c_u_m_l, c_v_m, c_v_m_l, c_w_m, c_w_m_l, ddzu, ddzu_pres,     &
449          dd2zu, dzu, ddzw, dzw, hyp, inflow_damping_factor, l_grid,           &
450          ptdf_x, ptdf_y, p_surf, pt_surf, pt_init, qsws_surf, q_init, q_surf, &
451          rdf, rdf_sc, ref_state, s_init, s_surf, sa_init, shf_surf,           &
452          timenudge, time_surf, time_vert, tmp_tnudge, ug, u_init,             &
453          u_nzb_p1_for_vfc, vg, v_init, v_nzb_p1_for_vfc, w_subs, zu, zw
454
455    REAL(wp), DIMENSION(:,:), ALLOCATABLE ::                                   &
456          c_u, c_v, c_w, diss_s_e, diss_s_nr, diss_s_pt, diss_s_q,             &
457          diss_s_qr, diss_s_s, diss_s_sa, diss_s_u, diss_s_v, diss_s_w, dzu_mg,&
458          dzw_mg, flux_s_e, flux_s_nr, flux_s_pt, flux_s_q, flux_s_qr,         &
459          flux_s_s, flux_s_sa, flux_s_u, flux_s_v, flux_s_w, f1_mg, f2_mg,     &
460          f3_mg, mean_inflow_profiles, nrs, nrsws, nrswst,                     &
461          ol,                                                                  & !< Obukhov length
462          precipitation_amount, precipitation_rate, ptnudge, pt_slope_ref,     &
463          qnudge, qs, qsws, qswst, qswst_remote, qrs, qrsws, qrswst,           &
464          saswsb, saswst, shf, ss, ssws, sswst, tnudge, td_lsa_lpt, td_lsa_q,  &
465          td_sub_lpt,                                                          &
466          td_sub_q, total_2d_a, total_2d_o, ts, tswst, ug_vert, unudge, us,    &
467          usws, uswst, vnudge, vg_vert, vsws, vswst, wnudge, wsubs_vert,       &
468          z0,                                                                  & !< roughness length for momentum
469          z0h,                                                                 & !< roughness length for heat
470          z0q                                                                    !< roughness length for moisture
471
472    REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::                                 &
473          d, de_dx, de_dy, de_dz, diss, diss_l_e,                              &
474          diss_l_nr, diss_l_pt, diss_l_q, diss_l_qr, diss_l_s, diss_l_sa,      &
475          diss_l_u, diss_l_v, diss_l_w, flux_l_e, flux_l_nr, flux_l_pt,        &
476          flux_l_q, flux_l_qr, flux_l_s, flux_l_sa, flux_l_u, flux_l_v,        &
477          flux_l_w, kh, km, l_wall, prr, p_loc, tend, tric,                    &
478          u_m_l, u_m_n, u_m_r, u_m_s, v_m_l, v_m_n, v_m_r, v_m_s, w_m_l,       &
479          w_m_n, w_m_r, w_m_s
480
481#if defined( __nopointer )
482    REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET ::                         &
483          e, e_p, nr, nr_p, p, prho, pt, pt_p, q, q_p, qc, ql, ql_c, ql_v,     &
484          ql_vp, qr, qr_p, rho_ocean, s, s_p, sa, sa_p, te_m, tnr_m, tpt_m, tq_m,    &
485          tqr_m, ts_m, tsa_m, tu_m, tv_m, tw_m, u, u_p, v, v_p, vpt, w, w_p
486#else
487    REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET ::                         &
488          e_1, e_2, e_3, p, prho_1, nr_1, nr_2, nr_3, pt_1, pt_2, pt_3, q_1,   &
489          q_2, q_3, qc_1, ql_v, ql_vp, ql_1, ql_2, qr_1, qr_2, qr_3, rho_1,    &
490          s_1, s_2, s_3, sa_1, sa_2, sa_3, u_1, u_2, u_3, v_1, v_2, v_3, vpt_1,&
491          w_1, w_2, w_3
492
493    REAL(wp), DIMENSION(:,:,:), POINTER ::                                     &
494          e, e_p, nr, nr_p, prho, pt, pt_p, q, q_p, qc, ql, ql_c, qr, qr_p,    &
495          rho_ocean, s, s_p, sa, sa_p, te_m, tnr_m, tpt_m, tq_m, tqr_m, ts_m,        &
496          tsa_m, tu_m, tv_m, tw_m, u, u_p, v, v_p, vpt, w, w_p
497#endif
498
499    REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE ::  rif_wall, tri
500
501    REAL(wp), DIMENSION(:), ALLOCATABLE :: rho_air     !< air density profile on the uv grid
502    REAL(wp), DIMENSION(:), ALLOCATABLE :: rho_air_zw  !< air density profile on the w grid
503    REAL(wp), DIMENSION(:), ALLOCATABLE :: drho_air    !< inverse air density profile on the uv grid
504    REAL(wp), DIMENSION(:), ALLOCATABLE :: drho_air_zw !< inverse air density profile on the w grid
505
506    REAL(wp), DIMENSION(:,:), ALLOCATABLE :: rho_air_mg    !< air density profiles on the uv grid for multigrid
507    REAL(wp), DIMENSION(:,:), ALLOCATABLE :: rho_air_zw_mg !< air density profiles on the w grid for multigrid
508
509    REAL(wp), DIMENSION(:), ALLOCATABLE :: heatflux_input_conversion      !< conversion factor array for heatflux input
510    REAL(wp), DIMENSION(:), ALLOCATABLE :: waterflux_input_conversion     !< conversion factor array for waterflux input
511    REAL(wp), DIMENSION(:), ALLOCATABLE :: momentumflux_input_conversion  !< conversion factor array for momentumflux input
512    REAL(wp), DIMENSION(:), ALLOCATABLE :: heatflux_output_conversion     !< conversion factor array for heatflux output
513    REAL(wp), DIMENSION(:), ALLOCATABLE :: waterflux_output_conversion    !< conversion factor array for waterflux output
514    REAL(wp), DIMENSION(:), ALLOCATABLE :: momentumflux_output_conversion !< conversion factor array for momentumflux output
515
516
517    SAVE
518
519 END MODULE arrays_3d
520
521
522!------------------------------------------------------------------------------!
523! Description:
524! ------------
525!> Definition of variables needed for time-averaging of 2d/3d data.
526!------------------------------------------------------------------------------!
527 MODULE averaging
528 
529    USE kinds
530
531    REAL(wp), DIMENSION(:,:), ALLOCATABLE ::  lwp_av,                & !< Avg. liquid water path
532                                              precipitation_rate_av, & !< Avg. of precipitation rate
533                                              ol_av,                 & !< Avg. of Obukhov length
534                                              qsws_av,               & !< Avg. of surface moisture flux
535                                              ssws_av,               & !< Avg. of surface scalar flux
536                                              shf_av,                & !< Avg. of surface heat flux
537                                              ts_av,                 & !< Avg. of characteristic temperature scale
538                                              us_av,                 & !< Avg. of friction velocity
539                                              z0_av,                 & !< Avg. of roughness length for momentum
540                                              z0h_av,                & !< Avg. of roughness length for heat
541                                              z0q_av                   !< Avg. of roughness length for moisture
542
543    REAL(wp), DIMENSION(:,:,:), ALLOCATABLE, TARGET ::                         &
544          e_av, lpt_av, nr_av, p_av, pc_av, pr_av, prr_av, pt_av, q_av, qc_av, &
545          ql_av, ql_c_av, ql_v_av, ql_vp_av, qr_av, qv_av, rho_ocean_av, s_av, sa_av,&
546          u_av, v_av, vpt_av, w_av
547 
548 END MODULE averaging
549
550
551!------------------------------------------------------------------------------!
552! Description:
553! ------------
554!> Definition of variables and constants for cloud physics.
555!------------------------------------------------------------------------------!
556 MODULE cloud_parameters
557 
558    USE kinds
559
560    REAL(wp) :: cp = 1005.0_wp,       & !< heat capacity of dry air (J kg-1 K-1)
561                l_v = 2.5E+06_wp,     & !< latent heat of vaporization (J kg-1)
562                l_d_cp, l_d_r, l_d_rv, & !< l_v / cp, l_v / r_d, l_v / r_v
563                rho_l = 1.0E3_wp,     & !< density of water (kg m-3)
564                r_d = 287.0_wp,       & !< sp. gas const. dry air (J kg-1 K-1)
565                r_v = 461.51_wp         !< sp. gas const. water vapor (J kg-1 K-1)
566
567
568    REAL(wp), DIMENSION(:), ALLOCATABLE     ::  hyrho, pt_d_t, t_d_pt 
569
570    SAVE
571
572 END MODULE cloud_parameters
573
574
575!------------------------------------------------------------------------------!
576! Description:
577! ------------
578!> Definition of general constants.
579!------------------------------------------------------------------------------!
580 MODULE constants
581 
582    USE kinds
583
584    REAL(wp)  ::  pi = 3.141592654_wp
585    REAL(wp)  ::  adv_mom_1, adv_mom_3, adv_mom_5, adv_sca_1, adv_sca_3, adv_sca_5
586   
587
588    SAVE
589
590 END MODULE constants
591
592 
593!------------------------------------------------------------------------------!
594! Description:
595! ------------
596!> Definition of parameters for program control
597!------------------------------------------------------------------------------!
598 MODULE control_parameters
599
600    USE kinds
601
602    TYPE plot_precision
603       CHARACTER (LEN=8) ::  variable
604       INTEGER(iwp)      ::  precision
605    END TYPE plot_precision
606
607    TYPE(plot_precision), DIMENSION(100) ::  plot_3d_precision =               &
608                        (/ plot_precision( 'u', 2 ), plot_precision( 'v', 2 ), &
609                           plot_precision( 'w', 2 ), plot_precision( 'p', 5 ), &
610                           plot_precision( 'pt', 2 ),                          &
611                           ( plot_precision( ' ', 1 ), i9 = 1,95 ) /)
612
613    TYPE file_status
614       LOGICAL ::  opened, opened_before
615    END TYPE file_status
616   
617    INTEGER, PARAMETER :: mask_xyz_dimension = 100, max_masks = 50
618    INTEGER(iwp), PARAMETER ::  varnamelength = 30  !< length of output variable names
619
620    TYPE(file_status), DIMENSION(200+2*max_masks) ::                &
621                             openfile = file_status(.FALSE.,.FALSE.)
622
623    CHARACTER (LEN=1)    ::  cycle_mg = 'w', timestep_reason = ' '
624    CHARACTER (LEN=3)    ::  coupling_char = ''
625    CHARACTER (LEN=5)    ::  write_binary = 'false'
626    CHARACTER (LEN=8)    ::  most_method = 'lookup', & !< NAMELIST parameter defining method to be used to calculate Okukhov length,
627                             run_date,               & !<
628                             run_time                  !<
629    CHARACTER (LEN=9)    ::  simulated_time_chr
630    CHARACTER (LEN=11)   ::  topography_grid_convention = ' '
631    CHARACTER (LEN=12)   ::  version = ' ', revision = ' ', &
632                             user_interface_current_revision = ' ', &
633                             user_interface_required_revision = ' '
634    CHARACTER (LEN=16)   ::  conserve_volume_flow_mode = 'default', &
635                             loop_optimization = 'default', &
636                             momentum_advec = 'ws-scheme', &
637                             psolver = 'poisfft', &
638                             scalar_advec = 'ws-scheme'
639    CHARACTER (LEN=20)   ::  approximation = 'boussinesq'
640    CHARACTER (LEN=40)   ::  flux_input_mode = 'approximation-specific'
641    CHARACTER (LEN=40)   ::  flux_output_mode = 'approximation-specific'
642    CHARACTER (LEN=20)   ::  bc_e_b = 'neumann', bc_lr = 'cyclic', &
643                             bc_ns = 'cyclic', bc_p_b = 'neumann', &
644                             bc_p_t = 'dirichlet', bc_pt_b = 'dirichlet', &
645                             bc_pt_t = 'initial_gradient', &
646                             bc_q_b = 'dirichlet', bc_q_t = 'neumann', &
647                             bc_s_b = 'dirichlet', bc_s_t = 'initial_gradient', &
648                             bc_sa_t = 'neumann', &
649                             bc_uv_b = 'dirichlet', bc_uv_t = 'dirichlet', &
650                             cloud_scheme = 'saturation_adjust', &
651                             coupling_mode = 'uncoupled', &
652                             coupling_mode_remote = 'uncoupled', &
653                             dissipation_1d = 'detering', &
654                             fft_method = 'system-specific', &
655                             mixing_length_1d = 'blackadar', &
656                             random_generator = 'numerical-recipes', &
657                             reference_state = 'initial_profile', &
658                             return_addres, return_username, &
659                             timestep_scheme = 'runge-kutta-3'                             
660    CHARACTER (LEN=40)   ::  avs_data_file, topography = 'flat'
661    CHARACTER (LEN=64)   ::  host = ' '
662    CHARACTER (LEN=80)   ::  log_message, run_identifier
663    CHARACTER (LEN=100)  ::  initializing_actions = ' ' 
664    CHARACTER (LEN=110)  ::  run_description_header
665    CHARACTER (LEN=1000) ::  message_string = ' '
666
667    CHARACTER (LEN=varnamelength), DIMENSION(500) ::  data_output = ' ',    &
668                                           data_output_user = ' ', doav = ' '
669    CHARACTER (LEN=varnamelength), DIMENSION(max_masks,100) ::  &
670         data_output_masks = ' ', data_output_masks_user = ' '
671
672    CHARACTER (LEN=varnamelength), DIMENSION(300) ::  data_output_pr = ' '
673    CHARACTER (LEN=varnamelength), DIMENSION(200) ::  data_output_pr_user = ' '
674    CHARACTER (LEN=varnamelength), DIMENSION(max_masks,0:1,100) ::  domask = ' '
675    CHARACTER (LEN=varnamelength), DIMENSION(0:1,500) ::  do2d = ' ', do3d = ' '
676
677    INTEGER(iwp), PARAMETER :: fl_max = 100, var_fl_max = 20
678   
679    INTEGER(iwp) ::  abort_mode = 1, average_count_pr = 0, &
680                     average_count_3d = 0, current_timestep_number = 0, &
681                     coupling_topology = 0, &
682                     dist_range = 0, disturbance_level_ind_b, &
683                     disturbance_level_ind_t, doav_n = 0, dopr_n = 0, &
684                     dopr_time_count = 0, dopts_time_count = 0, &
685                     dots_time_count = 0, &
686                     do2d_xy_n = 0, do2d_xz_n = 0, do2d_yz_n = 0, do3d_avs_n = 0, &
687                     dp_level_ind_b = 0, dvrp_filecount = 0, &
688                     dz_stretch_level_index, ensemble_member_nr = 0, gamma_mg, gathered_size, &
689                     grid_level, ibc_e_b, ibc_p_b, ibc_p_t, &
690                     ibc_pt_b, ibc_pt_t, ibc_q_b, ibc_q_t, ibc_s_b, ibc_s_t, &
691                     ibc_sa_t, ibc_uv_b, ibc_uv_t, &
692                     inflow_disturbance_begin = -1, inflow_disturbance_end = -1, &
693                     intermediate_timestep_count, intermediate_timestep_count_max, &
694                     io_group = 0, io_blocks = 1, iran = -1234567, &
695                     masks = 0, maximum_grid_level, &
696                     maximum_parallel_io_streams = -1, max_pr_user = 0, &
697                     mgcycles = 0, mg_cycles = -1, mg_switch_to_pe0_level = -1, mid, &
698                     nlsf = 1000, ntnudge = 1000, ngsrb = 2, &
699                     nr_timesteps_this_run = 0, &
700                     nsor = 20, nsor_ini = 100, n_sor, normalizing_region = 0, &
701                     num_leg=0, num_var_fl, num_var_fl_user=0, &
702                     nz_do3d = -9999, prt_time_count = 0, &
703                     recycling_plane, runnr = 0, &
704                     skip_do_avs = 0, subdomain_size, terminate_coupled = 0, &
705                     terminate_coupled_remote = 0, timestep_count = 0
706
707    INTEGER(iwp) ::  dist_nxl(0:1), dist_nxr(0:1), dist_nyn(0:1), dist_nys(0:1), &
708                     do2d_no(0:1) = 0, do2d_xy_time_count(0:1), &
709                     do2d_xz_time_count(0:1), do2d_yz_time_count(0:1), &
710                     do3d_no(0:1) = 0, do3d_time_count(0:1), &
711                     domask_no(max_masks,0:1) = 0, domask_time_count(max_masks,0:1),&
712                     mask_size(max_masks,3) = -1, mask_size_l(max_masks,3) = -1, &
713                     mask_start_l(max_masks,3) = -1, &
714                     pt_vertical_gradient_level_ind(10) = -9999, &
715                     q_vertical_gradient_level_ind(10) = -9999, &
716                     s_vertical_gradient_level_ind(10) = -9999, &                     
717                     sa_vertical_gradient_level_ind(10) = -9999, &
718                     section(100,3), section_xy(100) = -9999, &
719                     section_xz(100) = -9999, section_yz(100) = -9999, &
720                     ug_vertical_gradient_level_ind(10) = -9999, &
721                     vg_vertical_gradient_level_ind(10) = -9999, &
722                     subs_vertical_gradient_level_i(10) = -9999
723
724
725    INTEGER(iwp), DIMENSION(0:1) :: ntdim_2d_xy, ntdim_2d_xz, ntdim_2d_yz, ntdim_3d
726
727    INTEGER(iwp), DIMENSION(:), ALLOCATABLE ::  grid_level_count
728
729    INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE   ::  mask_i, mask_j, mask_k
730    INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE   ::  &
731                    mask_i_global, mask_j_global, mask_k_global
732
733    LOGICAL ::  bc_lr_cyc =.TRUE., bc_lr_dirrad = .FALSE., &
734                bc_lr_raddir = .FALSE., bc_ns_cyc = .TRUE., &
735                bc_ns_dirrad = .FALSE., bc_ns_raddir = .FALSE.,&
736                call_microphysics_at_all_substeps = .FALSE., &
737                call_psolver_at_all_substeps = .TRUE., &
738                cloud_droplets = .FALSE., cloud_physics = .FALSE., &
739                cloud_top_radiation = .FALSE., &
740                conserve_volume_flow = .FALSE., constant_diffusion = .FALSE., &
741                constant_flux_layer = .TRUE., &
742                constant_heatflux = .TRUE., constant_top_heatflux = .TRUE., &
743                constant_top_momentumflux = .FALSE., &
744                constant_top_salinityflux = .TRUE., &
745                constant_top_scalarflux = .TRUE., &
746                constant_scalarflux = .TRUE., &             
747                constant_waterflux = .TRUE., create_disturbances = .TRUE., &
748                data_output_2d_on_each_pe = .TRUE., & 
749                dissipation_control = .FALSE., disturbance_created = .FALSE., &
750                do2d_at_begin = .FALSE., do3d_at_begin = .FALSE., &
751                do_sum = .FALSE., &
752                dp_external = .FALSE., dp_smooth = .FALSE., &
753                dt_fixed = .FALSE., &
754                dt_3d_reached, dt_3d_reached_l, exchange_mg = .FALSE., &
755                first_call_lpm = .TRUE., &
756                force_print_header = .FALSE., galilei_transformation = .FALSE.,&
757                humidity = .FALSE., humidity_remote = .FALSE., &
758                inflow_l = .FALSE., inflow_n = .FALSE., &
759                inflow_r = .FALSE., inflow_s = .FALSE., &
760                large_scale_forcing = .FALSE., &
761                large_scale_subsidence = .FALSE.
762    LOGICAL ::  lsf_exception = .FALSE.  !< temporary flag for use of lsf with buildings on flat terrain
763    LOGICAL ::  lsf_surf = .TRUE., &
764                lsf_vert = .TRUE., lptnudge = .FALSE., lqnudge = .FALSE., &
765                lunudge = .FALSE., lvnudge = .FALSE., lwnudge = .FALSE., &
766                masking_method = .FALSE., &
767                microphysics_sat_adjust = .FALSE., &
768                microphysics_kessler = .FALSE., &
769                microphysics_seifert = .FALSE., &
770                mg_switch_to_pe0 = .FALSE., &
771                monotonic_adjustment = .FALSE.
772    LOGICAL ::  nest_bound_l = .FALSE. !< nested boundary on left side
773    LOGICAL ::  nest_bound_n = .FALSE. !< nested boundary on north side
774    LOGICAL ::  nest_bound_r = .FALSE. !< nested boundary on right side
775    LOGICAL ::  nest_bound_s = .FALSE. !< nested boundary on south side
776    LOGICAL ::  nest_domain  = .FALSE. !< domain is nested into a parent domain
777    LOGICAL ::  neutral = .FALSE., nudging = .FALSE., &
778                ocean = .FALSE., on_device = .FALSE., &
779                outflow_l = .FALSE., outflow_n = .FALSE., outflow_r = .FALSE., &
780                outflow_s = .FALSE., passive_scalar = .FALSE., &
781                precipitation = .FALSE., &
782                random_heatflux = .FALSE., recycling_yshift = .FALSE.,&
783                run_control_header = .FALSE., run_coupled = .TRUE., &
784                scalar_rayleigh_damping = .TRUE., sloping_surface = .FALSE., &
785                stop_dt = .FALSE., synchronous_exchange = .FALSE., &
786                terminate_run = .FALSE., transpose_compute_overlap = .FALSE., &
787                turbulent_inflow = .FALSE.
788    LOGICAL ::  turbulent_outflow = .FALSE. !< flag for turbulent outflow condition
789    LOGICAL ::  urban_surface = .FALSE.  !< flag for urban surface model
790    LOGICAL ::  use_cmax = .TRUE., use_initial_profile_as_reference = .FALSE., &
791                use_prescribed_profile_data = .FALSE., &
792                use_single_reference_value = .FALSE., &
793                use_subsidence_tendencies = .FALSE., &
794                use_surface_fluxes = .FALSE., use_top_fluxes = .FALSE., &
795                use_ug_for_galilei_tr = .TRUE., use_upstream_for_tke = .FALSE.
796    LOGICAL ::  virtual_flight = .FALSE.  !< flag for virtual flight model
797    LOGICAL ::  wall_adjustment = .TRUE., ws_scheme_sca = .FALSE., &
798                ws_scheme_mom = .FALSE.
799
800    LOGICAL ::  data_output_xy(0:1) = .FALSE., data_output_xz(0:1) = .FALSE., &
801                data_output_yz(0:1) = .FALSE.
802
803    REAL(wp) ::  advected_distance_x = 0.0_wp, advected_distance_y = 0.0_wp, &
804                 alpha_surface = 0.0_wp, atmos_ocean_sign = 1.0_wp, &
805                 averaging_interval = 0.0_wp, averaging_interval_pr = 9999999.9_wp, &
806                 bc_pt_t_val, bc_q_t_val, bc_s_t_val, bottom_salinityflux = 0.0_wp, &
807                 building_height = 50.0_wp, building_length_x = 50.0_wp, &
808                 building_length_y = 50.0_wp, building_wall_left = 9999999.9_wp, &
809                 building_wall_south = 9999999.9_wp, canyon_height = 50.0_wp, &
810                 canyon_width_x = 9999999.9_wp, canyon_width_y = 9999999.9_wp, &
811                 canyon_wall_left = 9999999.9_wp, canyon_wall_south = 9999999.9_wp, &
812                 cfl_factor = -1.0_wp, cos_alpha_surface, &
813                 coupling_start_time = 0.0_wp, disturbance_amplitude = 0.25_wp, &
814                 disturbance_energy_limit = 0.01_wp, &
815                 disturbance_level_b = -9999999.9_wp, &
816                 disturbance_level_t = -9999999.9_wp, &
817                 dp_level_b = 0.0_wp, &
818                 dt = -1.0_wp, dt_averaging_input = 0.0_wp, &
819                 dt_averaging_input_pr = 9999999.9_wp, dt_coupling = 9999999.9_wp, &
820                 dt_data_output = 9999999.9_wp, &
821                 dt_data_output_av = 9999999.9_wp, dt_disturb = 9999999.9_wp, &
822                 dt_dopr = 9999999.9_wp, dt_dopr_listing = 9999999.9_wp, &
823                 dt_dopts = 9999999.9_wp, dt_dots = 9999999.9_wp, &
824                 dt_do2d_xy = 9999999.9_wp, dt_do2d_xz = 9999999.9_wp, &
825                 dt_do2d_yz = 9999999.9_wp, dt_do3d = 9999999.9_wp, dt_dvrp = 9999999.9_wp, &
826                 dt_max = 20.0_wp, &
827                 dt_restart = 9999999.9_wp, &
828                 dt_run_control = 60.0_wp, dt_3d = 1.0_wp, dz = -1.0_wp, &
829                 dz_max = 9999999.9_wp, dz_stretch_factor = 1.08_wp, &
830                 dz_stretch_level = 100000.0_wp, e_init = 0.0_wp, e_min = 0.0_wp, &
831                 end_time = 0.0_wp, &
832                 f = 0.0_wp, fs = 0.0_wp, g = 9.81_wp, inflow_damping_height = 9999999.9_wp, &
833                 inflow_damping_width = 9999999.9_wp, kappa = 0.4_wp, km_constant = -1.0_wp,&
834                 mask_scale_x = 1.0_wp, mask_scale_y = 1.0_wp, mask_scale_z = 1.0_wp, &
835                 maximum_cpu_time_allowed = 0.0_wp,  &
836                 molecular_viscosity = 1.461E-5_wp, &
837                 old_dt = 1.0E-10_wp, omega = 7.29212E-5_wp, omega_sor = 1.8_wp, &
838                 outflow_source_plane = -9999999.9_wp, & !< x-position of outflow-source plane (turbulent outflow method)
839                 particle_maximum_age = 9999999.9_wp, &
840                 phi = 55.0_wp, prandtl_number = 1.0_wp, &
841                 precipitation_amount_interval = 9999999.9_wp, prho_reference, &
842                 pt_damping_factor = 0.0_wp, pt_damping_width = 0.0_wp, &
843                 pt_reference = 9999999.9_wp, pt_slope_offset = 0.0_wp, &
844                 pt_surface = 300.0_wp, pt_surface_initial_change = 0.0_wp, &
845                 q_surface = 0.0_wp, q_surface_initial_change = 0.0_wp, &
846                 rayleigh_damping_factor = -1.0_wp, rayleigh_damping_height = -1.0_wp, &
847                 recycling_width = 9999999.9_wp, residual_limit = 1.0E-4_wp, &
848                 restart_time = 9999999.9_wp, rho_reference, rho_surface, &
849                 roughness_length = 0.1_wp, &
850                 sa_surface = 35.0_wp, &
851                 simulated_time = 0.0_wp, simulated_time_at_begin, sin_alpha_surface, &
852                 skip_time_data_output = 0.0_wp, skip_time_data_output_av = 9999999.9_wp,&
853                 skip_time_dopr = 9999999.9_wp, &
854                 skip_time_do2d_xy = 9999999.9_wp, skip_time_do2d_xz = 9999999.9_wp, &
855                 skip_time_do2d_yz = 9999999.9_wp, skip_time_do3d = 9999999.9_wp, &
856                 surface_heatflux = 9999999.9_wp, surface_pressure = 1013.25_wp, &
857                 surface_scalarflux = 9999999.9_wp, surface_waterflux = 9999999.9_wp, &
858                 s_surface = 0.0_wp, s_surface_initial_change = 0.0_wp, &
859                 termination_time_needed = -1.0_wp, time_coupling = 0.0_wp, &
860                 time_disturb = 0.0_wp, time_dopr = 0.0_wp, time_dopr_av = 0.0_wp, &
861                 time_dopr_listing = 0.0_wp, time_dopts = 0.0_wp, time_dosp = 0.0_wp, &
862                 time_dosp_av = 0.0_wp, time_dots = 0.0_wp, time_do2d_xy = 0.0_wp, &
863                 time_do2d_xz = 0.0_wp, time_do2d_yz = 0.0_wp, time_do3d = 0.0_wp, &
864                 time_do_av = 0.0_wp, time_do_sla = 0.0_wp, time_dvrp = 0.0_wp, &
865                 time_restart = 9999999.9_wp, time_run_control = 0.0_wp,&
866                 time_since_reference_point, top_heatflux = 9999999.9_wp, &
867                 top_momentumflux_u = 9999999.9_wp, &
868                 top_momentumflux_v = 9999999.9_wp, top_salinityflux = 9999999.9_wp, &
869                 top_scalarflux = 9999999.9_wp, &
870                 ug_surface = 0.0_wp, u_bulk = 0.0_wp, u_gtrans = 0.0_wp, &
871                 vg_surface = 0.0_wp, vpt_reference = 9999999.9_wp, &
872                 v_bulk = 0.0_wp, v_gtrans = 0.0_wp, wall_adjustment_factor = 1.8_wp, &
873                 zeta_max = 20.0_wp,    & !< Maximum value of zeta = z/L
874                 zeta_min = -9990.0_wp, & !< Minimum value of zeta = z/L
875                 z_max_do2d = -1.0_wp, z0h_factor = 1.0_wp
876
877    REAL(wp) ::  do2d_xy_last_time(0:1) = -1.0_wp, do2d_xz_last_time(0:1) = -1.0_wp, &
878                 do2d_yz_last_time(0:1) = -1.0_wp, dpdxy(1:2) = 0.0_wp, &
879                 dt_domask(max_masks) = 9999999.9_wp, &
880                 mask_scale(3), &
881                 pt_vertical_gradient(10) = 0.0_wp, &
882                 pt_vertical_gradient_level(10) = -1.0_wp, &
883                 q_vertical_gradient(10) = 0.0_wp, &
884                 q_vertical_gradient_level(10) = -1.0_wp, &
885                 s_vertical_gradient(10) = 0.0_wp, &
886                 s_vertical_gradient_level(10) = -1.0_wp, &
887                 sa_vertical_gradient(10) = 0.0_wp, &
888                 sa_vertical_gradient_level(10) = -1.0_wp, &
889                 skip_time_domask(max_masks) = 9999999.9_wp, threshold(20) = 0.0_wp, &
890                 time_domask(max_masks) = 0.0_wp, &
891                 tsc(10) = (/ 1.0_wp, 1.0_wp, 0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp, 0.0_wp /), &
892                 u_profile(100) = 9999999.9_wp, uv_heights(100) = 9999999.9_wp, &
893                 v_profile(100) = 9999999.9_wp, &
894                 ug_vertical_gradient(10) = 0.0_wp, &
895                 ug_vertical_gradient_level(10) = -9999999.9_wp, &
896                 vg_vertical_gradient(10) = 0.0_wp, &
897                 vg_vertical_gradient_level(10) = -9999999.9_wp, &
898                 volume_flow(1:3) = 0.0_wp, volume_flow_area(1:3) = 0.0_wp, &
899                 volume_flow_initial(1:3) = 0.0_wp, wall_heatflux(0:4) = 0.0_wp, &
900                 wall_humidityflux(0:4) = 0.0_wp, wall_nrflux(0:4) = 0.0_wp, &
901                 wall_qflux(0:4) = 0.0_wp, wall_qrflux(0:4) = 0.0_wp, &
902                 wall_salinityflux(0:4) = 0.0_wp, wall_sflux(0:4) = 0.0_wp, wall_scalarflux(0:4) = 0.0_wp, &
903                 subs_vertical_gradient(10) = 0.0_wp, &
904                 subs_vertical_gradient_level(10) = -9999999.9_wp
905
906    REAL(wp), DIMENSION(:), ALLOCATABLE ::  dp_smooth_factor
907
908    REAL(wp), DIMENSION(max_masks,mask_xyz_dimension) :: &
909            mask_x = -1.0_wp, mask_y = -1.0_wp, mask_z = -1.0_wp
910    REAL(wp), DIMENSION(max_masks,3) ::                  &
911            mask_x_loop = -1.0_wp, mask_y_loop = -1.0_wp, mask_z_loop = -1.0_wp
912   
913!
914!--    internal mask arrays ("mask,dimension,selection")
915       REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  mask, mask_loop
916
917    SAVE
918
919 END MODULE control_parameters
920
921
922!------------------------------------------------------------------------------!
923! Description:
924! ------------
925!> Definition of variables used with dvrp-software.
926!------------------------------------------------------------------------------!
927 MODULE dvrp_variables
928
929     USE kinds
930
931    CHARACTER (LEN=10) ::  dvrp_output = 'rtsp', particle_color = 'none', &
932                           particle_dvrpsize = 'none'
933
934    CHARACTER (LEN=20), DIMENSION(10) ::  mode_dvrp = &
935                                     (/ ( '                    ', i9 = 1,10 ) /)
936
937    CHARACTER (LEN=80) ::  dvrp_directory = 'default',                    &
938                           dvrp_file      = 'default',                    &
939                           dvrp_host      = 'origin.rvs.uni-hannover.de', &
940                           dvrp_password  = '********',                   &
941                           dvrp_username  = ' '
942
943    INTEGER(iwp) ::  cluster_size = 1, dvrp_colortable_entries = 4,                 &
944                     dvrp_colortable_entries_prt = 22, islice_dvrp,                 &
945                     nx_dvrp, nxl_dvrp, nxr_dvrp, ny_dvrp, nyn_dvrp, nys_dvrp,      &
946                     nz_dvrp, pathlines_fadeintime = 5, pathlines_fadeouttime = 5,  &
947                     pathlines_linecount = 1000, pathlines_maxhistory = 40,         &
948                     pathlines_wavecount = 10, pathlines_wavetime = 50,             &
949                     vc_gradient_normals = 0, vc_mode = 0, vc_size_x = 2,           &
950                     vc_size_y = 2, vc_size_z = 2
951
952    INTEGER(iwp), DIMENSION(10) ::  slicer_position_dvrp
953
954    LOGICAL ::  cyclic_dvrp = .FALSE., dvrp_overlap, dvrp_total_overlap, &
955                local_dvrserver_running, lock_steering_update = .FALSE., &
956                use_seperate_pe_for_dvrp_output = .FALSE.
957
958    REAL(wp)    ::  clip_dvrp_l = 9999999.9_wp, clip_dvrp_n = 9999999.9_wp, &
959                    clip_dvrp_r = 9999999.9_wp, clip_dvrp_s = 9999999.9_wp, &
960                    superelevation = 1.0_wp, superelevation_x = 1.0_wp,     &
961                    superelevation_y = 1.0_wp, vc_alpha = 38.0_wp
962
963    REAL(wp), DIMENSION(2) ::  color_interval = (/ 0.0_wp, 1.0_wp /), &
964                               dvrpsize_interval = (/ 0.0_wp, 1.0_wp /)
965
966    REAL(wp), DIMENSION(3) ::  groundplate_color = (/ 0.0_wp, 0.6_wp, 0.0_wp /), &
967                               topography_color = (/ 0.8_wp, 0.7_wp, 0.6_wp /)
968
969    REAL(wp), DIMENSION(2,10)     ::  slicer_range_limits_dvrp
970
971    REAL(wp), DIMENSION(3,10)     ::  isosurface_color
972
973    REAL(sp), DIMENSION(2,100) ::  interval_values_dvrp,                       &
974                                   interval_values_dvrp_prt, interval_h_dvrp,  &
975                                   interval_h_dvrp_prt, interval_l_dvrp = 0.5_sp, &
976                                   interval_l_dvrp_prt = 0.5_sp, interval_s_dvrp = 1.0_sp, &
977                                   interval_s_dvrp_prt = 1.0_sp, interval_a_dvrp = 0.0_sp, &
978                                   interval_a_dvrp_prt = 0.0_sp
979
980    DATA  slicer_range_limits_dvrp / -1.0_wp, 1.0_wp, -1.0_wp, 1.0_wp, -1.0_wp, 1.0_wp, &
981                                     -1.0_wp, 1.0_wp, -1.0_wp, 1.0_wp, -1.0_wp, 1.0_wp, &
982                                     -1.0_wp, 1.0_wp, -1.0_wp, 1.0_wp, -1.0_wp, 1.0_wp, &
983                                     -1.0_wp, 1.0_wp /
984
985    DATA  isosurface_color / 0.9_wp, 0.9_wp, 0.9_wp,  0.8_wp, 0.1_wp, 0.1_wp,  0.1_wp, 0.1_wp, 0.8_wp, &
986                             0.1_wp, 0.8_wp, 0.1_wp,  0.6_wp, 0.1_wp, 0.1_wp,  0.1_wp, 0.1_wp, 0.6_wp, &
987                             0.1_wp, 0.6_wp, 0.1_wp,  0.4_wp, 0.1_wp, 0.1_wp,  0.1_wp, 0.1_wp, 0.4_wp, &
988                             0.1_wp, 0.4_wp, 0.1_wp /
989
990    DATA  interval_h_dvrp / 270.0_wp, 225.0_wp, 225.0_wp, 180.0_wp, 70.0_wp, 25.0_wp, &
991                            25.0_wp, -25.0_wp, 192 * 0.0_wp /
992
993    DATA  interval_h_dvrp_prt / 270.0_wp, 225.0_wp, 225.0_wp, 180.0_wp, 70.0_wp, 25.0_wp, &
994                                25.0_wp, -25.0_wp, 192 * 0.0_wp /
995
996    REAL(sp), DIMENSION(:), ALLOCATABLE ::  xcoor_dvrp, ycoor_dvrp, zcoor_dvrp
997
998    TYPE steering
999       CHARACTER (LEN=24) ::  name
1000       REAL(sp)           ::  min, max
1001       INTEGER(iwp)       ::  imin, imax
1002    END TYPE steering
1003
1004    TYPE(steering), DIMENSION(:), ALLOCATABLE ::  steering_dvrp
1005
1006    SAVE
1007
1008 END MODULE dvrp_variables
1009
1010
1011!------------------------------------------------------------------------------!
1012! Description:
1013! ------------
1014!> Definition of grid spacings.
1015!------------------------------------------------------------------------------!
1016 MODULE grid_variables
1017
1018    USE kinds
1019
1020    REAL(wp) ::  ddx, ddx2, dx = 1.0_wp, dx2, ddy, ddy2, dy = 1.0_wp, dy2
1021
1022    REAL(wp), DIMENSION(:), ALLOCATABLE ::  ddx2_mg, ddy2_mg
1023
1024    REAL(wp), DIMENSION(:,:), ALLOCATABLE ::  fwxm, fwxp, fwym, fwyp, fxm, fxp,   &
1025                                              fym, fyp, wall_e_x, wall_e_y,       &
1026                                              wall_u, wall_v, wall_w_x, wall_w_y, &
1027                                              zu_s_inner, zw_w_inner
1028
1029    SAVE
1030
1031 END MODULE grid_variables
1032
1033
1034!------------------------------------------------------------------------------!
1035! Description:
1036! ------------
1037!> Definition of array bounds, number of gridpoints, and wall flag arrays.
1038!------------------------------------------------------------------------------!
1039 MODULE indices
1040
1041    USE kinds
1042
1043    INTEGER(iwp) ::  i_left, i_right, j_north, j_south, nbgp = 3, ngp_sums,         &
1044                     ngp_sums_ls, nnx, nx = 0, nx_a, nx_o, nxl, nxlg, nxlu, nxr,    &
1045                     nxrg, nx_on_file, nny, ny = 0, ny_a, ny_o, nyn, nyng, nys,     &
1046                     nysg, nysv, ny_on_file, nnz, nz = 0, nzb, nzb_diff, nzb_max,   &
1047                     nzt, nzt_diff
1048
1049
1050    INTEGER(idp), DIMENSION(:), ALLOCATABLE ::      &
1051                ngp_3d, ngp_3d_inner   ! need to have 64 bit for grids > 2E9
1052
1053    INTEGER(iwp), DIMENSION(:), ALLOCATABLE ::                                  &
1054                   ngp_2dh, nxl_mg, nxr_mg, nyn_mg, nys_mg, nzt_mg
1055
1056
1057    INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: ngp_2dh_outer, ngp_2dh_s_inner,  &
1058                   mg_loc_ind, nzb_diff_s_inner, nzb_diff_s_outer, nzb_diff_u,    &
1059                   nzb_diff_v, nzb_inner, nzb_outer, nzb_s_inner, nzb_s_outer,    &
1060                   nzb_u_inner, nzb_u_outer, nzb_v_inner, nzb_v_outer,            &
1061                   nzb_w_inner, nzb_w_outer
1062
1063    INTEGER(iwp), DIMENSION(:,:,:), POINTER ::  flags
1064
1065    INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE ::  wall_flags_0, wall_flags_00
1066
1067    INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE,  TARGET ::                       &
1068                   wall_flags_1, wall_flags_2, wall_flags_3, wall_flags_4,        &
1069                   wall_flags_5, wall_flags_6, wall_flags_7, wall_flags_8,        &
1070                   wall_flags_9, wall_flags_10
1071
1072    REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  rflags_s_inner, rflags_invers
1073
1074    SAVE
1075
1076 END MODULE indices
1077
1078
1079!------------------------------------------------------------------------------!
1080! Description:
1081! ------------
1082!> Interfaces for special subroutines which use optional parameters.
1083!------------------------------------------------------------------------------!
1084 MODULE interfaces
1085
1086    INTERFACE
1087
1088!------------------------------------------------------------------------------!
1089! Description:
1090! ------------
1091!> @todo Missing subroutine description.
1092!------------------------------------------------------------------------------!
1093       SUBROUTINE global_min_max ( i1, i2, j1, j2, k1, k2, feld, mode, offset, &
1094                                   wert, wert_ijk, wert1, wert1_ijk )
1095
1096          USE kinds
1097
1098          CHARACTER (LEN=*), INTENT(IN)      ::  mode
1099          INTEGER(iwp), INTENT(IN)           ::  i1, i2, j1, j2, k1, k2
1100          INTEGER(iwp)                       ::  wert_ijk(3)
1101          INTEGER(iwp), OPTIONAL             ::  wert1_ijk(3)
1102          REAL(wp)                           ::  offset, wert
1103          REAL(wp), OPTIONAL                 ::  wert1
1104          REAL(wp), INTENT(IN)               ::  feld(i1:i2,j1:j2,k1:k2)
1105
1106       END SUBROUTINE global_min_max
1107
1108    END INTERFACE
1109
1110    SAVE
1111
1112 END MODULE interfaces
1113
1114
1115!------------------------------------------------------------------------------!
1116! Description:
1117! ------------
1118!> Interfaces for subroutines with pointer arguments called in
1119!> prognostic_equations.
1120!------------------------------------------------------------------------------!
1121 MODULE pointer_interfaces
1122
1123    INTERFACE
1124
1125!------------------------------------------------------------------------------!
1126! Description:
1127! ------------
1128!> @todo Missing subroutine description.
1129!------------------------------------------------------------------------------!
1130       SUBROUTINE advec_s_bc( sk, sk_char )
1131
1132          USE kinds
1133
1134          CHARACTER (LEN=*), INTENT(IN)   ::  sk_char
1135#if defined( __nopointer )
1136          REAL(wp), DIMENSION(:,:,:) ::  sk
1137#else
1138          REAL(wp), DIMENSION(:,:,:), POINTER ::  sk
1139#endif
1140       END SUBROUTINE advec_s_bc
1141
1142    END INTERFACE
1143
1144
1145    SAVE
1146
1147 END MODULE pointer_interfaces
1148
1149
1150!------------------------------------------------------------------------------!
1151! Description:
1152! ------------
1153!> Definition of variables for the 1D-model.
1154!------------------------------------------------------------------------------!
1155 MODULE model_1d
1156
1157    USE kinds
1158
1159    INTEGER(iwp) ::  current_timestep_number_1d = 0, damp_level_ind_1d
1160
1161    LOGICAL ::  run_control_header_1d = .FALSE., stop_dt_1d = .FALSE. 
1162
1163    REAL(wp) ::     damp_level_1d = -1.0_wp, dt_1d = 60.0_wp, dt_max_1d = 300.0_wp, &
1164                    dt_pr_1d = 9999999.9_wp, dt_run_control_1d = 60.0_wp, &
1165                    end_time_1d = 864000.0_wp, old_dt_1d = 1.0E-10_wp, &
1166                    qs1d, simulated_time_1d = 0.0_wp, time_pr_1d = 0.0_wp, &
1167                    time_run_control_1d = 0.0_wp, ts1d, us1d, usws1d, &
1168                    vsws1d, z01d, z0h1d
1169
1170
1171    REAL(wp), DIMENSION(:), ALLOCATABLE ::  e1d, e1d_p, kh1d, km1d, l_black, l1d,  &
1172                                            rif1d, te_e, te_em, te_u, te_um, te_v, &
1173                                            te_vm, u1d, u1d_p, v1d, v1d_p
1174
1175    SAVE
1176
1177 END MODULE model_1d
1178
1179
1180
1181
1182!------------------------------------------------------------------------------!
1183! Description:
1184! ------------
1185!> Definition of variables which define processor topology and the exchange of
1186!> ghost point layers. This modules must be placed in all routines which contain
1187!> MPI-calls.
1188!------------------------------------------------------------------------------!
1189 MODULE pegrid
1190
1191    USE kinds
1192
1193#if defined( __parallel )
1194#if defined( __mpifh )
1195    INCLUDE "mpif.h"
1196#else
1197    USE MPI
1198#endif
1199#endif
1200    CHARACTER(LEN=2) ::  send_receive = 'al'
1201    CHARACTER(LEN=7) ::  myid_char = ''
1202    INTEGER(iwp)     ::  acc_rank, comm1dx, comm1dy, comm2d, comm_inter,       &
1203                         comm_palm, id_inflow = 0,                             &
1204                         id_outflow = 0,        & !< myidx of procs at outflow (turbulent outflow method)
1205                         id_outflow_source = 0, & !< myidx of procs including ouflow source plane (turbulent outflow method)
1206                         id_recycling = 0, ierr,                               &
1207                         myid = 0, myidx = 0, myidy = 0, ndim = 2, ngp_a,      &
1208                         ngp_o, ngp_xy, ngp_y, npex = -1, npey = -1,           &
1209                         numprocs = 1, numprocs_previous_run = -1,             &
1210                         num_acc_per_node = 0, pleft, pnorth, pright, psouth,  &
1211                         req_count = 0, sendrecvcount_xy, sendrecvcount_yz,    &
1212                         sendrecvcount_zx, sendrecvcount_zyd,                  &
1213                         sendrecvcount_yxd, target_id, tasks_per_node = -9999, &
1214                         threads_per_task = 1, type_x, type_xy,    &
1215                         type_y
1216
1217    INTEGER(iwp)          ::  pdims(2) = 1, req(100)
1218
1219    INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE ::  hor_index_bounds, &
1220                                                  hor_index_bounds_previous_run
1221
1222    LOGICAL ::  background_communication =.FALSE., collective_wait = .FALSE., &
1223                sendrecv_in_background = .FALSE.
1224
1225#if defined( __parallel )
1226#if defined( __mpi2 )
1227    CHARACTER (LEN=MPI_MAX_PORT_NAME) ::  port_name
1228#endif
1229
1230    INTEGER(iwp) ::  ibuf(12), pcoord(2)
1231    INTEGER(iwp) ::  status(MPI_STATUS_SIZE)
1232    INTEGER(iwp), DIMENSION(MPI_STATUS_SIZE,100) ::  wait_stat
1233
1234    INTEGER(iwp) :: ngp_yz_int, type_xz_int, type_yz_int
1235    INTEGER(iwp), DIMENSION(:), ALLOCATABLE ::  ngp_xz, ngp_yz, type_x_int,    &
1236                                                type_xz, type_y_int, type_yz
1237
1238    LOGICAL ::  left_border_pe  = .FALSE., north_border_pe = .FALSE., &
1239                reorder = .TRUE., right_border_pe = .FALSE.,          &
1240                south_border_pe = .FALSE.
1241
1242    LOGICAL, DIMENSION(2) ::  cyclic = (/ .TRUE. , .TRUE. /), &
1243                              remain_dims
1244#endif
1245
1246    SAVE
1247
1248 END MODULE pegrid
1249
1250
1251!------------------------------------------------------------------------------!
1252! Description:
1253! ------------
1254!> Definition of variables which control PROFIL-output.
1255!------------------------------------------------------------------------------!
1256 MODULE profil_parameter
1257
1258    USE kinds
1259
1260    INTEGER(iwp), PARAMETER ::  crmax = 100
1261
1262    CHARACTER (LEN=20), DIMENSION(20) ::  cross_ts_profiles = &
1263                           (/ ' E E*               ', ' dt                 ', &
1264                              ' u* w*              ', ' th*                ', &
1265                              ' umax vmax wmax     ', ' div_old div_new    ', &
1266                              ' z_i_wpt z_i_pt     ', ' w"pt"0 w"pt" wpt   ', &
1267                              ' pt(0) pt(zp)       ', ' splux spluy spluz  ', &
1268                              ' L                  ',                         &
1269                            ( '                    ', i9 = 1, 9 ) /)
1270
1271    CHARACTER (LEN=100), DIMENSION(crmax) ::  cross_profiles = &
1272                           (/ ' u v                           ', &
1273                              ' pt                            ', &
1274                              ' w"pt" w*pt* w*pt*BC wpt wptBC ', &
1275                              ' w"u" w*u* wu w"v" w*v* wv     ', &
1276                              ' km kh                         ', &
1277                              ' l                             ', &
1278                         ( '                               ', i9 = 1, 94 ) /)
1279
1280    INTEGER(iwp) ::  profile_columns = 2, profile_rows = 3, profile_number = 0
1281
1282    INTEGER(iwp) ::  cross_ts_numbers(crmax,crmax) = 0, &
1283                     cross_ts_number_count(crmax) = 0, &
1284                     dopr_index(300) = 0, dopr_initial_index(300) = 0, &
1285                     dots_crossindex(100) = 0, dots_index(100) = 0
1286               
1287
1288    REAL(wp) ::  cross_ts_uymax(20) = &
1289                             (/ 999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp,   &
1290                                999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp,   &
1291                                999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp,   &
1292                                999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp /),&
1293                 cross_ts_uymax_computed(20) = 999.999_wp, &
1294                 cross_ts_uymin(20) = &
1295                             (/ 999.999_wp, 999.999_wp, 999.999_wp,  -5.000_wp, 999.999_wp,   &
1296                                999.999_wp,   0.000_wp, 999.999_wp, 999.999_wp, 999.999_wp,   &
1297                                999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp,   &
1298                                999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp, 999.999_wp /),&
1299                 cross_ts_uymin_computed(20) = 999.999_wp
1300
1301    SAVE
1302
1303 END MODULE profil_parameter
1304
1305!------------------------------------------------------------------------------!
1306! Description:
1307! ------------
1308!> Definition of statistical quantities, e.g. global sums.
1309!------------------------------------------------------------------------------!
1310 MODULE statistics
1311
1312    USE kinds
1313
1314    CHARACTER (LEN=40) ::  region(0:9)
1315    INTEGER(iwp) ::  pr_palm = 130, statistic_regions = 0
1316    INTEGER(iwp) ::  u_max_ijk(3) = -1, v_max_ijk(3) = -1, w_max_ijk(3) = -1
1317    LOGICAL ::  flow_statistics_called = .FALSE.
1318    REAL(wp) ::     u_max, v_max, w_max
1319    REAL(wp), DIMENSION(:), ALLOCATABLE       ::  mean_surface_level_height,      &
1320                                                  sums_divnew_l, sums_divold_l,   &
1321                                                  weight_substep, weight_pres
1322    REAL(wp), DIMENSION(:,:), ALLOCATABLE     ::  sums, sums_wsts_bc_l, ts_value, &
1323                                                  sums_wsus_ws_l, sums_wsvs_ws_l, &
1324                                                  sums_us2_ws_l, sums_vs2_ws_l,   &
1325                                                  sums_ws2_ws_l,                  &
1326                                                  sums_wsnrs_ws_l,                &
1327                                                  sums_wspts_ws_l,                &
1328                                                  sums_wsqs_ws_l,                 &   
1329                                                  sums_wsqrs_ws_l,                &
1330                                                  sums_wssas_ws_l,                &
1331                                                  sums_wsss_ws_l,                 &
1332                                                  sums_ls_l
1333                                             
1334    REAL(wp), DIMENSION(:,:,:), ALLOCATABLE   ::  hom_sum, rmask, sums_l,      &
1335                                                  sums_l_l, sums_up_fraction_l
1336
1337    REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE ::  hom
1338
1339    SAVE
1340
1341 END MODULE statistics
1342
1343
1344
1345!------------------------------------------------------------------------------!
1346! Description:
1347! ------------
1348!> Definition of indices for transposed arrays.
1349!------------------------------------------------------------------------------!
1350 MODULE transpose_indices
1351
1352    USE kinds
1353
1354    INTEGER(iwp) ::  nxl_y, nxl_yd, nxl_z, nxr_y, nxr_yd, nxr_z, nyn_x, nyn_z, &
1355                     nys_x, nys_z, nzb_x, nzb_y, nzb_yd, nzt_x, nzt_y, nzt_yd
1356               
1357    SAVE
1358
1359 END MODULE transpose_indices
Note: See TracBrowser for help on using the repository browser.