source: palm/trunk/SOURCE/disturb_field.f90 @ 3053

Last change on this file since 3053 was 2718, checked in by maronga, 7 years ago

deleting of deprecated files; headers updated where needed

  • Property svn:keywords set to Id
File size: 9.9 KB
Line 
1!> @file disturb_field.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: disturb_field.f90 2718 2018-01-02 08:49:38Z suehring $
27! Corrected "Former revisions" section
28!
29! 2696 2017-12-14 17:12:51Z kanani
30! Change in file header (GPL part)
31!
32! 2300 2017-06-29 13:31:14Z raasch
33! NEC related code removed
34!
35! 2233 2017-05-30 18:08:54Z suehring
36!
37! 2232 2017-05-30 17:47:52Z suehring
38! Modify referenced parameter for disturb_field, instead of nzb_uv_inner, pass
39! character to identify the respective grid (u- or v-grid).
40! Set perturbations within topography to zero using flags.
41!
42! 2172 2017-03-08 15:55:25Z knoop
43! Bugfix removed id_random_array from USE list
44!
45! 2000 2016-08-20 18:09:15Z knoop
46! Forced header and separation lines into 80 columns
47!
48! 1682 2015-10-07 23:56:08Z knoop
49! Code annotations made doxygen readable
50!
51! 1425 2014-07-05 10:57:53Z knoop
52! bugfix: Parallel random number generator loop: print-statement no needed
53!
54! 1400 2014-05-09 14:03:54Z knoop
55! Parallel random number generator added
56!
57! 1353 2014-04-08 15:21:23Z heinze
58! REAL constants provided with KIND-attribute
59!
60! 1322 2014-03-20 16:38:49Z raasch
61! REAL constants defined as wp-kind
62!
63! 1320 2014-03-20 08:40:49Z raasch
64! ONLY-attribute added to USE-statements,
65! kind-parameters added to all INTEGER and REAL declaration statements,
66! kinds are defined in new module kinds,
67! revision history before 2012 removed,
68! comment fields (!:) to be used for variable explanations added to
69! all variable declaration statements
70!
71! 1036 2012-10-22 13:43:42Z raasch
72! code put under GPL (PALM 3.9)
73!
74! Revision 1.1  1998/02/04 15:40:45  raasch
75! Initial revision
76!
77!
78! Description:
79! ------------
80!> Imposing a random perturbation on a 3D-array.
81!> On parallel computers, the random number generator is as well called for all
82!> gridpoints of the total domain to ensure, regardless of the number of PEs
83!> used, that the elements of the array have the same values in the same
84!> order in every case. The perturbation range is steered by dist_range.
85!------------------------------------------------------------------------------!
86 SUBROUTINE disturb_field( var_char, dist1, field )
87 
88
89    USE control_parameters,                                                    &
90        ONLY:  dist_nxl, dist_nxr, dist_nyn, dist_nys, dist_range,             &
91               disturbance_amplitude, disturbance_created,                     &
92               disturbance_level_ind_b, disturbance_level_ind_t, iran,         &
93               random_generator, topography
94               
95    USE cpulog,                                                                &
96        ONLY:  cpu_log, log_point
97       
98    USE indices,                                                               &
99        ONLY:  nbgp, nxl, nxlg, nxr, nxrg, nyn, nyng, nys, nysg, nzb, nzb_max, &
100               nzt, wall_flags_0
101       
102    USE kinds
103   
104    USE random_function_mod,                                                   &
105        ONLY: random_function
106       
107    USE random_generator_parallel,                                             &
108        ONLY:  random_number_parallel, random_seed_parallel, random_dummy,     &
109               seq_random_array
110
111    IMPLICIT NONE
112
113    CHARACTER (LEN = *) ::  var_char !< flag to distinguish betwenn u- and v-component
114
115    INTEGER(iwp) ::  flag_nr !< number of respective flag for u- or v-grid
116    INTEGER(iwp) ::  i       !< index variable
117    INTEGER(iwp) ::  j       !< index variable
118    INTEGER(iwp) ::  k       !< index variable
119
120    REAL(wp) ::  randomnumber  !<
121   
122    REAL(wp) ::  dist1(nzb:nzt+1,nysg:nyng,nxlg:nxrg)  !<
123    REAL(wp) ::  field(nzb:nzt+1,nysg:nyng,nxlg:nxrg)  !<
124   
125    REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  dist2  !<
126
127
128    CALL cpu_log( log_point(20), 'disturb_field', 'start' )
129!
130!-- Set flag number, 20 for u-grid, 21 for v-grid, required to mask topography
131    flag_nr = MERGE( 20, 21, TRIM(var_char) == 'u' )
132!
133!-- Create an additional temporary array and initialize the arrays needed
134!-- to store the disturbance
135    ALLOCATE( dist2(nzb:nzt+1,nysg:nyng,nxlg:nxrg) )
136    dist1 = 0.0_wp
137    dist2 = 0.0_wp
138
139!
140!-- Create the random perturbation and store it on temporary array
141    IF ( random_generator == 'numerical-recipes' )  THEN
142       DO  i = dist_nxl(dist_range), dist_nxr(dist_range)
143          DO  j = dist_nys(dist_range), dist_nyn(dist_range)
144             DO  k = disturbance_level_ind_b, disturbance_level_ind_t
145                randomnumber = 3.0_wp * disturbance_amplitude *                &
146                               ( random_function( iran ) - 0.5_wp )
147                IF ( nxl <= i  .AND.  nxr >= i  .AND.  nys <= j  .AND.         &
148                     nyn >= j )                                                &
149                THEN
150                   dist1(k,j,i) = randomnumber
151                ENDIF
152             ENDDO
153          ENDDO
154       ENDDO
155    ELSEIF ( random_generator == 'random-parallel' )  THEN
156       DO  i = dist_nxl(dist_range), dist_nxr(dist_range)
157          DO  j = dist_nys(dist_range), dist_nyn(dist_range)
158             CALL random_seed_parallel( put=seq_random_array(:, j, i) )
159             DO  k = disturbance_level_ind_b, disturbance_level_ind_t
160                CALL random_number_parallel( random_dummy )
161                randomnumber = 3.0_wp * disturbance_amplitude *                &
162                               ( random_dummy - 0.5_wp )
163                IF ( nxl <= i  .AND.  nxr >= i  .AND.  nys <= j  .AND.         &
164                     nyn >= j )                                                &
165                THEN
166                   dist1(k,j,i) = randomnumber
167                ENDIF
168             ENDDO
169             CALL random_seed_parallel( get=seq_random_array(:, j, i) )
170          ENDDO
171       ENDDO
172    ELSEIF ( random_generator == 'system-specific' )  THEN
173       DO  i = dist_nxl(dist_range), dist_nxr(dist_range)
174          DO  j = dist_nys(dist_range), dist_nyn(dist_range)
175             DO  k = disturbance_level_ind_b, disturbance_level_ind_t
176                CALL RANDOM_NUMBER( randomnumber )
177                randomnumber = 3.0_wp * disturbance_amplitude *                &
178                                ( randomnumber - 0.5_wp )
179                IF ( nxl <= i .AND. nxr >= i .AND. nys <= j .AND. nyn >= j )   &
180                THEN
181                   dist1(k,j,i) = randomnumber
182                ENDIF
183             ENDDO
184          ENDDO
185       ENDDO
186
187    ENDIF
188
189!
190!-- Exchange of ghost points for the random perturbation
191
192    CALL exchange_horiz( dist1, nbgp )
193!
194!-- Applying the Shuman filter in order to smooth the perturbations.
195!-- Neighboured grid points in all three directions are used for the
196!-- filter operation.
197!-- Loop has been splitted to make runs reproducible on HLRN systems using
198!-- compiler option -O3
199     DO  i = nxl, nxr
200        DO  j = nys, nyn
201          DO  k = disturbance_level_ind_b-1, disturbance_level_ind_t+1
202             dist2(k,j,i) = ( dist1(k,j,i-1) + dist1(k,j,i+1)                  &
203                            + dist1(k,j+1,i) + dist1(k+1,j,i)                  &
204                            ) / 12.0_wp
205          ENDDO
206          DO  k = disturbance_level_ind_b-1, disturbance_level_ind_t+1
207              dist2(k,j,i) = dist2(k,j,i) + ( dist1(k,j-1,i) + dist1(k-1,j,i)  &
208                            + 6.0_wp * dist1(k,j,i)                            &
209                            ) / 12.0_wp
210          ENDDO
211        ENDDO
212     ENDDO
213
214!
215!-- Exchange of ghost points for the filtered perturbation.
216!-- Afterwards, filter operation and exchange of ghost points are repeated.
217    CALL exchange_horiz( dist2, nbgp )
218
219    DO  i = nxl, nxr
220       DO  j = nys, nyn
221          DO  k = disturbance_level_ind_b-2, disturbance_level_ind_t+2
222             dist1(k,j,i) = ( dist2(k,j,i-1) + dist2(k,j,i+1) + dist2(k,j-1,i) &
223                            + dist2(k,j+1,i) + dist2(k+1,j,i) + dist2(k-1,j,i) &
224                            + 6.0_wp * dist2(k,j,i)                            &
225                            ) / 12.0_wp
226          ENDDO
227       ENDDO
228    ENDDO
229
230    CALL exchange_horiz( dist1, nbgp )
231
232!
233!-- Remove perturbations below topography (including one gridpoint above it
234!-- in order to allow for larger timesteps at the beginning of the simulation
235!-- (diffusion criterion))
236    IF ( TRIM( topography ) /= 'flat' )  THEN
237       DO  i = nxlg, nxrg
238          DO  j = nysg, nyng
239             DO  k = nzb, nzb_max
240                dist1(k,j,i) = MERGE( dist1(k,j,i), 0.0_wp,                    &
241                                      BTEST( wall_flags_0(k,j,i), flag_nr )    &
242                                    )
243             ENDDO
244          ENDDO
245       ENDDO
246    ENDIF
247
248!
249!-- Random perturbation is added to the array to be disturbed.
250    DO  i = nxlg, nxrg
251       DO  j = nysg, nyng
252          DO  k = disturbance_level_ind_b-2, disturbance_level_ind_t+2
253             field(k,j,i) = field(k,j,i) + dist1(k,j,i)
254          ENDDO
255       ENDDO
256    ENDDO
257
258!
259!-- Deallocate the temporary array
260    DEALLOCATE( dist2 )
261
262!
263!-- Set a flag, which indicates that a random perturbation is imposed
264    disturbance_created = .TRUE.
265
266
267    CALL cpu_log( log_point(20), 'disturb_field', 'stop' )
268
269
270 END SUBROUTINE disturb_field
Note: See TracBrowser for help on using the repository browser.