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.
mppini.F90 in branches/UKMO/dev_r10171_test_crs_AMM7/NEMOGCM/NEMO/OPA_SRC/LBC – NEMO

source: branches/UKMO/dev_r10171_test_crs_AMM7/NEMOGCM/NEMO/OPA_SRC/LBC/mppini.F90 @ 10207

Last change on this file since 10207 was 10207, checked in by cmao, 6 years ago

remove svn keyword

File size: 18.4 KB
Line 
1MODULE mppini
2   !!==============================================================================
3   !!                       ***  MODULE mppini   ***
4   !! Ocean initialization : distributed memory computing initialization
5   !!==============================================================================
6
7   !!----------------------------------------------------------------------
8   !!   mpp_init       : Lay out the global domain over processors
9   !!   mpp_init2      : Lay out the global domain over processors
10   !!                    with land processor elimination
11   !!   mpp_init_ioispl: IOIPSL initialization in mpp
12   !!----------------------------------------------------------------------
13   !! * Modules used
14   USE dom_oce         ! ocean space and time domain
15   USE in_out_manager  ! I/O Manager
16   USE lib_mpp         ! distribued memory computing library
17   USE ioipsl
18
19   IMPLICIT NONE
20   PRIVATE
21
22   PUBLIC mpp_init       ! called by opa.F90
23   PUBLIC mpp_init2      ! called by opa.F90
24
25   !! * Substitutions
26#  include "domzgr_substitute.h90"
27   !!----------------------------------------------------------------------
28   !! NEMO/OPA 3.3 , NEMO Consortium (2010)
29   !! $Id$
30   !! Software governed by the CeCILL licence     (NEMOGCM/NEMO_CeCILL.txt)
31   !!----------------------------------------------------------------------
32CONTAINS
33
34#if ! defined key_mpp_mpi
35   !!----------------------------------------------------------------------
36   !!   Default option :                            shared memory computing
37   !!----------------------------------------------------------------------
38
39   SUBROUTINE mpp_init
40      !!----------------------------------------------------------------------
41      !!                  ***  ROUTINE mpp_init  ***
42      !!
43      !! ** Purpose :   Lay out the global domain over processors.
44      !!
45      !! ** Method  :   Shared memory computing, set the local processor
46      !!      variables to the value of the global domain
47      !!
48      !! History :
49      !!   9.0  !  04-01  (G. Madec, J.M. Molines)  F90 : free form, north fold jpni >1
50      !!----------------------------------------------------------------------
51
52      ! No mpp computation
53      nimpp  = 1
54      njmpp  = 1
55      nlci   = jpi
56      nlcj   = jpj
57      nldi   = 1
58      nldj   = 1
59      nlei   = jpi
60      nlej   = jpj
61      nperio = jperio
62      nbondi = 2
63      nbondj = 2
64      nidom  = FLIO_DOM_NONE
65      npolj = jperio
66
67      IF(lwp) THEN
68         WRITE(numout,*)
69         WRITE(numout,*) 'mpp_init(2) : NO massively parallel processing'
70         WRITE(numout,*) '~~~~~~~~~~~: '
71         WRITE(numout,*) '         nperio = ', nperio
72         WRITE(numout,*) '         npolj  = ', npolj
73         WRITE(numout,*) '         nimpp  = ', nimpp
74         WRITE(numout,*) '         njmpp  = ', njmpp
75      ENDIF
76
77      IF(  jpni /= 1 .OR. jpnj /= 1 .OR. jpnij /= 1 ) &
78          CALL ctl_stop( 'equality  jpni = jpnj = jpnij = 1 is not satisfied',   &
79          &              'the domain is lay out for distributed memory computing! ' )
80
81   END SUBROUTINE mpp_init
82
83
84   SUBROUTINE mpp_init2 
85      CALL mpp_init                             ! same routine as mpp_init
86   END SUBROUTINE mpp_init2
87
88#else
89   !!----------------------------------------------------------------------
90   !!   'key_mpp_mpi'          OR         MPI massively parallel processing
91   !!----------------------------------------------------------------------
92
93   SUBROUTINE mpp_init
94      !!----------------------------------------------------------------------
95      !!                  ***  ROUTINE mpp_init  ***
96      !!                   
97      !! ** Purpose :   Lay out the global domain over processors.
98      !!
99      !! ** Method  :   Global domain is distributed in smaller local domains.
100      !!      Periodic condition is a function of the local domain position
101      !!      (global boundary or neighbouring domain) and of the global
102      !!      periodic
103      !!      Type :         jperio global periodic condition
104      !!                     nperio local  periodic condition
105      !!
106      !! ** Action  : - set domain parameters
107      !!                    nimpp     : longitudinal index
108      !!                    njmpp     : latitudinal  index
109      !!                    nperio    : lateral condition type
110      !!                    narea     : number for local area
111      !!                    nlci      : first dimension
112      !!                    nlcj      : second dimension
113      !!                    nbondi    : mark for "east-west local boundary"
114      !!                    nbondj    : mark for "north-south local boundary"
115      !!                    nproc     : number for local processor
116      !!                    noea      : number for local neighboring processor
117      !!                    nowe      : number for local neighboring processor
118      !!                    noso      : number for local neighboring processor
119      !!                    nono      : number for local neighboring processor
120      !!
121      !! History :
122      !!        !  94-11  (M. Guyon)  Original code
123      !!        !  95-04  (J. Escobar, M. Imbard)
124      !!        !  98-02  (M. Guyon)  FETI method
125      !!        !  98-05  (M. Imbard, J. Escobar, L. Colombet )  SHMEM and MPI versions
126      !!   8.5  !  02-08  (G. Madec)  F90 : free form
127      !!   3.4  !  11-11  (C. Harris) decomposition changes for running with CICE
128      !!----------------------------------------------------------------------
129      INTEGER  ::   ji, jj, jn   ! dummy loop indices
130      INTEGER  ::   ii, ij, ifreq, il1, il2            ! local integers
131      INTEGER  ::   iresti, irestj, ijm1, imil, inum   !   -      -
132      REAL(wp) ::   zidom, zjdom                       ! local scalars
133      INTEGER, DIMENSION(jpni,jpnj) ::   iimppt, ijmppt, ilcit, ilcjt   ! local workspace
134      !!----------------------------------------------------------------------
135
136      IF(lwp) WRITE(numout,*)
137      IF(lwp) WRITE(numout,*) 'mpp_init : Message Passing MPI'
138      IF(lwp) WRITE(numout,*) '~~~~~~~~'
139
140
141      !  1. Dimension arrays for subdomains
142      ! -----------------------------------
143      !  Computation of local domain sizes ilcit() ilcjt()
144      !  These dimensions depend on global sizes jpni,jpnj and jpiglo,jpjglo
145      !  The subdomains are squares leeser than or equal to the global
146      !  dimensions divided by the number of processors minus the overlap
147      !  array (cf. par_oce.F90).
148     
149      nreci  = 2 * jpreci
150      nrecj  = 2 * jprecj
151      iresti = MOD( jpiglo - nreci , jpni )
152      irestj = MOD( jpjglo - nrecj , jpnj )
153
154      IF(  iresti == 0 )   iresti = jpni
155
156#if defined key_nemocice_decomp
157      ! In order to match CICE the size of domains in NEMO has to be changed
158      ! The last line of blocks (west) will have fewer points
159
160      DO jj = 1, jpnj
161         DO ji=1, jpni-1
162            ilcit(ji,jj) = jpi
163         END DO
164         ilcit(jpni,jj) = jpiglo - (jpni - 1) * (jpi - nreci)
165      END DO
166
167#else
168
169      DO jj = 1, jpnj
170         DO ji = 1, iresti
171            ilcit(ji,jj) = jpi
172         END DO
173         DO ji = iresti+1, jpni
174            ilcit(ji,jj) = jpi -1
175         END DO
176      END DO
177     
178#endif
179      nfilcit(:,:) = ilcit(:,:)
180      IF( irestj == 0 )   irestj = jpnj
181
182#if defined key_nemocice_decomp
183      ! Same change to domains in North-South direction as in East-West.
184      DO ji=1,jpni
185         DO jj=1,jpnj-1
186            ilcjt(ji,jj) = jpj
187         END DO
188         ilcjt(ji,jpnj) = jpjglo - (jpnj - 1) * (jpj - nrecj)
189      END DO
190
191#else
192
193      DO ji = 1, jpni
194         DO jj = 1, irestj
195            ilcjt(ji,jj) = jpj
196         END DO
197         DO jj = irestj+1, jpnj
198            ilcjt(ji,jj) = jpj -1
199         END DO
200      END DO
201     
202#endif
203
204      !  2. Index arrays for subdomains
205      ! -------------------------------
206     
207      iimppt(:,:) = 1
208      ijmppt(:,:) = 1
209     
210      IF( jpni > 1 ) THEN
211         DO jj = 1, jpnj
212            DO ji = 2, jpni
213               iimppt(ji,jj) = iimppt(ji-1,jj) + ilcit(ji-1,jj) - nreci
214            END DO
215         END DO
216      ENDIF
217      nfiimpp(:,:)=iimppt(:,:)
218
219      IF( jpnj > 1 ) THEN
220         DO jj = 2, jpnj
221            DO ji = 1, jpni
222               ijmppt(ji,jj) = ijmppt(ji,jj-1)+ilcjt(ji,jj-1)-nrecj
223            END DO
224         END DO
225      ENDIF
226     
227      ! 3. Subdomain description
228      ! ------------------------
229
230      DO jn = 1, jpnij
231         ii = 1 + MOD( jn-1, jpni )
232         ij = 1 + (jn-1) / jpni
233         nfipproc(ii,ij) = jn - 1
234         nimppt(jn) = iimppt(ii,ij)
235         IF( ii==1 )THEN  ; nimpptea(jn) = -1
236         ELSE             ; nimpptea(jn) = iimppt(ii-1,ij)
237         ENDIF
238         njmppt(jn) = ijmppt(ii,ij)
239         IF( ij==jpnj )THEN  ; njmpptno(jn) = -1
240         ELSE                ; njmpptno(jn) = ijmppt(ii,ij+1)
241         ENDIF
242         nlcit (jn) = ilcit (ii,ij)     
243         IF( ii .GT. 1 )THEN ; nlcitea(jn) = ilcit(ii-1,ij)
244         ELSE                ; nlcitea(jn) = -1
245         ENDIF
246         nlci       = nlcit (jn)     
247         nlcjt (jn) = ilcjt (ii,ij)     
248         nlcj       = nlcjt (jn)
249         nbondj = -1                                   ! general case
250         IF( jn   >  jpni          )   nbondj = 0      ! first row of processor
251         IF( jn   >  (jpnj-1)*jpni )   nbondj = 1      ! last  row of processor
252         IF( jpnj == 1             )   nbondj = 2      ! one processor only in j-direction
253         ibonjt(jn) = nbondj
254         
255         nbondi = 0                                    !
256         IF( MOD( jn, jpni ) == 1 )   nbondi = -1      !
257         IF( MOD( jn, jpni ) == 0 )   nbondi =  1      !
258         IF( jpni            == 1 )   nbondi =  2      ! one processor only in i-direction
259         ibonit(jn) = nbondi
260 
261         nldi =  1   + jpreci
262         nlei = nlci - jpreci
263         IF( nbondi == -1 .OR. nbondi == 2 )   nldi = 1
264         IF( nbondi ==  1 .OR. nbondi == 2 )   nlei = nlci
265         nldj =  1   + jprecj
266         nlej = nlcj - jprecj
267         IF( nbondj == -1 .OR. nbondj == 2 )   nldj = 1
268         IF( nbondj ==  1 .OR. nbondj == 2 )   nlej = nlcj
269         nldit(jn) = nldi
270         nleit(jn) = nlei
271         nldjt(jn) = nldj
272         nlejt(jn) = nlej
273      END DO
274
275      ! 4. Subdomain print
276      ! ------------------
277     
278      IF(lwp) WRITE(numout,*)
279      IF(lwp) WRITE(numout,*) ' mpp_init: defines mpp subdomains'
280      IF(lwp) WRITE(numout,*) ' ~~~~~~  ----------------------'
281      IF(lwp) WRITE(numout,*)
282      IF(lwp) WRITE(numout,*) 'iresti=',iresti,' irestj=',irestj
283      IF(lwp) WRITE(numout,*)
284      IF(lwp) WRITE(numout,*) 'jpni=',jpni,' jpnj=',jpnj
285      zidom = nreci
286      DO ji = 1, jpni
287         zidom = zidom + ilcit(ji,1) - nreci
288      END DO
289      IF(lwp) WRITE(numout,*)
290      IF(lwp) WRITE(numout,*)' sum ilcit(i,1)=', zidom, ' jpiglo=', jpiglo
291
292      zjdom = nrecj
293      DO jj = 1, jpnj
294         zjdom = zjdom + ilcjt(1,jj) - nrecj
295      END DO
296      IF(lwp) WRITE(numout,*)' sum ilcit(1,j)=', zjdom, ' jpjglo=', jpjglo
297      IF(lwp) WRITE(numout,*)
298
299      IF(lwp) THEN
300         ifreq = 4
301         il1   = 1
302         DO jn = 1, (jpni-1)/ifreq+1
303            il2 = MIN( jpni, il1+ifreq-1 )
304            WRITE(numout,*)
305            WRITE(numout,9200) ('***',ji = il1,il2-1)
306            DO jj = jpnj, 1, -1
307               WRITE(numout,9203) ('   ',ji = il1,il2-1)
308               WRITE(numout,9202) jj, ( ilcit(ji,jj),ilcjt(ji,jj),ji = il1,il2 )
309               WRITE(numout,9204) (nfipproc(ji,jj),ji=il1,il2)
310               WRITE(numout,9203) ('   ',ji = il1,il2-1)
311               WRITE(numout,9200) ('***',ji = il1,il2-1)
312            END DO
313            WRITE(numout,9201) (ji,ji = il1,il2)
314            il1 = il1+ifreq
315         END DO
316 9200     FORMAT('     ***',20('*************',a3))
317 9203     FORMAT('     *     ',20('         *   ',a3))
318 9201     FORMAT('        ',20('   ',i3,'          '))
319 9202     FORMAT(' ',i3,' *  ',20(i3,'  x',i3,'   *   '))
320 9204     FORMAT('     *  ',20('      ',i3,'   *   '))
321      ENDIF
322
323      ! 5. From global to local
324      ! -----------------------
325
326      nperio = 0
327      IF( jperio == 2 .AND. nbondj == -1 )   nperio = 2
328
329
330      ! 6. Subdomain neighbours
331      ! ----------------------
332
333      nproc = narea - 1
334      noso  = nproc - jpni
335      nowe  = nproc - 1
336      noea  = nproc + 1
337      nono  = nproc + jpni
338      ! great neighbours
339      npnw = nono - 1
340      npne = nono + 1
341      npsw = noso - 1
342      npse = noso + 1
343      nbsw = 1
344      nbnw = 1
345      IF( MOD( nproc, jpni ) == 0 ) THEN
346         nbsw = 0
347         nbnw = 0
348      ENDIF
349      nbse = 1
350      nbne = 1
351      IF( MOD( nproc, jpni ) == jpni-1 ) THEN
352         nbse = 0
353         nbne = 0
354      ENDIF
355      IF(nproc < jpni) THEN
356         nbsw = 0
357         nbse = 0
358      ENDIF
359      IF( nproc >= (jpnj-1)*jpni ) THEN
360         nbnw = 0
361         nbne = 0
362      ENDIF
363      nlcj = nlcjt(narea) 
364      nlci = nlcit(narea) 
365      nldi = nldit(narea)
366      nlei = nleit(narea)
367      nldj = nldjt(narea)
368      nlej = nlejt(narea)
369      nbondi = ibonit(narea)
370      nbondj = ibonjt(narea)
371      nimpp  = nimppt(narea) 
372      njmpp  = njmppt(narea) 
373
374     ! Save processor layout in layout.dat file
375       IF (lwp) THEN
376        CALL ctl_opn( inum, 'layout.dat', 'REPLACE', 'FORMATTED', 'SEQUENTIAL', -1, numout, .FALSE., narea )
377        WRITE(inum,'(a)') '   jpnij     jpi     jpj     jpk  jpiglo  jpjglo'
378        WRITE(inum,'(6i8)') jpnij,jpi,jpj,jpk,jpiglo,jpjglo
379        WRITE(inum,'(a)') 'NAREA nlci nlcj nldi nldj nlei nlej nimpp njmpp'
380
381        DO  jn = 1, jpnij
382         WRITE(inum,'(9i5)') jn, nlcit(jn), nlcjt(jn), &
383                                      nldit(jn), nldjt(jn), &
384                                      nleit(jn), nlejt(jn), &
385                                      nimppt(jn), njmppt(jn)
386        END DO
387        CLOSE(inum)   
388      END IF
389
390
391      ! w a r n i n g  narea (zone) /= nproc (processors)!
392
393      IF( jperio == 1 .OR. jperio == 4 .OR. jperio == 6 ) THEN
394         IF( jpni == 1 )THEN
395            nbondi = 2
396            nperio = 1
397         ELSE
398            nbondi = 0
399         ENDIF
400         IF( MOD( narea, jpni ) == 0 ) THEN
401            noea = nproc-(jpni-1)
402            npne = npne-jpni
403            npse = npse-jpni
404         ENDIF
405         IF( MOD( narea, jpni ) == 1 ) THEN
406            nowe = nproc+(jpni-1)
407            npnw = npnw+jpni
408            npsw = npsw+jpni
409         ENDIF
410         nbsw = 1
411         nbnw = 1
412         nbse = 1
413         nbne = 1
414         IF( nproc < jpni ) THEN
415            nbsw = 0
416            nbse = 0
417         ENDIF
418         IF( nproc >= (jpnj-1)*jpni ) THEN
419            nbnw = 0
420            nbne = 0
421         ENDIF
422      ENDIF
423      npolj = 0
424      IF( jperio == 3 .OR. jperio == 4 ) THEN
425         ijm1 = jpni*(jpnj-1)
426         imil = ijm1+(jpni+1)/2
427         IF( narea > ijm1 ) npolj = 3
428         IF( MOD(jpni,2) == 1 .AND. narea == imil ) npolj = 4
429         IF( npolj == 3 ) nono = jpni*jpnj-narea+ijm1
430      ENDIF
431      IF( jperio == 5 .OR. jperio == 6 ) THEN
432          ijm1 = jpni*(jpnj-1)
433          imil = ijm1+(jpni+1)/2
434          IF( narea > ijm1) npolj = 5
435          IF( MOD(jpni,2) == 1 .AND. narea == imil ) npolj = 6
436          IF( npolj == 5 ) nono = jpni*jpnj-narea+ijm1
437      ENDIF
438
439      ! Periodicity : no corner if nbondi = 2 and nperio != 1
440
441      IF(lwp) THEN
442         WRITE(numout,*) ' nproc  = ', nproc
443         WRITE(numout,*) ' nowe   = ', nowe  , ' noea   =  ', noea
444         WRITE(numout,*) ' nono   = ', nono  , ' noso   =  ', noso
445         WRITE(numout,*) ' nbondi = ', nbondi
446         WRITE(numout,*) ' nbondj = ', nbondj
447         WRITE(numout,*) ' npolj  = ', npolj
448         WRITE(numout,*) ' nperio = ', nperio
449         WRITE(numout,*) ' nlci   = ', nlci
450         WRITE(numout,*) ' nlcj   = ', nlcj
451         WRITE(numout,*) ' nimpp  = ', nimpp
452         WRITE(numout,*) ' njmpp  = ', njmpp
453         WRITE(numout,*) ' nreci  = ', nreci  , ' npse   = ', npse
454         WRITE(numout,*) ' nrecj  = ', nrecj  , ' npsw   = ', npsw
455         WRITE(numout,*) ' jpreci = ', jpreci , ' npne   = ', npne
456         WRITE(numout,*) ' jprecj = ', jprecj , ' npnw   = ', npnw
457         WRITE(numout,*)
458      ENDIF
459
460      IF( nperio == 1 .AND. jpni /= 1 ) CALL ctl_stop( ' mpp_init: error on cyclicity' )
461
462      ! Prepare mpp north fold
463
464      IF( jperio >= 3 .AND. jperio <= 6 .AND. jpni > 1 ) THEN
465         CALL mpp_ini_north
466         IF(lwp) WRITE(numout,*) ' mpp_init : North fold boundary prepared for jpni >1'
467      ENDIF
468
469      ! Prepare NetCDF output file (if necessary)
470      CALL mpp_init_ioipsl
471
472   END SUBROUTINE mpp_init
473
474#  include "mppini_2.h90"
475
476# if defined key_dimgout
477   !!----------------------------------------------------------------------
478   !!   'key_dimgout'                  NO use of NetCDF files
479   !!----------------------------------------------------------------------
480   SUBROUTINE mpp_init_ioipsl       ! Dummy routine
481   END SUBROUTINE mpp_init_ioipsl 
482# else
483   SUBROUTINE mpp_init_ioipsl
484      !!----------------------------------------------------------------------
485      !!                  ***  ROUTINE mpp_init_ioipsl  ***
486      !!
487      !! ** Purpose :   
488      !!
489      !! ** Method  :   
490      !!
491      !! History :
492      !!   9.0  !  04-03  (G. Madec )  MPP-IOIPSL
493      !!   " "  !  08-12  (A. Coward)  addition in case of jpni*jpnj < jpnij
494      !!----------------------------------------------------------------------
495      INTEGER, DIMENSION(2) ::   iglo, iloc, iabsf, iabsl, ihals, ihale, idid
496      !!----------------------------------------------------------------------
497
498      ! The domain is split only horizontally along i- or/and j- direction
499      ! So we need at the most only 1D arrays with 2 elements.
500      ! Set idompar values equivalent to the jpdom_local_noextra definition
501      ! used in IOM. This works even if jpnij .ne. jpni*jpnj.
502      iglo(1) = jpiglo
503      iglo(2) = jpjglo
504      iloc(1) = nlci
505      iloc(2) = nlcj
506      iabsf(1) = nimppt(narea)
507      iabsf(2) = njmppt(narea)
508      iabsl(:) = iabsf(:) + iloc(:) - 1
509      ihals(1) = nldi - 1
510      ihals(2) = nldj - 1
511      ihale(1) = nlci - nlei
512      ihale(2) = nlcj - nlej
513      idid(1) = 1
514      idid(2) = 2
515
516      IF(lwp) THEN
517          WRITE(numout,*)
518          WRITE(numout,*) 'mpp_init_ioipsl :   iloc  = ', iloc (1), iloc (2)
519          WRITE(numout,*) '~~~~~~~~~~~~~~~     iabsf = ', iabsf(1), iabsf(2)
520          WRITE(numout,*) '                    ihals = ', ihals(1), ihals(2)
521          WRITE(numout,*) '                    ihale = ', ihale(1), ihale(2)
522      ENDIF
523      !
524      CALL flio_dom_set ( jpnij, nproc, idid, iglo, iloc, iabsf, iabsl, ihals, ihale, 'BOX', nidom)
525      !
526   END SUBROUTINE mpp_init_ioipsl 
527
528# endif
529#endif
530
531   !!======================================================================
532END MODULE mppini
Note: See TracBrowser for help on using the repository browser.