New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
ldfdyn_c3d.h90 in branches/2015/dev_r5721_CNRS9_NOC3_LDF/NEMOGCM/NEMO/OPA_SRC/LDF – NEMO

source: branches/2015/dev_r5721_CNRS9_NOC3_LDF/NEMOGCM/NEMO/OPA_SRC/LDF/ldfdyn_c3d.h90 @ 5758

Last change on this file since 5758 was 5758, checked in by gm, 9 years ago

#1593: LDF-ADV, step II.1: phasing the improvements/simplifications of diffusive trend (see wiki)

  • Property svn:keywords set to Id
File size: 17.8 KB
Line 
1   !!----------------------------------------------------------------------
2   !!                        ***  ldfdyn_c3d.h90  ***
3   !!----------------------------------------------------------------------
4
5   !!----------------------------------------------------------------------
6   !! NEMO/OPA 3.3 , NEMO Consortium (2010)
7   !! $Id$
8   !! Software governed by the CeCILL licence (NEMOGCM/NEMO_CeCILL.txt)
9   !!----------------------------------------------------------------------
10
11   !!----------------------------------------------------------------------
12   !!   'key_dynldf_c3d'             3D lateral eddy viscosity coefficients
13   !!----------------------------------------------------------------------
14
15   SUBROUTINE ldf_dyn_c3d( ld_print )
16      !!----------------------------------------------------------------------
17      !!                  ***  ROUTINE ldf_dyn_c3d  ***
18      !!                   
19      !! ** Purpose :   initializations of the horizontal ocean physics
20      !!
21      !! ** Method  :   3D eddy viscosity coef. ( longitude, latitude, depth )
22      !!       laplacian operator   : ahm1, ahm2 defined at T- and F-points
23      !!                              ahm2, ahm4 never used
24      !!       bilaplacian operator : ahm1, ahm2 never used
25      !!                           :  ahm3, ahm4 defined at U- and V-points
26      !!       ??? explanation of the default is missing
27      !!----------------------------------------------------------------------
28      USE ldftra, ONLY :   rn_aht_0
29      USE iom
30      !!
31      LOGICAL, INTENT (in) ::   ld_print   ! If true, output arrays on numout
32      !!
33      INTEGER  ::   ji, jj, jk   ! dummy loop indices
34      REAL(wp) ::   zr = 0.2     ! maximum of the reduction factor at the bottom ocean ( 0 < zr < 1 )
35      REAL(wp) ::   zh = 500.    ! depth of at which start the reduction ( > dept(1) )
36      REAL(wp) ::   zd_max       ! maximum grid spacing over the global domain
37      REAL(wp) ::   za00, zc, zd, zetmax, zefmax, zeumax, zevmax   ! local scalars
38      REAL(wp), POINTER, DIMENSION(:) :: zcoef   
39      !!----------------------------------------------------------------------
40      !
41      CALL wrk_alloc( jpk, zcoef )
42      !
43      IF(lwp) WRITE(numout,*)
44      IF(lwp) WRITE(numout,*) 'ldf_dyn_c3d : 3D lateral eddy viscosity coefficient'
45      IF(lwp) WRITE(numout,*) '~~~~~~~~~~~'
46
47     
48      ! Set ahm1 and ahm2  ( T- and F- points) (used for laplacian operators
49      ! =================                       whatever its orientation is)
50      IF( ln_dynldf_lap ) THEN
51         ! define ahm1 and ahm2 at the right grid point position
52         ! (USER: modify ahm1 and ahm2 following your desiderata)
53
54         zd_max = MAX( MAXVAL( e1t(:,:) ), MAXVAL( e2t(:,:) ) )
55         IF( lk_mpp )   CALL mpp_max( zd_max )   ! max over the global domain
56
57         IF(lwp) WRITE(numout,*) '              laplacian operator: ahm proportional to e1'
58         IF(lwp) WRITE(numout,*) '              maximum grid-spacing = ', zd_max, ' maximum value for ahm = ', ahm0
59
60         za00 = ahm0 / zd_max
61
62         IF( ln_dynldf_iso ) THEN
63            IF(lwp) WRITE(numout,*) '              Caution, as implemented now, the isopycnal part of momentum'
64            IF(lwp) WRITE(numout,*) '                 mixing use aht0 as eddy viscosity coefficient. Thus, it is'
65            IF(lwp) WRITE(numout,*) '                 uniform and you must be sure that your ahm is greater than'
66            IF(lwp) WRITE(numout,*) '                 aht0 everywhere in the model domain.'
67         ENDIF
68
69         CALL ldf_zpf( .TRUE. , 1000., 500., 0.25, fsdept(:,:,:), ahm1 )   ! vertical profile
70         CALL ldf_zpf( .TRUE. , 1000., 500., 0.25, fsdept(:,:,:), ahm2 )   ! vertical profile
71         DO jk = 1,jpk
72            DO jj = 1, jpj
73               DO ji = 1, jpi
74                  zetmax = MAX( e1t(ji,jj), e2t(ji,jj) )
75                  zefmax = MAX( e1f(ji,jj), e2f(ji,jj) )
76                  ahm1(ji,jj,jk) = za00 * zetmax * ahm1(ji,jj,jk)
77                  ahm2(ji,jj,jk) = za00 * zefmax * ahm2(ji,jj,jk)
78               END DO
79            END DO
80         END DO
81
82
83         ! Special case for ORCA R1, R2 and R4 configurations (overwrite the value of ahm1 ahm2)
84         ! ==============================================
85         IF( cp_cfg == "orca" .AND. ( jp_cfg == 1 .OR. jp_cfg == 2 .OR. jp_cfg == 4 ) ) THEN
86            IF(lwp) WRITE(numout,*)
87            IF(lwp) WRITE(numout,*) '              ORCA R1, R2 or R4: overwrite the previous definition of ahm'
88            IF(lwp) WRITE(numout,*) '              ================='
89            CALL ldf_dyn_c3d_orca( ld_print )
90         ENDIF
91
92      ENDIF
93     
94      ! Control print
95      IF(lwp .AND. ld_print ) THEN
96         WRITE(numout,*)
97         WRITE(numout,*) '         3D ahm1 array (k=1)'
98         CALL prihre( ahm1(:,:,1), jpi, jpj, 1, jpi, 20, 1, jpj, 20, 1.e-3, numout )
99         WRITE(numout,*)
100         WRITE(numout,*) '         3D ahm2 array (k=1)'
101         CALL prihre( ahm2(:,:,1), jpi, jpj, 1, jpi, 20, 1, jpj, 20, 1.e-3, numout )
102      ENDIF
103
104
105      ! ahm3 and ahm4 at U- and V-points (used for bilaplacian operator
106      ! ================================  whatever its orientation is)
107      ! (USER: modify ahm3 and ahm4 following your desiderata)
108      ! Here: ahm is proportional to the cube of the maximum of the gridspacing
109      !       in the to horizontal direction
110
111      IF( ln_dynldf_bilap ) THEN
112
113         zd_max = MAX( MAXVAL( e1u(:,:) ), MAXVAL( e2u(:,:) ) )
114         IF( lk_mpp )   CALL mpp_max( zd_max )   ! max over the global domain
115
116         IF(lwp) WRITE(numout,*) '              bi-laplacian operator: ahm proportional to e1**3 '
117         IF(lwp) WRITE(numout,*) '              maximum grid-spacing = ', zd_max, ' maximum value for ahm = ', ahm0
118
119         za00 = ahm0_blp / ( zd_max * zd_max * zd_max )
120         DO jj = 1, jpj
121            DO ji = 1, jpi
122               zeumax = MAX( e1u(ji,jj), e2u(ji,jj) )
123               zevmax = MAX( e1v(ji,jj), e2v(ji,jj) )
124               ahm3(ji,jj,1) = za00 * zeumax * zeumax * zeumax
125               ahm4(ji,jj,1) = za00 * zevmax * zevmax * zevmax
126            END DO
127         END DO
128
129         zh = MAX( zh, fsdept(1,1,1) )   ! at least the first reach ahm0
130         IF( ln_zco ) THEN               ! z-coordinate, same profile everywhere
131            IF(lwp) WRITE(numout,'(36x," ahm ", 7x)')
132            DO jk = 1, jpk
133               IF( fsdept(1,1,jk) <= zh ) THEN
134                  zcoef(jk) = 1.e0
135               ELSE
136                  zcoef(jk) = 1.e0 + ( zr - 1.e0 )   &
137                     &               * (  1. - EXP( ( fsdept(1,1,jk   ) - zh ) / zh )  )   &
138                     &               / (  1. - EXP( ( fsdept(1,1,jpkm1) - zh ) / zh )  )
139               ENDIF
140               ahm3(:,:,jk) = ahm3(:,:,1) * zcoef(jk)
141               ahm4(:,:,jk) = ahm4(:,:,1) * zcoef(jk)
142               IF(lwp) WRITE(numout,'(34x,E7.2,8x,i3)') zcoef(jk) * ahm0, jk
143            END DO
144         ELSE                            ! partial steps or s-ccordinate
145            zc = MAXVAL( fsdept(:,:,jpkm1) )
146            IF( lk_mpp )   CALL mpp_max( zc )   ! max over the global domain
147
148            zc = 1. / (  1. - EXP( ( zc - zh ) / zh )  )
149            DO jk = 2, jpkm1
150               DO jj = 1, jpj
151                  DO ji = 1, jpi
152                     IF( fsdept(ji,jj,jk) <= zh ) THEN
153                        ahm3(ji,jj,jk) = ahm3(ji,jj,1)
154                        ahm4(ji,jj,jk) = ahm4(ji,jj,1)
155                     ELSE
156                        zd = 1.e0 + ( zr - 1.e0 ) * (  1. - EXP( ( fsdept(ji,jj,jk) - zh ) / zh )  ) * zc
157                        ahm3(ji,jj,jk) = ahm3(ji,jj,1) * zd
158                        ahm4(ji,jj,jk) = ahm4(ji,jj,1) * zd
159                     ENDIF
160                  END DO
161               END DO
162            END DO
163            ahm3(:,:,jpk) = ahm3(:,:,jpkm1)
164            ahm4(:,:,jpk) = ahm4(:,:,jpkm1)
165            IF(lwp) WRITE(numout,'(36x," ahm ", 7x)')
166            DO jk = 1, jpk
167               IF(lwp) WRITE(numout,'(30x,E10.2,8x,i3)') ahm3(1,1,jk), jk
168            END DO
169         ENDIF
170
171         ! Control print
172         IF( lwp .AND. ld_print ) THEN
173            WRITE(numout,*)
174            WRITE(numout,*) 'inildf: ahm3 array at level 1'
175            CALL prihre(ahm3(:,:,1  ),jpi,jpj,1,jpi,1,1,jpj,1,1.e-3,numout)
176            WRITE(numout,*)
177            WRITE(numout,*) 'inildf: ahm4 array at level 1'
178            CALL prihre(ahm4(:,:,jpk),jpi,jpj,1,jpi,1,1,jpj,1,1.e-3,numout)
179         ENDIF
180      ENDIF
181      !
182      CALL wrk_dealloc( jpk, zcoef )
183      !
184   END SUBROUTINE ldf_dyn_c3d
185
186
187   SUBROUTINE ldf_dyn_c3d_orca( ld_print )
188      !!----------------------------------------------------------------------
189      !!                  ***  ROUTINE ldf_dyn_c3d  ***
190      !!                   
191      !! ** Purpose :   ORCA R1, R2 and R4 only
192      !!
193      !! ** Method  :   blah blah blah ....
194      !!----------------------------------------------------------------------
195      USE ldftra, ONLY:   rn_aht_0
196      USE iom
197      !!
198      LOGICAL, INTENT(in) ::   ld_print   ! If true, output arrays on numout
199      !!
200      INTEGER ::   ji, jj, jk, jn      ! dummy loop indices
201      INTEGER ::   ii0, ii1, ij0, ij1  ! local integers
202      INTEGER ::   inum, iim, ijm      !
203      INTEGER ::   ifreq, il1, il2, ij, ii
204      REAL(wp) ::   zahmeq, zcoff, zcoft, zmsk   ! local scalars
205      REAL(wp) ::   zemax , zemin, zeref, zahmm
206      CHARACTER (len=15) ::   clexp
207      INTEGER , POINTER, DIMENSION(:,:)  :: icof
208      REAL(wp), POINTER, DIMENSION(:  )  :: zcoef   
209      REAL(wp), POINTER, DIMENSION(:,:)  :: zahm0
210      !
211      REAL(wp), DIMENSION(:,:), ALLOCATABLE ::   ztemp2d  ! temporary array to read ahmcoef file
212      !!----------------------------------------------------------------------
213      !
214      CALL wrk_alloc( jpi   , jpj   , icof  )
215      CALL wrk_alloc( jpk   ,         zcoef )
216      CALL wrk_alloc( jpi   , jpj   , zahm0 )
217      !
218      IF(lwp) WRITE(numout,*)
219      IF(lwp) WRITE(numout,*) 'ldfdyn_c3d_orca : 3D eddy viscosity coefficient'
220      IF(lwp) WRITE(numout,*) '~~~~~~~~~~~~~~~'
221      IF(lwp) WRITE(numout,*) '        orca R1, R2 or R4 configuration: reduced in the surface Eq. strip '
222
223      ! Read 2d integer array to specify western boundary increase in the
224      ! ===================== equatorial strip (20N-20S) defined at t-points
225      ALLOCATE( ztemp2d(jpi,jpj) )
226      ztemp2d(:,:) = 0.
227      CALL iom_open ( 'ahmcoef.nc', inum )
228      CALL iom_get  ( inum, jpdom_data, 'icof', ztemp2d)
229      icof(:,:)  = NINT(ztemp2d(:,:))
230      CALL iom_close( inum )
231      DEALLOCATE(ztemp2d)
232
233      ! Set ahm1 and ahm2
234      ! =================
235     
236      ! define ahm1 and ahm2 at the right grid point position
237      ! (USER: modify ahm1 and ahm2 following your desiderata)
238      ! biharmonic : ahm1 (ahm2) defined at u- (v-) point
239      ! harmonic   : ahm1 (ahm2) defined at t- (f-) point
240     
241      ! first level : as for 2D coefficients
242     
243      ! Decrease ahm to zahmeq m2/s in the tropics
244      ! (from 90 to 20 degre: ahm = constant
245      ! from 20 to  2.5 degre: ahm = decrease in (1-cos)/2
246      ! from  2.5 to  0 degre: ahm = constant
247      ! symmetric in the south hemisphere)
248     
249      IF( jp_cfg == 4 )   THEN
250         zahmeq = 5.0 * rn_aht_0
251         zahmm  = min( 160000.0, ahm0)
252         zemax = MAXVAL ( e1t(:,:) * e2t(:,:), tmask(:,:,1) .GE. 0.5 )
253         zemin = MINVAL ( e1t(:,:) * e2t(:,:), tmask(:,:,1) .GE. 0.5 )
254         zeref = MAXVAL ( e1t(:,:) * e2t(:,:),   &
255             &   tmask(:,:,1) .GE. 0.5 .AND. ABS(gphit(:,:)) .GT. 50. )
256 
257         DO jj = 1, jpj
258           DO ji = 1, jpi
259              zmsk = e1t(ji,jj) * e2t(ji,jj)
260              IF( abs(gphit(ji,jj)) .LE. 15 ) THEN
261                 zahm0(ji,jj) = ahm0
262              ELSE
263                 IF( zmsk .GE. zeref ) THEN
264                    zahm0(ji,jj) = ahm0
265                 ELSE
266                    zahm0(ji,jj) = zahmm + (ahm0-zahmm)*(1.0 -   &
267                        &          cos((rpi*0.5*(zmsk-zemin)/(zeref-zemin))))
268                 ENDIF
269              ENDIF
270           END DO
271         END DO
272      ENDIF
273
274      IF( jp_cfg == 2 )   THEN
275         zahmeq     = rn_aht_0
276         zahmm      = ahm0
277         zahm0(:,:) = ahm0
278      ENDIF
279
280      IF( jp_cfg == 1 )   THEN
281         zahmeq     = rn_aht_0  ! reduced to aht0 on equator; set to ahm0 if no tropical reduction is required
282         zahmm      = ahm0
283         zahm0(:,:) = ahm0
284      ENDIF
285
286      DO jj = 1, jpj
287         DO ji = 1, jpi
288            IF( ABS(gphif(ji,jj)) >= 20.) THEN
289               ahm2(ji,jj,1) =  zahm0(ji,jj)
290            ELSEIF( ABS(gphif(ji,jj)) <= 2.5) THEN
291               ahm2(ji,jj,1) =  zahmeq
292            ELSE
293               ahm2(ji,jj,1) = zahmeq + (zahm0(ji,jj)-zahmeq)/2.   &
294                  &            *(1.-COS( rad*(ABS(gphif(ji,jj))-2.5)*180./17.5 ) )
295            ENDIF
296            IF( ABS(gphit(ji,jj)) >= 20.) THEN
297               ahm1(ji,jj,1) =  zahm0(ji,jj)
298            ELSEIF( ABS(gphit(ji,jj)) <= 2.5) THEN
299               ahm1(ji,jj,1) =  zahmeq
300            ELSE
301               ahm1(ji,jj,1) = zahmeq + (zahm0(ji,jj)-zahmeq)/2.   &
302                  &            *(1.-COS( rad*(ABS(gphit(ji,jj))-2.5)*180./17.5 ) )
303            ENDIF
304         END DO
305      END DO
306     
307      ! increase along western boundaries of equatorial strip
308      ! t-point
309      DO jj = 1, jpjm1
310         DO ji = 1, jpim1
311            zcoft = float( icof(ji,jj) ) / 100.
312            ahm1(ji,jj,1) = zcoft * zahm0(ji,jj) + (1.-zcoft) * ahm1(ji,jj,1)
313         END DO
314      END DO
315      ! f-point
316      icof(:,:) = icof(:,:) * tmask(:,:,1)
317      DO jj = 1, jpjm1
318         DO ji = 1, jpim1   ! NO vector opt.
319            zmsk = tmask(ji,jj+1,1) + tmask(ji+1,jj+1,1) + tmask(ji,jj,1) + tmask(ji,jj+1,1)
320            IF( zmsk == 0. ) THEN
321               zcoff = 1.
322            ELSE
323               zcoff = FLOAT( icof(ji,jj+1) + icof(ji+1,jj+1) + icof(ji,jj) + icof(ji,jj+1) )   &
324                     / (zmsk * 100.)
325            ENDIF
326            ahm2(ji,jj,1) = zcoff * zahm0(ji,jj) + (1.-zcoff) * ahm2(ji,jj,1)
327         END DO
328      END DO
329
330      ! other level: re-increase the coef in the deep ocean
331      !==================================================================
332      ! Prior to v3.3, zcoeff was hardwired according to k-index jk.
333      !
334      ! From v3.3 onwards this has been generalised to a function of
335      ! depth so that it can be used with any number of levels.
336      !
337      ! The function has been chosen to match the original values (shown
338      ! in the following comments) when using the standard 31 ORCA levels. 
339      !     DO jk = 1, 21
340      !        zcoef(jk) = 1._wp
341      !     END DO
342      !     zcoef(22) = 2._wp
343      !     zcoef(23) = 3._wp
344      !     zcoef(24) = 5._wp
345      !     zcoef(25) = 7._wp
346      !     zcoef(26) = 9._wp
347      !     DO jk = 27, jpk
348      !        zcoef(jk) = 10._wp
349      !     END DO
350      !==================================================================
351
352       IF(lwp) THEN
353          WRITE(numout,*)
354          WRITE(numout,*) '         1D zcoef array '
355          WRITE(numout,*) '         ~~~~~~~~~~~~~~ '
356          WRITE(numout,*)
357          WRITE(numout,*) '    jk        zcoef '
358       ENDIF
359
360      DO jk=1, jpk
361         zcoef(jk) = 1.0_wp + NINT(9.0_wp*(gdept_1d(jk)-800.0_wp)/(3000.0_wp-800.0_wp))
362         zcoef(jk) = MIN(10.0_wp, MAX(1.0_wp, zcoef(jk)))
363         IF(lwp) WRITE(numout,'(4x,i3,6x,f7.3)') jk,zcoef(jk)
364      END DO
365
366      DO jk = 2, jpk
367         ahm1(:,:,jk) = MIN( zahm0(:,:), zcoef(jk) * ahm1(:,:,1) )
368         ahm2(:,:,jk) = MIN( zahm0(:,:), zcoef(jk) * ahm2(:,:,1) )
369      END DO
370
371      IF( jp_cfg == 4 )   THEN         ! Limit AHM in Gibraltar strait
372         ij0 = 50   ;   ij1 = 53
373         ii0 = 69   ;   ii1 = 71
374         DO jk = 1, jpk
375            ahm1(mi0(ii0):mi1(ii1),mj0(ij0):mj1(ij1),jk) = MIN( zahmm, ahm1(mi0(ii0):mi1(ii1),mj0(ij0):mj1(ij1),jk) )
376            ahm2(mi0(ii0):mi1(ii1),mj0(ij0):mj1(ij1),jk) = MIN( zahmm, ahm2(mi0(ii0):mi1(ii1),mj0(ij0):mj1(ij1),jk) )
377         END DO
378      ENDIF
379      CALL lbc_lnk( ahm1, 'T', 1. )   ! Lateral boundary conditions (unchanged sign)
380      CALL lbc_lnk( ahm2, 'F', 1. )
381
382
383      IF(lwp) THEN                    ! Control print
384         WRITE(numout,*)
385         WRITE(numout,*) '         3D ahm1 array (k=1)'
386         CALL prihre( ahm1(:,:,1), jpi, jpj, 1, jpi, 20, 1, jpj, 20, 1.e-3, numout )
387         WRITE(numout,*)
388         WRITE(numout,*) '         3D ahm2 array (k=1)'
389         CALL prihre( ahm2(:,:,1), jpi, jpj, 1, jpi, 20, 1, jpj, 20, 1.e-3, numout )
390         WRITE(numout,*)
391         WRITE(numout,*) '         3D ahm2 array (k=jpk)'
392         CALL prihre( ahm2(:,:,jpk), jpi, jpj, 1, jpi, 20, 1, jpj, 20, 1.e-3, numout )
393      ENDIF
394
395
396      ! Set ahm3 and ahm4
397      ! =================
398
399      ! define ahm3 and ahm4 at the right grid point position
400      ! initialization to a constant value
401      !     (USER: modify ahm3 and ahm4 following your desiderata)
402      !     harmonic isopycnal or geopotential:
403      !                          ahm3 (ahm4) defined at u- (v-) point
404      DO jk = 1, jpk
405         DO jj = 2, jpj
406            DO ji = 2, jpi
407               ahm3(ji,jj,jk) = 0.5 * ( ahm2(ji,jj,jk) + ahm2(ji  ,jj-1,jk) )
408               ahm4(ji,jj,jk) = 0.5 * ( ahm2(ji,jj,jk) + ahm2(ji-1,jj  ,jk) )
409            END DO
410         END DO
411      END DO
412      ahm3 ( :, 1, :) = ahm3 ( :, 2, :)
413      ahm4 ( :, 1, :) = ahm4 ( :, 2, :)
414     
415      CALL lbc_lnk( ahm3, 'U', 1. )    ! Lateral boundary conditions (unchanged sign)
416      CALL lbc_lnk( ahm4, 'V', 1. )
417
418      ! Control print
419
420      IF( lwp .AND. ld_print ) THEN
421         WRITE(numout,*)
422         WRITE(numout,*) '         ahm3 array level 1'
423         CALL prihre(ahm3(:,:,1),jpi,jpj,1,jpi,1,1,jpj,1,1.e-3,numout)
424         WRITE(numout,*)
425         WRITE(numout,*) '         ahm4 array level 1'
426         CALL prihre(ahm4(:,:,1),jpi,jpj,1,jpi,1,1,jpj,1,1.e-3,numout)
427      ENDIF
428      !
429      CALL wrk_dealloc( jpi   , jpj   , icof  )
430      CALL wrk_dealloc( jpk   ,         zcoef )
431      CALL wrk_dealloc( jpi   , jpj   , zahm0 )
432      !
433   END SUBROUTINE ldf_dyn_c3d_orca
Note: See TracBrowser for help on using the repository browser.