Home

Context Navigation

source: palm/trunk/SOURCE/time_integration.f90 @ 3013

Last change on this file since 3013 was 3004, checked in by Giersch, 7 years ago
precipitation_rate removed, further allocation checks for data output of averaged quantities implemented, double CALL of flow_statistics at the beginning of time_integration removed, further minor bugfixes, comments added
Property svn:keywords set to `Id`
File size: 51.8 KB

Line
1	!> @file time_integration.f90
2	!------------------------------------------------------------------------------!
3	! This file is part of the PALM model system.
4	!
5	! PALM is free software: you can redistribute it and/or modify it under the
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-2018 Leibniz Universitaet Hannover
18	!------------------------------------------------------------------------------!
19	!
20	! Current revisions:
21	! ------------------
22	!
23	!
24	! Former revisions:
25	! -----------------
26	! $Id: time_integration.f90 3004 2018-04-27 12:33:25Z Giersch $
27	! First call of flow_statistics has been removed. It is already called in
28	! run_control itself
29	!
30	! 2984 2018-04-18 11:51:30Z hellstea
31	! CALL pmci_ensure_nest_mass_conservation is removed (so far only commented out)
32	! as seemingly unnecessary.
33	!
34	! 2941 2018-04-03 11:54:58Z kanani
35	! Deduct spinup_time from RUN_CONTROL output of main 3d run
36	! (use time_since_reference_point instead of simulated_time)
37	!
38	! 2938 2018-03-27 15:52:42Z suehring
39	! Nesting of dissipation rate in case of RANS mode and TKE-e closure is applied
40	!
41	! 2936 2018-03-27 14:49:27Z suehring
42	! Little formatting adjustment.
43	!
44	! 2817 2018-02-19 16:32:21Z knoop
45	! Preliminary gust module interface implemented
46	!
47	! 2801 2018-02-14 16:01:55Z thiele
48	! Changed lpm from subroutine to module.
49	! Introduce particle transfer in nested models.
50	!
51	! 2776 2018-01-31 10:44:42Z Giersch
52	! Variable use_synthetic_turbulence_generator has been abbreviated
53	!
54	! 2773 2018-01-30 14:12:54Z suehring
55	! - Nesting for chemical species
56	!
57	! 2766 2018-01-22 17:17:47Z kanani
58	! Removed preprocessor directive __chem
59	!
60	! 2718 2018-01-02 08:49:38Z maronga
61	! Corrected "Former revisions" section
62	!
63	! 2696 2017-12-14 17:12:51Z kanani
64	! - Change in file header (GPL part)
65	! - Implementation of uv exposure model (FK)
66	! - Moved vnest_boundary_conds_khkm from tcm_diffusivities to here (TG)
67	! - renamed diffusivities to tcm_diffusivities (TG)
68	! - implement prognostic equation for diss (TG)
69	! - Moved/commented CALL to chem_emissions (FK)
70	! - Added CALL to chem_emissions (FK)
71	! - Implementation of chemistry module (FK)
72	! - Calls for setting boundary conditions in USM and LSM (MS)
73	! - Large-scale forcing with larger-scale models implemented (MS)
74	! - Rename usm_radiation into radiation_interactions; merge with branch
75	! radiation (MS)
76	! - added call for usm_green_heat_model for green building surfaces (RvT)
77	! - added call for usm_temperature_near_surface for use in indoor model (RvT)
78	!
79	! 2617 2017-11-16 12:47:24Z suehring
80	! Bugfix, assure that the reference state does not become zero.
81	!
82	! 2563 2017-10-19 15:36:10Z Giersch
83	! Variable wind_turbine moved to module control_parameters
84	!
85	! 2365 2017-08-21 14:59:59Z kanani
86	! Vertical grid nesting implemented (SadiqHuq)
87	!
88	! 2320 2017-07-21 12:47:43Z suehring
89	! Set bottom boundary conditions after nesting interpolation and anterpolation
90	!
91	! 2299 2017-06-29 10:14:38Z maronga
92	! Call of soil model adjusted
93	!
94	! 2292 2017-06-20 09:51:42Z schwenkel
95	! Implementation of new microphysic scheme: cloud_scheme = 'morrison'
96	! includes two more prognostic equations for cloud drop concentration (nc)
97	! and cloud water content (qc).
98	!
99	! 2271 2017-06-09 12:34:55Z sward
100	! Start timestep message changed
101	!
102	! 2259 2017-06-08 09:09:11Z gronemeier
103	! Implemented synthetic turbulence generator
104	!
105	! 2233 2017-05-30 18:08:54Z suehring
106	!
107	! 2232 2017-05-30 17:47:52Z suehring
108	! Adjustments to new topography and surface concept
109	! Modify passed parameters for disturb_field
110	!
111	! 2178 2017-03-17 11:07:39Z hellstea
112	! Setting perturbations at all times near inflow boundary is removed
113	! in case of nested boundaries
114	!
115	! 2174 2017-03-13 08:18:57Z maronga
116	! Added support for nesting with cloud microphysics
117	!
118	! 2118 2017-01-17 16:38:49Z raasch
119	! OpenACC directives and related code removed
120	!
121	! 2050 2016-11-08 15:00:55Z gronemeier
122	! Implement turbulent outflow condition
123	!
124	! 2031 2016-10-21 15:11:58Z knoop
125	! renamed variable rho to rho_ocean
126	!
127	! 2011 2016-09-19 17:29:57Z kanani
128	! Flag urban_surface is now defined in module control_parameters,
129	! removed commented CALLs of global_min_max.
130	!
131	! 2007 2016-08-24 15:47:17Z kanani
132	! Added CALLs for new urban surface model
133	!
134	! 2000 2016-08-20 18:09:15Z knoop
135	! Forced header and separation lines into 80 columns
136	!
137	! 1976 2016-07-27 13:28:04Z maronga
138	! Simplified calls to radiation model
139	!
140	! 1960 2016-07-12 16:34:24Z suehring
141	! Separate humidity and passive scalar
142	!
143	! 1957 2016-07-07 10:43:48Z suehring
144	! flight module added
145	!
146	! 1919 2016-05-27 14:51:23Z raasch
147	! Initial version of purely vertical nesting introduced.
148	!
149	! 1918 2016-05-27 14:35:57Z raasch
150	! determination of time step moved to the end of the time step loop,
151	! the first time step is now always calculated before the time step loop (i.e.
152	! also in case of restart runs)
153	!
154	! 1914 2016-05-26 14:44:07Z witha
155	! Added call for wind turbine model
156	!
157	! 1878 2016-04-19 12:30:36Z hellstea
158	! Synchronization for nested runs rewritten
159	!
160	! 1853 2016-04-11 09:00:35Z maronga
161	! Adjusted for use with radiation_scheme = constant
162	!
163	! 1849 2016-04-08 11:33:18Z hoffmann
164	! Adapted for modularization of microphysics
165	!
166	! 1833 2016-04-07 14:23:03Z raasch
167	! spectrum renamed spectra_mod, spectra related variables moved to spectra_mod
168	!
169	! 1831 2016-04-07 13:15:51Z hoffmann
170	! turbulence renamed collision_turbulence
171	!
172	! 1822 2016-04-07 07:49:42Z hoffmann
173	! icloud_scheme replaced by microphysics_*
174	!
175	! 1808 2016-04-05 19:44:00Z raasch
176	! output message in case unscheduled radiation calls removed
177	!
178	! 1797 2016-03-21 16:50:28Z raasch
179	! introduction of different datatransfer modes
180	!
181	! 1791 2016-03-11 10:41:25Z raasch
182	! call of pmci_update_new removed
183	!
184	! 1786 2016-03-08 05:49:27Z raasch
185	! +module spectrum
186	!
187	! 1783 2016-03-06 18:36:17Z raasch
188	! switch back of netcdf data format for mask output moved to the mask output
189	! routine
190	!
191	! 1781 2016-03-03 15:12:23Z raasch
192	! some pmc calls removed at the beginning (before timeloop),
193	! pmc initialization moved to the main program
194	!
195	! 1764 2016-02-28 12:45:19Z raasch
196	! PMC_ACTIVE flags removed,
197	! bugfix: nest synchronization after first call of timestep
198	!
199	! 1762 2016-02-25 12:31:13Z hellstea
200	! Introduction of nested domain feature
201	!
202	! 1736 2015-12-04 08:56:33Z raasch
203	! no perturbations added to total domain if energy limit has been set zero
204	!
205	! 1691 2015-10-26 16:17:44Z maronga
206	! Added option for spin-ups without land surface and radiation models. Moved calls
207	! for radiation and lan surface schemes.
208	!
209	! 1682 2015-10-07 23:56:08Z knoop
210	! Code annotations made doxygen readable
211	!
212	! 1671 2015-09-25 03:29:37Z raasch
213	! bugfix: ghostpoint exchange for array diss in case that sgs velocities are used
214	! for particles
215	!
216	! 1585 2015-04-30 07:05:52Z maronga
217	! Moved call of radiation scheme. Added support for RRTM
218	!
219	! 1551 2015-03-03 14:18:16Z maronga
220	! Added interface for different radiation schemes.
221	!
222	! 1496 2014-12-02 17:25:50Z maronga
223	! Added calls for the land surface model and radiation scheme
224	!
225	! 1402 2014-05-09 14:25:13Z raasch
226	! location messages modified
227	!
228	! 1384 2014-05-02 14:31:06Z raasch
229	! location messages added
230	!
231	! 1380 2014-04-28 12:40:45Z heinze
232	! CALL of nudge_ref added
233	! bc_pt_t_val and bc_q_t_val are updated in case nudging is used
234	!
235	! 1365 2014-04-22 15:03:56Z boeske
236	! Reset sums_ls_l to zero at each timestep
237	! +sums_ls_l
238	! Calculation of reference state (previously in subroutine calc_mean_profile)
239
240	! 1342 2014-03-26 17:04:47Z kanani
241	! REAL constants defined as wp-kind
242	!
243	! 1320 2014-03-20 08:40:49Z raasch
244	! ONLY-attribute added to USE-statements,
245	! kind-parameters added to all INTEGER and REAL declaration statements,
246	! kinds are defined in new module kinds,
247	! old module precision_kind is removed,
248	! revision history before 2012 removed,
249	! comment fields (!:) to be used for variable explanations added to
250	! all variable declaration statements
251	! 1318 2014-03-17 13:35:16Z raasch
252	! module interfaces removed
253	!
254	! 1308 2014-03-13 14:58:42Z fricke
255	! +netcdf_data_format_save
256	! For masked data, parallel netcdf output is not tested so far, hence
257	! netcdf_data_format is switched back to non-paralell output.
258	!
259	! 1276 2014-01-15 13:40:41Z heinze
260	! Use LSF_DATA also in case of Dirichlet bottom boundary condition for scalars
261	!
262	! 1257 2013-11-08 15:18:40Z raasch
263	! acc-update-host directive for timestep removed
264	!
265	! 1241 2013-10-30 11:36:58Z heinze
266	! Generalize calc_mean_profile for wider use
267	! Determine shf and qsws in dependence on data from LSF_DATA
268	! Determine ug and vg in dependence on data from LSF_DATA
269	! 1221 2013-09-10 08:59:13Z raasch
270	! host update of arrays before timestep is called
271	!
272	! 1179 2013-06-14 05:57:58Z raasch
273	! mean profiles for reference state are only calculated if required,
274	! small bugfix for background communication
275	!
276	! 1171 2013-05-30 11:27:45Z raasch
277	! split of prognostic_equations deactivated (comment lines), for the time being
278	!
279	! 1128 2013-04-12 06:19:32Z raasch
280	! asynchronous transfer of ghost point data realized for acc-optimized version:
281	! prognostic_equations are first called two times for those points required for
282	! the left-right and north-south exchange, respectively, and then for the
283	! remaining points,
284	! those parts requiring global communication moved from prognostic_equations to
285	! here
286	!
287	! 1115 2013-03-26 18:16:16Z hoffmann
288	! calculation of qr and nr is restricted to precipitation
289	!
290	! 1113 2013-03-10 02:48:14Z raasch
291	! GPU-porting of boundary conditions,
292	! openACC directives updated
293	! formal parameter removed from routine boundary_conds
294	!
295	! 1111 2013-03-08 23:54:10Z raasch
296	! +internal timestep counter for cpu statistics added,
297	! openACC directives updated
298	!
299	! 1092 2013-02-02 11:24:22Z raasch
300	! unused variables removed
301	!
302	! 1065 2012-11-22 17:42:36Z hoffmann
303	! exchange of diss (dissipation rate) in case of turbulence = .TRUE. added
304	!
305	! 1053 2012-11-13 17:11:03Z hoffmann
306	! exchange of ghost points for nr, qr added
307	!
308	! 1036 2012-10-22 13:43:42Z raasch
309	! code put under GPL (PALM 3.9)
310	!
311	! 1019 2012-09-28 06:46:45Z raasch
312	! non-optimized version of prognostic_equations removed
313	!
314	! 1015 2012-09-27 09:23:24Z raasch
315	! +call of prognostic_equations_acc
316	!
317	! 1001 2012-09-13 14:08:46Z raasch
318	! all actions concerning leapfrog- and upstream-spline-scheme removed
319	!
320	! 849 2012-03-15 10:35:09Z raasch
321	! advec_particles renamed lpm, first_call_advec_particles renamed first_call_lpm
322	!
323	! 825 2012-02-19 03:03:44Z raasch
324	! wang_collision_kernel renamed wang_kernel
325	!
326	! Revision 1.1 1997/08/11 06:19:04 raasch
327	! Initial revision
328	!
329	!
330	! Description:
331	! ------------
332	!> Integration in time of the model equations, statistical analysis and graphic
333	!> output
334	!------------------------------------------------------------------------------!
335	SUBROUTINE time_integration
336
337
338	USE advec_ws, &
339	ONLY: ws_statistics
340
341	USE arrays_3d, &
342	ONLY: diss, diss_p, dzu, e, e_p, nc, nc_p, nr, nr_p, prho, pt, pt_p, pt_init, &
343	q_init, q, qc, qc_p, ql, ql_c, ql_v, ql_vp, qr, qr_p, q_p, &
344	ref_state, rho_ocean, s, s_p, sa_p, tend, u, u_p, v, vpt, &
345	v_p, w, w_p
346
347	USE calc_mean_profile_mod, &
348	ONLY: calc_mean_profile
349
350	USE chemistry_model_mod, &
351	ONLY: chem_emissions, chem_species
352
353	USE chem_modules, &
354	ONLY: nspec
355
356	USE control_parameters, &
357	ONLY: advected_distance_x, advected_distance_y, air_chemistry, &
358	average_count_3d, averaging_interval, averaging_interval_pr, &
359	bc_lr_cyc, bc_ns_cyc, bc_pt_t_val, &
360	bc_q_t_val, call_psolver_at_all_substeps, cloud_droplets, &
361	cloud_physics, constant_flux_layer, constant_heatflux, &
362	create_disturbances, dopr_n, constant_diffusion, coupling_mode, &
363	coupling_start_time, current_timestep_number, &
364	disturbance_created, disturbance_energy_limit, dist_range, &
365	do_sum, dt_3d, dt_averaging_input, dt_averaging_input_pr, &
366	dt_coupling, dt_data_output_av, dt_disturb, dt_do2d_xy, &
367	dt_do2d_xz, dt_do2d_yz, dt_do3d, dt_domask,dt_dopts, dt_dopr, &
368	dt_dopr_listing, dt_dots, dt_dvrp, dt_run_control, end_time, &
369	first_call_lpm, forcing, galilei_transformation, humidity, &
370	intermediate_timestep_count, intermediate_timestep_count_max, &
371	land_surface, large_scale_forcing, &
372	loop_optimization, lsf_surf, lsf_vert, masks, &
373	microphysics_morrison, microphysics_seifert, mid, nest_domain, &
374	neutral, nr_timesteps_this_run, nudging, &
375	ocean, passive_scalar, prho_reference, pt_reference, &
376	pt_slope_offset, random_heatflux, rans_mode, &
377	rans_tke_e, run_coupled, simulated_time, simulated_time_chr, &
378	skip_time_do2d_xy, skip_time_do2d_xz, skip_time_do2d_yz, &
379	skip_time_do3d, skip_time_domask, skip_time_dopr, &
380	skip_time_data_output_av, sloping_surface, &
381	stop_dt, terminate_coupled, terminate_run, timestep_scheme, &
382	time_coupling, time_do2d_xy, time_do2d_xz, time_do2d_yz, &
383	time_do3d, time_domask, time_dopr, time_dopr_av, &
384	time_dopr_listing, time_dopts, time_dosp, time_dosp_av, &
385	time_dots, time_do_av, time_do_sla, time_disturb, time_dvrp, &
386	time_run_control, time_since_reference_point, &
387	turbulent_inflow, turbulent_outflow, urban_surface, &
388	use_initial_profile_as_reference, &
389	use_single_reference_value, uv_exposure, u_gtrans, v_gtrans, &
390	virtual_flight, wind_turbine, ws_scheme_mom, ws_scheme_sca
391
392	USE cpulog, &
393	ONLY: cpu_log, log_point, log_point_s
394
395	USE flight_mod, &
396	ONLY: flight_measurement
397
398	USE gust_mod, &
399	ONLY: gust_actions, gust_module_enabled
400
401	USE indices, &
402	ONLY: nbgp, nx, nxl, nxlg, nxr, nxrg, nyn, nyng, nys, nysg, nzb, nzt
403
404	USE interaction_droplets_ptq_mod, &
405	ONLY: interaction_droplets_ptq
406
407	USE interfaces
408
409	USE kinds
410
411	USE land_surface_model_mod, &
412	ONLY: lsm_boundary_condition, lsm_energy_balance, lsm_soil_model, &
413	skip_time_do_lsm
414
415	USE lsf_nudging_mod, &
416	ONLY: calc_tnudge, ls_forcing_surf, ls_forcing_vert, nudge_ref, &
417	forcing_bc, forcing_bc_mass_conservation
418
419	USE netcdf_data_input_mod, &
420	ONLY: force, netcdf_data_input_lsf
421
422	USE microphysics_mod, &
423	ONLY: collision_turbulence
424
425	USE particle_attributes, &
426	ONLY: particle_advection, particle_advection_start, &
427	use_sgs_for_particles, wang_kernel
428
429	USE pegrid
430
431	USE pmc_interface, &
432	ONLY: nested_run, nesting_mode, pmci_boundary_conds, pmci_datatrans, &
433	pmci_ensure_nest_mass_conservation, pmci_synchronize
434
435	USE progress_bar, &
436	ONLY: finish_progress_bar, output_progress_bar
437
438	USE prognostic_equations_mod, &
439	ONLY: prognostic_equations_cache, prognostic_equations_vector
440
441	USE radiation_model_mod, &
442	ONLY: dt_radiation, force_radiation_call, radiation, radiation_control,&
443	radiation_interaction, radiation_interactions, &
444	skip_time_do_radiation, time_radiation
445
446	USE spectra_mod, &
447	ONLY: average_count_sp, averaging_interval_sp, calc_spectra, dt_dosp, &
448	skip_time_dosp
449
450	USE statistics, &
451	ONLY: flow_statistics_called, hom, pr_palm, sums_ls_l, u_max, &
452	u_max_ijk, v_max, v_max_ijk, w_max, w_max_ijk
453
454	USE surface_layer_fluxes_mod, &
455	ONLY: surface_layer_fluxes
456
457	USE surface_mod, &
458	ONLY: surf_def_h, surf_lsm_h, surf_usm_h
459
460	USE turbulence_closure_mod, &
461	ONLY: tcm_diffusivities, production_e_init
462
463	USE urban_surface_mod, &
464	ONLY: usm_boundary_condition, usm_material_heat_model, &
465	usm_material_model, &
466	usm_surface_energy_balance, usm_green_heat_model, &
467	usm_temperature_near_surface
468
469	USE synthetic_turbulence_generator_mod, &
470	ONLY: stg_main, use_syn_turb_gen
471
472	USE user_actions_mod, &
473	ONLY: user_actions
474
475	USE uv_exposure_model_mod, &
476	ONLY: uvem_calc_exposure
477
478	USE wind_turbine_model_mod, &
479	ONLY: wtm_forces
480
481	USE lpm_mod, &
482	ONLY: lpm
483
484	USE vertical_nesting_mod, &
485	ONLY: vnested, vnest_anterpolate, vnest_anterpolate_e, &
486	vnest_boundary_conds, vnest_boundary_conds_khkm, &
487	vnest_deallocate, vnest_init, vnest_init_fine, &
488	vnest_start_time
489
490	IMPLICIT NONE
491
492	CHARACTER (LEN=9) :: time_to_string !<
493	INTEGER :: n
494	INTEGER :: lsp
495
496	REAL(wp) :: dt_3d_old !< temporary storage of timestep to be used for
497	!< steering of run control output interval
498	!
499	!-- At beginning determine the first time step
500	CALL timestep
501	!
502	!-- Synchronize the timestep in case of nested run.
503	IF ( nested_run ) THEN
504	!
505	!-- Synchronization by unifying the time step.
506	!-- Global minimum of all time-steps is used for all.
507	CALL pmci_synchronize
508	ENDIF
509
510	!
511	!-- Determine and print out the run control quantities before the first time
512	!-- step of this run. For the initial run, some statistics (e.g. divergence)
513	!-- need to be determined first --> CALL flow_statistics at the beginning of
514	!-- run_control
515	CALL run_control
516	!
517	!-- Data exchange between coupled models in case that a call has been omitted
518	!-- at the end of the previous run of a job chain.
519	IF ( coupling_mode /= 'uncoupled' .AND. run_coupled .AND. .NOT. vnested) THEN
520	!
521	!-- In case of model termination initiated by the local model the coupler
522	!-- must not be called because this would again cause an MPI hang.
523	DO WHILE ( time_coupling >= dt_coupling .AND. terminate_coupled == 0 )
524	CALL surface_coupler
525	time_coupling = time_coupling - dt_coupling
526	ENDDO
527	IF (time_coupling == 0.0_wp .AND. &
528	time_since_reference_point < dt_coupling ) &
529	THEN
530	time_coupling = time_since_reference_point
531	ENDIF
532	ENDIF
533
534	#if defined( __dvrp_graphics )
535	!
536	!-- Time measurement with dvrp software
537	CALL DVRP_LOG_EVENT( 2, current_timestep_number )
538	#endif
539
540	CALL location_message( 'starting timestep-sequence', .TRUE. )
541	!
542	!-- Start of the time loop
543	DO WHILE ( simulated_time < end_time .AND. .NOT. stop_dt .AND. &
544	.NOT. terminate_run )
545
546	CALL cpu_log( log_point_s(10), 'timesteps', 'start' )
547	!
548	!-- Vertical nesting: initialize fine grid
549	IF ( vnested ) THEN
550	IF ( .NOT. vnest_init .AND. simulated_time >= vnest_start_time ) THEN
551	CALL cpu_log( log_point(80), 'vnest_init', 'start' )
552	CALL vnest_init_fine
553	vnest_init = .TRUE.
554	CALL cpu_log( log_point(80), 'vnest_init', 'stop' )
555	ENDIF
556	ENDIF
557	!
558	!-- Determine ug, vg and w_subs in dependence on data from external file
559	!-- LSF_DATA
560	IF ( large_scale_forcing .AND. lsf_vert ) THEN
561	CALL ls_forcing_vert ( simulated_time )
562	sums_ls_l = 0.0_wp
563	ENDIF
564
565	!
566	!-- Set pt_init and q_init to the current profiles taken from
567	!-- NUDGING_DATA
568	IF ( nudging ) THEN
569	CALL nudge_ref ( simulated_time )
570	!
571	!-- Store temperature gradient at the top boundary for possible Neumann
572	!-- boundary condition
573	bc_pt_t_val = ( pt_init(nzt+1) - pt_init(nzt) ) / dzu(nzt+1)
574	bc_q_t_val = ( q_init(nzt+1) - q_init(nzt) ) / dzu(nzt+1)
575	ENDIF
576	!
577	!-- If forcing by larger-scale models is applied, check if new data
578	!-- at domain boundaries need to be read.
579	IF ( forcing ) THEN
580	IF ( force%time(force%tind_p) <= simulated_time ) &
581	CALL netcdf_data_input_lsf
582	ENDIF
583
584	!
585	!-- Execute the gust module actions
586	IF ( gust_module_enabled ) THEN
587	CALL gust_actions( 'before_timestep' )
588	ENDIF
589
590	!
591	!-- Execute the user-defined actions
592	CALL user_actions( 'before_timestep' )
593
594	!
595	!-- Calculate forces by wind turbines
596	IF ( wind_turbine ) THEN
597
598	CALL cpu_log( log_point(55), 'wind_turbine', 'start' )
599
600	CALL wtm_forces
601
602	CALL cpu_log( log_point(55), 'wind_turbine', 'stop' )
603
604	ENDIF
605
606	!
607	!-- Start of intermediate step loop
608	intermediate_timestep_count = 0
609	DO WHILE ( intermediate_timestep_count < &
610	intermediate_timestep_count_max )
611
612	intermediate_timestep_count = intermediate_timestep_count + 1
613
614	!
615	!-- Set the steering factors for the prognostic equations which depend
616	!-- on the timestep scheme
617	CALL timestep_scheme_steering
618
619	!
620	!-- Calculate those variables needed in the tendency terms which need
621	!-- global communication
622	IF ( .NOT. use_single_reference_value .AND. &
623	.NOT. use_initial_profile_as_reference ) THEN
624	!
625	!-- Horizontally averaged profiles to be used as reference state in
626	!-- buoyancy terms (WARNING: only the respective last call of
627	!-- calc_mean_profile defines the reference state!)
628	IF ( .NOT. neutral ) THEN
629	CALL calc_mean_profile( pt, 4 )
630	ref_state(:) = hom(:,1,4,0) ! this is used in the buoyancy term
631	ENDIF
632	IF ( ocean ) THEN
633	CALL calc_mean_profile( rho_ocean, 64 )
634	ref_state(:) = hom(:,1,64,0)
635	ENDIF
636	IF ( humidity ) THEN
637	CALL calc_mean_profile( vpt, 44 )
638	ref_state(:) = hom(:,1,44,0)
639	ENDIF
640	!
641	!-- Assure that ref_state does not become zero at any level
642	!-- ( might be the case if a vertical level is completely occupied
643	!-- with topography ).
644	ref_state = MERGE( MAXVAL(ref_state), ref_state, &
645	ref_state == 0.0_wp )
646	ENDIF
647
648	IF ( .NOT. constant_diffusion ) CALL production_e_init
649	IF ( ( ws_scheme_mom .OR. ws_scheme_sca ) .AND. &
650	intermediate_timestep_count == 1 ) CALL ws_statistics
651	!
652	!-- In case of nudging calculate current nudging time scale and horizontal
653	!-- means of u, v, pt and q
654	IF ( nudging ) THEN
655	CALL calc_tnudge( simulated_time )
656	CALL calc_mean_profile( u, 1 )
657	CALL calc_mean_profile( v, 2 )
658	CALL calc_mean_profile( pt, 4 )
659	CALL calc_mean_profile( q, 41 )
660	ENDIF
661
662	!
663	!-- Solve the prognostic equations. A fast cache optimized version with
664	!-- only one single loop is used in case of Piascek-Williams advection
665	!-- scheme. NEC vector machines use a different version, because
666	!-- in the other versions a good vectorization is prohibited due to
667	!-- inlining problems.
668	IF ( loop_optimization == 'cache' ) THEN
669	CALL prognostic_equations_cache
670	ELSEIF ( loop_optimization == 'vector' ) THEN
671	CALL prognostic_equations_vector
672	ENDIF
673
674	!
675	!-- Particle transport/physics with the Lagrangian particle model
676	!-- (only once during intermediate steps, because it uses an Euler-step)
677	!-- ### particle model should be moved before prognostic_equations, in order
678	!-- to regard droplet interactions directly
679	IF ( particle_advection .AND. &
680	simulated_time >= particle_advection_start .AND. &
681	intermediate_timestep_count == 1 ) THEN
682	CALL lpm
683	first_call_lpm = .FALSE.
684	ENDIF
685
686	!
687	!-- Interaction of droplets with temperature and specific humidity.
688	!-- Droplet condensation and evaporation is calculated within
689	!-- advec_particles.
690	IF ( cloud_droplets .AND. &
691	intermediate_timestep_count == intermediate_timestep_count_max )&
692	THEN
693	CALL interaction_droplets_ptq
694	ENDIF
695
696	!
697	!-- Exchange of ghost points (lateral boundary conditions)
698	CALL cpu_log( log_point(26), 'exchange-horiz-progn', 'start' )
699
700	CALL exchange_horiz( u_p, nbgp )
701	CALL exchange_horiz( v_p, nbgp )
702	CALL exchange_horiz( w_p, nbgp )
703	CALL exchange_horiz( pt_p, nbgp )
704	IF ( .NOT. constant_diffusion ) CALL exchange_horiz( e_p, nbgp )
705	IF ( rans_tke_e .OR. wang_kernel .OR. collision_turbulence &
706	.OR. use_sgs_for_particles ) THEN
707	IF ( rans_tke_e ) THEN
708	CALL exchange_horiz( diss_p, nbgp )
709	ELSE
710	CALL exchange_horiz( diss, nbgp )
711	ENDIF
712	ENDIF
713	IF ( ocean ) THEN
714	CALL exchange_horiz( sa_p, nbgp )
715	CALL exchange_horiz( rho_ocean, nbgp )
716	CALL exchange_horiz( prho, nbgp )
717	ENDIF
718	IF ( humidity ) THEN
719	CALL exchange_horiz( q_p, nbgp )
720	IF ( cloud_physics .AND. microphysics_morrison ) THEN
721	CALL exchange_horiz( qc_p, nbgp )
722	CALL exchange_horiz( nc_p, nbgp )
723	ENDIF
724	IF ( cloud_physics .AND. microphysics_seifert ) THEN
725	CALL exchange_horiz( qr_p, nbgp )
726	CALL exchange_horiz( nr_p, nbgp )
727	ENDIF
728	ENDIF
729	IF ( cloud_droplets ) THEN
730	CALL exchange_horiz( ql, nbgp )
731	CALL exchange_horiz( ql_c, nbgp )
732	CALL exchange_horiz( ql_v, nbgp )
733	CALL exchange_horiz( ql_vp, nbgp )
734	ENDIF
735	IF ( passive_scalar ) CALL exchange_horiz( s_p, nbgp )
736	IF ( air_chemistry ) THEN
737	DO n = 1, nspec
738	CALL exchange_horiz( chem_species(n)%conc_p, nbgp )
739	ENDDO
740	ENDIF
741
742	CALL cpu_log( log_point(26), 'exchange-horiz-progn', 'stop' )
743
744	!
745	!-- Boundary conditions for the prognostic quantities (except of the
746	!-- velocities at the outflow in case of a non-cyclic lateral wall)
747	CALL boundary_conds
748	!
749	!-- Swap the time levels in preparation for the next time step.
750	CALL swap_timelevel
751
752	!
753	!-- Vertical nesting: Interpolate fine grid data to the coarse grid
754	IF ( vnest_init ) THEN
755	CALL cpu_log( log_point(81), 'vnest_anterpolate', 'start' )
756	CALL vnest_anterpolate
757	CALL cpu_log( log_point(81), 'vnest_anterpolate', 'stop' )
758	ENDIF
759
760	IF ( nested_run ) THEN
761
762	CALL cpu_log( log_point(60), 'nesting', 'start' )
763	!
764	!-- Domain nesting. The data transfer subroutines pmci_parent_datatrans
765	!-- and pmci_child_datatrans are called inside the wrapper
766	!-- subroutine pmci_datatrans according to the control parameters
767	!-- nesting_mode and nesting_datatransfer_mode.
768	!-- TO_DO: why is nesting_mode given as a parameter here?
769	CALL pmci_datatrans( nesting_mode )
770
771	IF ( TRIM( nesting_mode ) == 'two-way' .OR. &
772	nesting_mode == 'vertical' ) THEN
773	!
774	!-- Exchange_horiz is needed for all parent-domains after the
775	!-- anterpolation
776	CALL exchange_horiz( u, nbgp )
777	CALL exchange_horiz( v, nbgp )
778	CALL exchange_horiz( w, nbgp )
779	IF ( .NOT. neutral ) CALL exchange_horiz( pt, nbgp )
780
781	IF ( humidity ) THEN
782
783	CALL exchange_horiz( q, nbgp )
784
785	IF ( cloud_physics .AND. microphysics_morrison ) THEN
786	CALL exchange_horiz( qc, nbgp )
787	CALL exchange_horiz( nc, nbgp )
788	ENDIF
789	IF ( cloud_physics .AND. microphysics_seifert ) THEN
790	CALL exchange_horiz( qr, nbgp )
791	CALL exchange_horiz( nr, nbgp )
792	ENDIF
793
794	ENDIF
795
796	IF ( passive_scalar ) CALL exchange_horiz( s, nbgp )
797	IF ( .NOT. constant_diffusion ) CALL exchange_horiz( e, nbgp )
798
799	IF ( .NOT. constant_diffusion .AND. rans_mode .AND. &
800	rans_tke_e ) &
801	CALL exchange_horiz( diss, nbgp )
802
803	IF ( air_chemistry ) THEN
804	DO n = 1, nspec
805	CALL exchange_horiz( chem_species(n)%conc, nbgp )
806	ENDDO
807	ENDIF
808
809	ENDIF
810	!
811	!-- Set boundary conditions again after interpolation and anterpolation.
812	CALL pmci_boundary_conds
813	!
814	!-- Correct the w top-BC in nest domains to ensure mass conservation.
815	!-- This action must never be done for the root domain. Vertical
816	!-- nesting implies mass conservation.
817	!-- Commented out April 18, 2018 as seemingly unnecessary.
818	!-- Will later be completely removed.
819	!-- IF ( nest_domain ) THEN
820	!-- CALL pmci_ensure_nest_mass_conservation
821	!-- ENDIF
822
823	CALL cpu_log( log_point(60), 'nesting', 'stop' )
824
825	ENDIF
826
827	!
828	!-- Temperature offset must be imposed at cyclic boundaries in x-direction
829	!-- when a sloping surface is used
830	IF ( sloping_surface ) THEN
831	IF ( nxl == 0 ) pt(:,:,nxlg:nxl-1) = pt(:,:,nxlg:nxl-1) - &
832	pt_slope_offset
833	IF ( nxr == nx ) pt(:,:,nxr+1:nxrg) = pt(:,:,nxr+1:nxrg) + &
834	pt_slope_offset
835	ENDIF
836
837	!
838	!-- Impose a turbulent inflow using the recycling method
839	IF ( turbulent_inflow ) CALL inflow_turbulence
840
841	!
842	!-- Impose a turbulent inflow using synthetic generated turbulence
843	IF ( use_syn_turb_gen ) CALL stg_main
844
845	!
846	!-- Set values at outflow boundary using the special outflow condition
847	IF ( turbulent_outflow ) CALL outflow_turbulence
848
849	!
850	!-- Impose a random perturbation on the horizontal velocity field
851	IF ( create_disturbances .AND. &
852	( call_psolver_at_all_substeps .AND. &
853	intermediate_timestep_count == intermediate_timestep_count_max )&
854	.OR. ( .NOT. call_psolver_at_all_substeps .AND. &
855	intermediate_timestep_count == 1 ) ) &
856	THEN
857	time_disturb = time_disturb + dt_3d
858	IF ( time_disturb >= dt_disturb ) THEN
859	IF ( disturbance_energy_limit /= 0.0_wp .AND. &
860	hom(nzb+5,1,pr_palm,0) < disturbance_energy_limit ) THEN
861	CALL disturb_field( 'u', tend, u )
862	CALL disturb_field( 'v', tend, v )
863	ELSEIF ( ( .NOT. bc_lr_cyc .OR. .NOT. bc_ns_cyc ) &
864	.AND. .NOT. nest_domain .AND. .NOT. forcing ) THEN
865	!
866	!-- Runs with a non-cyclic lateral wall need perturbations
867	!-- near the inflow throughout the whole simulation
868	dist_range = 1
869	CALL disturb_field( 'u', tend, u )
870	CALL disturb_field( 'v', tend, v )
871	dist_range = 0
872	ENDIF
873	time_disturb = time_disturb - dt_disturb
874	ENDIF
875	ENDIF
876
877	!
878	!-- Map forcing data derived from larger scale model onto domain
879	!-- boundaries.
880	IF ( forcing .AND. intermediate_timestep_count == &
881	intermediate_timestep_count_max ) THEN
882	CALL forcing_bc
883	!
884	!-- Moreover, ensure mass conservation
885	CALL forcing_bc_mass_conservation
886	ENDIF
887
888	!
889	!-- Reduce the velocity divergence via the equation for perturbation
890	!-- pressure.
891	IF ( intermediate_timestep_count == 1 .OR. &
892	call_psolver_at_all_substeps ) THEN
893
894	IF ( vnest_init ) THEN
895	!
896	!-- Compute pressure in the CG, interpolate top boundary conditions
897	!-- to the FG and then compute pressure in the FG
898	IF ( coupling_mode == 'vnested_crse' ) CALL pres
899
900	CALL cpu_log( log_point(82), 'vnest_bc', 'start' )
901	CALL vnest_boundary_conds
902	CALL cpu_log( log_point(82), 'vnest_bc', 'stop' )
903
904	IF ( coupling_mode == 'vnested_fine' ) CALL pres
905
906	!-- Anterpolate TKE, satisfy Germano Identity
907	CALL cpu_log( log_point(83), 'vnest_anter_e', 'start' )
908	CALL vnest_anterpolate_e
909	CALL cpu_log( log_point(83), 'vnest_anter_e', 'stop' )
910
911	ELSE
912
913	CALL pres
914
915	ENDIF
916
917	ENDIF
918
919	!
920	!-- If required, compute liquid water content
921	IF ( cloud_physics ) THEN
922	CALL calc_liquid_water_content
923	ENDIF
924	!
925	!-- If required, compute virtual potential temperature
926	IF ( humidity ) THEN
927	CALL compute_vpt
928	ENDIF
929
930	!
931	!-- Compute the diffusion quantities
932	IF ( .NOT. constant_diffusion ) THEN
933
934	!
935	!-- Determine surface fluxes shf and qsws and surface values
936	!-- pt_surface and q_surface in dependence on data from external
937	!-- file LSF_DATA respectively
938	IF ( ( large_scale_forcing .AND. lsf_surf ) .AND. &
939	intermediate_timestep_count == intermediate_timestep_count_max )&
940	THEN
941	CALL ls_forcing_surf( simulated_time )
942	ENDIF
943
944	!
945	!-- First the vertical (and horizontal) fluxes in the surface
946	!-- (constant flux) layer are computed
947	IF ( constant_flux_layer ) THEN
948	CALL cpu_log( log_point(19), 'surface_layer_fluxes', 'start' )
949	CALL surface_layer_fluxes
950	CALL cpu_log( log_point(19), 'surface_layer_fluxes', 'stop' )
951	ENDIF
952	!
953	!-- If required, solve the energy balance for the surface and run soil
954	!-- model. Call for horizontal as well as vertical surfaces
955	IF ( land_surface .AND. time_since_reference_point >= skip_time_do_lsm) THEN
956
957	CALL cpu_log( log_point(54), 'land_surface', 'start' )
958	!
959	!-- Call for horizontal upward-facing surfaces
960	CALL lsm_energy_balance( .TRUE., -1 )
961	CALL lsm_soil_model( .TRUE., -1, .TRUE. )
962	!
963	!-- Call for northward-facing surfaces
964	CALL lsm_energy_balance( .FALSE., 0 )
965	CALL lsm_soil_model( .FALSE., 0, .TRUE. )
966	!
967	!-- Call for southward-facing surfaces
968	CALL lsm_energy_balance( .FALSE., 1 )
969	CALL lsm_soil_model( .FALSE., 1, .TRUE. )
970	!
971	!-- Call for eastward-facing surfaces
972	CALL lsm_energy_balance( .FALSE., 2 )
973	CALL lsm_soil_model( .FALSE., 2, .TRUE. )
974	!
975	!-- Call for westward-facing surfaces
976	CALL lsm_energy_balance( .FALSE., 3 )
977	CALL lsm_soil_model( .FALSE., 3, .TRUE. )
978	!
979	!-- At the end, set boundary conditons for potential temperature
980	!-- and humidity after running the land-surface model. This
981	!-- might be important for the nesting, where arrays are transfered.
982	CALL lsm_boundary_condition
983
984	CALL cpu_log( log_point(54), 'land_surface', 'stop' )
985	ENDIF
986	!
987	!-- If required, solve the energy balance for urban surfaces and run
988	!-- the material heat model
989	IF (urban_surface) THEN
990	CALL cpu_log( log_point(74), 'urban_surface', 'start' )
991	CALL usm_surface_energy_balance
992	IF ( usm_material_model ) THEN
993	CALL usm_green_heat_model
994	CALL usm_material_heat_model
995	ENDIF
996
997	CALL usm_temperature_near_surface
998	!
999	!-- At the end, set boundary conditons for potential temperature
1000	!-- and humidity after running the urban-surface model. This
1001	!-- might be important for the nesting, where arrays are transfered.
1002	CALL usm_boundary_condition
1003
1004	CALL cpu_log( log_point(74), 'urban_surface', 'stop' )
1005	ENDIF
1006	!
1007	!-- Compute the diffusion coefficients
1008	CALL cpu_log( log_point(17), 'diffusivities', 'start' )
1009	IF ( .NOT. humidity ) THEN
1010	IF ( ocean ) THEN
1011	CALL tcm_diffusivities( prho, prho_reference )
1012	ELSE
1013	CALL tcm_diffusivities( pt, pt_reference )
1014	ENDIF
1015	ELSE
1016	CALL tcm_diffusivities( vpt, pt_reference )
1017	ENDIF
1018	CALL cpu_log( log_point(17), 'diffusivities', 'stop' )
1019	!
1020	!-- Vertical nesting: set fine grid eddy viscosity top boundary condition
1021	IF ( vnest_init ) CALL vnest_boundary_conds_khkm
1022
1023	ENDIF
1024
1025	!
1026	!-- If required, calculate radiative fluxes and heating rates
1027	IF ( radiation .AND. intermediate_timestep_count &
1028	== intermediate_timestep_count_max .AND. time_since_reference_point > &
1029	skip_time_do_radiation ) THEN
1030
1031	time_radiation = time_radiation + dt_3d
1032
1033	IF ( time_radiation >= dt_radiation .OR. force_radiation_call ) &
1034	THEN
1035
1036	CALL cpu_log( log_point(50), 'radiation', 'start' )
1037
1038	IF ( .NOT. force_radiation_call ) THEN
1039	time_radiation = time_radiation - dt_radiation
1040	ENDIF
1041
1042	CALL radiation_control
1043
1044	CALL cpu_log( log_point(50), 'radiation', 'stop' )
1045
1046	IF ( urban_surface .OR. land_surface .AND. &
1047	radiation_interactions ) THEN
1048	CALL cpu_log( log_point(75), 'radiation_interaction', 'start' )
1049	CALL radiation_interaction
1050	CALL cpu_log( log_point(75), 'radiation_interaction', 'stop' )
1051	ENDIF
1052
1053	ENDIF
1054	ENDIF
1055
1056	ENDDO ! Intermediate step loop
1057	!
1058	!-- If required, consider chemical emissions
1059	!-- (todo (FK): Implement hourly call of emissions, using time_utc from
1060	!-- data_and_time_mod.f90;
1061	!-- move the CALL to appropriate location)
1062	IF ( air_chemistry ) THEN
1063	CALL chem_emissions
1064	ENDIF
1065	!
1066	!-- If required, do UV exposure calculations
1067	IF ( uv_exposure ) THEN
1068	CALL uvem_calc_exposure
1069	ENDIF
1070	!
1071	!-- Increase simulation time and output times
1072	nr_timesteps_this_run = nr_timesteps_this_run + 1
1073	current_timestep_number = current_timestep_number + 1
1074	simulated_time = simulated_time + dt_3d
1075	time_since_reference_point = simulated_time - coupling_start_time
1076	simulated_time_chr = time_to_string( time_since_reference_point )
1077
1078
1079
1080
1081	IF ( simulated_time >= skip_time_data_output_av ) THEN
1082	time_do_av = time_do_av + dt_3d
1083	ENDIF
1084	IF ( simulated_time >= skip_time_do2d_xy ) THEN
1085	time_do2d_xy = time_do2d_xy + dt_3d
1086	ENDIF
1087	IF ( simulated_time >= skip_time_do2d_xz ) THEN
1088	time_do2d_xz = time_do2d_xz + dt_3d
1089	ENDIF
1090	IF ( simulated_time >= skip_time_do2d_yz ) THEN
1091	time_do2d_yz = time_do2d_yz + dt_3d
1092	ENDIF
1093	IF ( simulated_time >= skip_time_do3d ) THEN
1094	time_do3d = time_do3d + dt_3d
1095	ENDIF
1096	DO mid = 1, masks
1097	IF ( simulated_time >= skip_time_domask(mid) ) THEN
1098	time_domask(mid)= time_domask(mid) + dt_3d
1099	ENDIF
1100	ENDDO
1101	time_dvrp = time_dvrp + dt_3d
1102	IF ( simulated_time >= skip_time_dosp ) THEN
1103	time_dosp = time_dosp + dt_3d
1104	ENDIF
1105	time_dots = time_dots + dt_3d
1106	IF ( .NOT. first_call_lpm ) THEN
1107	time_dopts = time_dopts + dt_3d
1108	ENDIF
1109	IF ( simulated_time >= skip_time_dopr ) THEN
1110	time_dopr = time_dopr + dt_3d
1111	ENDIF
1112	time_dopr_listing = time_dopr_listing + dt_3d
1113	time_run_control = time_run_control + dt_3d
1114
1115	!
1116	!-- Data exchange between coupled models
1117	IF ( coupling_mode /= 'uncoupled' .AND. run_coupled &
1118	.AND. .NOT. vnested ) THEN
1119	time_coupling = time_coupling + dt_3d
1120
1121	!
1122	!-- In case of model termination initiated by the local model
1123	!-- (terminate_coupled > 0), the coupler must be skipped because it would
1124	!-- cause an MPI intercomminucation hang.
1125	!-- If necessary, the coupler will be called at the beginning of the
1126	!-- next restart run.
1127	DO WHILE ( time_coupling >= dt_coupling .AND. terminate_coupled == 0 )
1128	CALL surface_coupler
1129	time_coupling = time_coupling - dt_coupling
1130	ENDDO
1131	ENDIF
1132
1133	!
1134	!-- Execute the gust module actions
1135	IF ( gust_module_enabled ) THEN
1136	CALL gust_actions( 'after_integration' )
1137	ENDIF
1138
1139	!
1140	!-- Execute user-defined actions
1141	CALL user_actions( 'after_integration' )
1142
1143	!
1144	!-- If Galilei transformation is used, determine the distance that the
1145	!-- model has moved so far
1146	IF ( galilei_transformation ) THEN
1147	advected_distance_x = advected_distance_x + u_gtrans * dt_3d
1148	advected_distance_y = advected_distance_y + v_gtrans * dt_3d
1149	ENDIF
1150
1151	!
1152	!-- Check, if restart is necessary (because cpu-time is expiring or
1153	!-- because it is forced by user) and set stop flag
1154	!-- This call is skipped if the remote model has already initiated a restart.
1155	IF ( .NOT. terminate_run ) CALL check_for_restart
1156
1157	!
1158	!-- Carry out statistical analysis and output at the requested output times.
1159	!-- The MOD function is used for calculating the output time counters (like
1160	!-- time_dopr) in order to regard a possible decrease of the output time
1161	!-- interval in case of restart runs
1162
1163	!
1164	!-- Set a flag indicating that so far no statistics have been created
1165	!-- for this time step
1166	flow_statistics_called = .FALSE.
1167
1168	!
1169	!-- If required, call flow_statistics for averaging in time
1170	IF ( averaging_interval_pr /= 0.0_wp .AND. &
1171	( dt_dopr - time_dopr ) <= averaging_interval_pr .AND. &
1172	simulated_time >= skip_time_dopr ) THEN
1173	time_dopr_av = time_dopr_av + dt_3d
1174	IF ( time_dopr_av >= dt_averaging_input_pr ) THEN
1175	do_sum = .TRUE.
1176	time_dopr_av = MOD( time_dopr_av, &
1177	MAX( dt_averaging_input_pr, dt_3d ) )
1178	ENDIF
1179	ENDIF
1180	IF ( do_sum ) CALL flow_statistics
1181
1182	!
1183	!-- Sum-up 3d-arrays for later output of time-averaged 2d/3d/masked data
1184	IF ( averaging_interval /= 0.0_wp .AND. &
1185	( dt_data_output_av - time_do_av ) <= averaging_interval .AND. &
1186	simulated_time >= skip_time_data_output_av ) &
1187	THEN
1188	time_do_sla = time_do_sla + dt_3d
1189	IF ( time_do_sla >= dt_averaging_input ) THEN
1190	CALL sum_up_3d_data
1191	average_count_3d = average_count_3d + 1
1192	time_do_sla = MOD( time_do_sla, MAX( dt_averaging_input, dt_3d ) )
1193	ENDIF
1194	ENDIF
1195
1196	!
1197	!-- Calculate spectra for time averaging
1198	IF ( averaging_interval_sp /= 0.0_wp .AND. &
1199	( dt_dosp - time_dosp ) <= averaging_interval_sp .AND. &
1200	simulated_time >= skip_time_dosp ) THEN
1201	time_dosp_av = time_dosp_av + dt_3d
1202	IF ( time_dosp_av >= dt_averaging_input_pr ) THEN
1203	CALL calc_spectra
1204	time_dosp_av = MOD( time_dosp_av, &
1205	MAX( dt_averaging_input_pr, dt_3d ) )
1206	ENDIF
1207	ENDIF
1208
1209	!
1210	!-- Call flight module and output data
1211	IF ( virtual_flight ) THEN
1212	CALL flight_measurement
1213	CALL data_output_flight
1214	ENDIF
1215
1216	!
1217	!-- Profile output (ASCII) on file
1218	IF ( time_dopr_listing >= dt_dopr_listing ) THEN
1219	CALL print_1d
1220	time_dopr_listing = MOD( time_dopr_listing, MAX( dt_dopr_listing, &
1221	dt_3d ) )
1222	ENDIF
1223
1224	!
1225	!-- Graphic output for PROFIL
1226	IF ( time_dopr >= dt_dopr ) THEN
1227	IF ( dopr_n /= 0 ) CALL data_output_profiles
1228	time_dopr = MOD( time_dopr, MAX( dt_dopr, dt_3d ) )
1229	time_dopr_av = 0.0_wp ! due to averaging (see above)
1230	ENDIF
1231
1232	!
1233	!-- Graphic output for time series
1234	IF ( time_dots >= dt_dots ) THEN
1235	CALL data_output_tseries
1236	time_dots = MOD( time_dots, MAX( dt_dots, dt_3d ) )
1237	ENDIF
1238
1239	!
1240	!-- Output of spectra (formatted for use with PROFIL), in case of no
1241	!-- time averaging, spectra has to be calculated before
1242	IF ( time_dosp >= dt_dosp ) THEN
1243	IF ( average_count_sp == 0 ) CALL calc_spectra
1244	CALL data_output_spectra
1245	time_dosp = MOD( time_dosp, MAX( dt_dosp, dt_3d ) )
1246	ENDIF
1247
1248	!
1249	!-- 2d-data output (cross-sections)
1250	IF ( time_do2d_xy >= dt_do2d_xy ) THEN
1251	CALL data_output_2d( 'xy', 0 )
1252	time_do2d_xy = MOD( time_do2d_xy, MAX( dt_do2d_xy, dt_3d ) )
1253	ENDIF
1254	IF ( time_do2d_xz >= dt_do2d_xz ) THEN
1255	CALL data_output_2d( 'xz', 0 )
1256	time_do2d_xz = MOD( time_do2d_xz, MAX( dt_do2d_xz, dt_3d ) )
1257	ENDIF
1258	IF ( time_do2d_yz >= dt_do2d_yz ) THEN
1259	CALL data_output_2d( 'yz', 0 )
1260	time_do2d_yz = MOD( time_do2d_yz, MAX( dt_do2d_yz, dt_3d ) )
1261	ENDIF
1262
1263	!
1264	!-- 3d-data output (volume data)
1265	IF ( time_do3d >= dt_do3d ) THEN
1266	CALL data_output_3d( 0 )
1267	time_do3d = MOD( time_do3d, MAX( dt_do3d, dt_3d ) )
1268	ENDIF
1269
1270	!
1271	!-- Masked data output
1272	DO mid = 1, masks
1273	IF ( time_domask(mid) >= dt_domask(mid) ) THEN
1274	CALL data_output_mask( 0 )
1275	time_domask(mid) = MOD( time_domask(mid), &
1276	MAX( dt_domask(mid), dt_3d ) )
1277	ENDIF
1278	ENDDO
1279
1280	!
1281	!-- Output of time-averaged 2d/3d/masked data
1282	IF ( time_do_av >= dt_data_output_av ) THEN
1283	CALL average_3d_data
1284	CALL data_output_2d( 'xy', 1 )
1285	CALL data_output_2d( 'xz', 1 )
1286	CALL data_output_2d( 'yz', 1 )
1287	CALL data_output_3d( 1 )
1288	DO mid = 1, masks
1289	CALL data_output_mask( 1 )
1290	ENDDO
1291	time_do_av = MOD( time_do_av, MAX( dt_data_output_av, dt_3d ) )
1292	ENDIF
1293
1294	!
1295	!-- Output of particle time series
1296	IF ( particle_advection ) THEN
1297	IF ( time_dopts >= dt_dopts .OR. &
1298	( simulated_time >= particle_advection_start .AND. &
1299	first_call_lpm ) ) THEN
1300	CALL data_output_ptseries
1301	time_dopts = MOD( time_dopts, MAX( dt_dopts, dt_3d ) )
1302	ENDIF
1303	ENDIF
1304
1305	!
1306	!-- Output of dvrp-graphics (isosurface, particles, slicer)
1307	#if defined( __dvrp_graphics )
1308	CALL DVRP_LOG_EVENT( -2, current_timestep_number-1 )
1309	#endif
1310	IF ( time_dvrp >= dt_dvrp ) THEN
1311	CALL data_output_dvrp
1312	time_dvrp = MOD( time_dvrp, MAX( dt_dvrp, dt_3d ) )
1313	ENDIF
1314	#if defined( __dvrp_graphics )
1315	CALL DVRP_LOG_EVENT( 2, current_timestep_number )
1316	#endif
1317
1318	!
1319	!-- If required, set the heat flux for the next time step at a random value
1320	IF ( constant_heatflux .AND. random_heatflux ) THEN
1321	IF ( surf_def_h(0)%ns >= 1 ) CALL disturb_heatflux( surf_def_h(0) )
1322	IF ( surf_lsm_h%ns >= 1 ) CALL disturb_heatflux( surf_lsm_h )
1323	IF ( surf_usm_h%ns >= 1 ) CALL disturb_heatflux( surf_usm_h )
1324	ENDIF
1325
1326	!
1327	!-- Execute the gust module actions
1328	IF ( gust_module_enabled ) THEN
1329	CALL gust_actions( 'after_timestep' )
1330	ENDIF
1331
1332	!
1333	!-- Execute user-defined actions
1334	CALL user_actions( 'after_timestep' )
1335
1336	!
1337	!-- Determine size of next time step. Save timestep dt_3d because it is
1338	!-- newly calculated in routine timestep, but required further below for
1339	!-- steering the run control output interval
1340	dt_3d_old = dt_3d
1341	CALL timestep
1342
1343	!
1344	!-- Synchronize the timestep in case of nested run.
1345	IF ( nested_run ) THEN
1346	!
1347	!-- Synchronize by unifying the time step.
1348	!-- Global minimum of all time-steps is used for all.
1349	CALL pmci_synchronize
1350	ENDIF
1351
1352	!
1353	!-- Computation and output of run control parameters.
1354	!-- This is also done whenever perturbations have been imposed
1355	IF ( time_run_control >= dt_run_control .OR. &
1356	timestep_scheme(1:5) /= 'runge' .OR. disturbance_created ) &
1357	THEN
1358	CALL run_control
1359	IF ( time_run_control >= dt_run_control ) THEN
1360	time_run_control = MOD( time_run_control, &
1361	MAX( dt_run_control, dt_3d_old ) )
1362	ENDIF
1363	ENDIF
1364
1365	!
1366	!-- Output elapsed simulated time in form of a progress bar on stdout
1367	IF ( myid == 0 ) CALL output_progress_bar
1368
1369	CALL cpu_log( log_point_s(10), 'timesteps', 'stop' )
1370
1371
1372	ENDDO ! time loop
1373
1374	!-- Vertical nesting: Deallocate variables initialized for vertical nesting
1375	IF ( vnest_init ) CALL vnest_deallocate
1376
1377	IF ( myid == 0 ) CALL finish_progress_bar
1378
1379	#if defined( __dvrp_graphics )
1380	CALL DVRP_LOG_EVENT( -2, current_timestep_number )
1381	#endif
1382
1383	CALL location_message( 'finished time-stepping', .TRUE. )
1384
1385	END SUBROUTINE time_integration

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

Download in other formats:

| Impressum | ©Leibniz Universität Hannover |