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.
lib_mpp.F90 in branches/2015/nemo_v3_6_STABLE/NEMOGCM/NEMO/OPA_SRC/LBC – NEMO

source: branches/2015/nemo_v3_6_STABLE/NEMOGCM/NEMO/OPA_SRC/LBC/lib_mpp.F90 @ 7531

Last change on this file since 7531 was 7531, checked in by timgraham, 7 years ago

Trivial fix for #1820

  • Property svn:keywords set to Id
File size: 173.0 KB
RevLine 
[3]1MODULE lib_mpp
[13]2   !!======================================================================
3   !!                       ***  MODULE  lib_mpp  ***
[1344]4   !! Ocean numerics:  massively parallel processing library
[13]5   !!=====================================================================
[1344]6   !! History :  OPA  !  1994  (M. Guyon, J. Escobar, M. Imbard)  Original code
7   !!            7.0  !  1997  (A.M. Treguier)  SHMEM additions
8   !!            8.0  !  1998  (M. Imbard, J. Escobar, L. Colombet ) SHMEM and MPI
9   !!                 !  1998  (J.M. Molines) Open boundary conditions
10   !!   NEMO     1.0  !  2003  (J.-M. Molines, G. Madec)  F90, free form
11   !!                 !  2003  (J.M. Molines) add mpp_ini_north(_3d,_2d)
12   !!             -   !  2004  (R. Bourdalle Badie)  isend option in mpi
13   !!                 !  2004  (J.M. Molines) minloc, maxloc
14   !!             -   !  2005  (G. Madec, S. Masson)  npolj=5,6 F-point & ice cases
15   !!             -   !  2005  (R. Redler) Replacement of MPI_COMM_WORLD except for MPI_Abort
16   !!             -   !  2005  (R. Benshila, G. Madec)  add extra halo case
17   !!             -   !  2008  (R. Benshila) add mpp_ini_ice
18   !!            3.2  !  2009  (R. Benshila) SHMEM suppression, north fold in lbc_nfd
[3764]19   !!            3.2  !  2009  (O. Marti)    add mpp_ini_znl
[2715]20   !!            4.0  !  2011  (G. Madec)  move ctl_ routines from in_out_manager
[3680]21   !!            3.5  !  2012  (S.Mocavero, I. Epicoco) Add 'mpp_lnk_bdy_3d', 'mpp_lnk_obc_3d',
22   !!                          'mpp_lnk_bdy_2d' and 'mpp_lnk_obc_2d' routines and update
23   !!                          the mppobc routine to optimize the BDY and OBC communications
[4230]24   !!            3.5  !  2013  ( C. Ethe, G. Madec ) message passing arrays as local variables
25   !!            3.5  !  2013 (S.Mocavero, I.Epicoco - CMCC) north fold optimizations
[6476]26   !!            3.6  !  2015 (O. Tintó and M. Castrillo - BSC) Added 'mpp_lnk_2d_multiple', 'mpp_lbc_north_2d_multiple', 'mpp_max_multiple'
[13]27   !!----------------------------------------------------------------------
[2715]28
29   !!----------------------------------------------------------------------
30   !!   ctl_stop   : update momentum and tracer Kz from a tke scheme
31   !!   ctl_warn   : initialization, namelist read, and parameters control
32   !!   ctl_opn    : Open file and check if required file is available.
[4147]33   !!   ctl_nam    : Prints informations when an error occurs while reading a namelist
34   !!   get_unit   : give the index of an unused logical unit
[2715]35   !!----------------------------------------------------------------------
[3764]36#if   defined key_mpp_mpi
[13]37   !!----------------------------------------------------------------------
[1344]38   !!   'key_mpp_mpi'             MPI massively parallel processing library
39   !!----------------------------------------------------------------------
[2715]40   !!   lib_mpp_alloc : allocate mpp arrays
41   !!   mynode        : indentify the processor unit
42   !!   mpp_lnk       : interface (defined in lbclnk) for message passing of 2d or 3d arrays (mpp_lnk_2d, mpp_lnk_3d)
[473]43   !!   mpp_lnk_3d_gather :  Message passing manadgement for two 3D arrays
[2715]44   !!   mpp_lnk_e     : interface (defined in lbclnk) for message passing of 2d array with extra halo (mpp_lnk_2d_e)
[4990]45   !!   mpp_lnk_icb   : interface for message passing of 2d arrays with extra halo for icebergs (mpp_lnk_2d_icb)
[2715]46   !!   mpprecv         :
47   !!   mppsend       :   SUBROUTINE mpp_ini_znl
48   !!   mppscatter    :
49   !!   mppgather     :
50   !!   mpp_min       : generic interface for mppmin_int , mppmin_a_int , mppmin_real, mppmin_a_real
51   !!   mpp_max       : generic interface for mppmax_int , mppmax_a_int , mppmax_real, mppmax_a_real
52   !!   mpp_sum       : generic interface for mppsum_int , mppsum_a_int , mppsum_real, mppsum_a_real
53   !!   mpp_minloc    :
54   !!   mpp_maxloc    :
55   !!   mppsync       :
56   !!   mppstop       :
[1344]57   !!   mpp_ini_north : initialisation of north fold
58   !!   mpp_lbc_north : north fold processors gathering
59   !!   mpp_lbc_north_e : variant of mpp_lbc_north for extra outer halo
[4990]60   !!   mpp_lbc_north_icb : variant of mpp_lbc_north for extra outer halo with icebergs
[13]61   !!----------------------------------------------------------------------
[3764]62   USE dom_oce        ! ocean space and time domain
[2715]63   USE lbcnfd         ! north fold treatment
64   USE in_out_manager ! I/O manager
[6476]65   USE wrk_nemo       ! work arrays
[3]66
[13]67   IMPLICIT NONE
[415]68   PRIVATE
[4147]69   
70   PUBLIC   ctl_stop, ctl_warn, get_unit, ctl_opn, ctl_nam
[1344]71   PUBLIC   mynode, mppstop, mppsync, mpp_comm_free
72   PUBLIC   mpp_ini_north, mpp_lbc_north, mpp_lbc_north_e
73   PUBLIC   mpp_min, mpp_max, mpp_sum, mpp_minloc, mpp_maxloc
[6476]74   PUBLIC   mpp_max_multiple
[1344]75   PUBLIC   mpp_lnk_3d, mpp_lnk_3d_gather, mpp_lnk_2d, mpp_lnk_2d_e
[6476]76   PUBLIC   mpp_lnk_2d_9 , mpp_lnk_2d_multiple 
[3294]77   PUBLIC   mppscatter, mppgather
[4328]78   PUBLIC   mpp_ini_ice, mpp_ini_znl
[2715]79   PUBLIC   mppsize
[3764]80   PUBLIC   mppsend, mpprecv                          ! needed by TAM and ICB routines
[3680]81   PUBLIC   mpp_lnk_bdy_2d, mpp_lnk_bdy_3d
[4990]82   PUBLIC   mpp_lbc_north_icb, mpp_lnk_2d_icb
[6476]83   PUBLIC   mpprank
[415]84
[5429]85   TYPE arrayptr
86      REAL , DIMENSION (:,:),  POINTER :: pt2d
87   END TYPE arrayptr
[6476]88   PUBLIC   arrayptr
[5429]89   
[13]90   !! * Interfaces
91   !! define generic interface for these routine as they are called sometimes
[1344]92   !! with scalar arguments instead of array arguments, which causes problems
93   !! for the compilation on AIX system as well as NEC and SGI. Ok on COMPACQ
[13]94   INTERFACE mpp_min
95      MODULE PROCEDURE mppmin_a_int, mppmin_int, mppmin_a_real, mppmin_real
96   END INTERFACE
97   INTERFACE mpp_max
[681]98      MODULE PROCEDURE mppmax_a_int, mppmax_int, mppmax_a_real, mppmax_real
[13]99   END INTERFACE
100   INTERFACE mpp_sum
[1976]101      MODULE PROCEDURE mppsum_a_int, mppsum_int, mppsum_a_real, mppsum_real, &
102                       mppsum_realdd, mppsum_a_realdd
[13]103   END INTERFACE
104   INTERFACE mpp_lbc_north
[3764]105      MODULE PROCEDURE mpp_lbc_north_3d, mpp_lbc_north_2d
[13]106   END INTERFACE
[1344]107   INTERFACE mpp_minloc
108      MODULE PROCEDURE mpp_minloc2d ,mpp_minloc3d
109   END INTERFACE
110   INTERFACE mpp_maxloc
111      MODULE PROCEDURE mpp_maxloc2d ,mpp_maxloc3d
112   END INTERFACE
[3764]113
[6476]114   INTERFACE mpp_max_multiple
115      MODULE PROCEDURE mppmax_real_multiple
116   END INTERFACE
117
[51]118   !! ========================= !!
119   !!  MPI  variable definition !!
120   !! ========================= !!
[1629]121!$AGRIF_DO_NOT_TREAT
[2004]122   INCLUDE 'mpif.h'
[1629]123!$AGRIF_END_DO_NOT_TREAT
[3764]124
[1344]125   LOGICAL, PUBLIC, PARAMETER ::   lk_mpp = .TRUE.    !: mpp flag
[3]126
[1344]127   INTEGER, PARAMETER         ::   nprocmax = 2**10   ! maximun dimension (required to be a power of 2)
[3764]128
[1344]129   INTEGER ::   mppsize        ! number of process
130   INTEGER ::   mpprank        ! process number  [ 0 - size-1 ]
[2363]131!$AGRIF_DO_NOT_TREAT
[2249]132   INTEGER, PUBLIC ::   mpi_comm_opa   ! opa local communicator
[2363]133!$AGRIF_END_DO_NOT_TREAT
[3]134
[2480]135   INTEGER :: MPI_SUMDD
[1976]136
[869]137   ! variables used in case of sea-ice
[3625]138   INTEGER, PUBLIC ::   ncomm_ice       !: communicator made by the processors with sea-ice (public so that it can be freed in limthd)
139   INTEGER ::   ngrp_iworld     !  group ID for the world processors (for rheology)
[1345]140   INTEGER ::   ngrp_ice        !  group ID for the ice processors (for rheology)
141   INTEGER ::   ndim_rank_ice   !  number of 'ice' processors
142   INTEGER ::   n_ice_root      !  number (in the comm_ice) of proc 0 in the ice comm
[2715]143   INTEGER, DIMENSION(:), ALLOCATABLE, SAVE ::   nrank_ice     ! dimension ndim_rank_ice
[1345]144
145   ! variables used for zonal integration
146   INTEGER, PUBLIC ::   ncomm_znl       !: communicator made by the processors on the same zonal average
147   LOGICAL, PUBLIC ::   l_znl_root      ! True on the 'left'most processor on the same row
148   INTEGER ::   ngrp_znl        ! group ID for the znl processors
149   INTEGER ::   ndim_rank_znl   ! number of processors on the same zonal average
[2715]150   INTEGER, DIMENSION(:), ALLOCATABLE, SAVE ::   nrank_znl  ! dimension ndim_rank_znl, number of the procs into the same znl domain
[3]151
[3764]152   ! North fold condition in mpp_mpi with jpni > 1 (PUBLIC for TAM)
153   INTEGER, PUBLIC ::   ngrp_world        ! group ID for the world processors
154   INTEGER, PUBLIC ::   ngrp_opa          ! group ID for the opa processors
155   INTEGER, PUBLIC ::   ngrp_north        ! group ID for the northern processors (to be fold)
156   INTEGER, PUBLIC ::   ncomm_north       ! communicator made by the processors belonging to ngrp_north
157   INTEGER, PUBLIC ::   ndim_rank_north   ! number of 'sea' processor in the northern line (can be /= jpni !)
158   INTEGER, PUBLIC ::   njmppmax          ! value of njmpp for the processors of the northern line
159   INTEGER, PUBLIC ::   north_root        ! number (in the comm_opa) of proc 0 in the northern comm
160   INTEGER, DIMENSION(:), ALLOCATABLE, SAVE, PUBLIC ::   nrank_north   ! dimension ndim_rank_north
161
[1344]162   ! Type of send : standard, buffered, immediate
[4147]163   CHARACTER(len=1), PUBLIC ::   cn_mpi_send   ! type od mpi send/recieve (S=standard, B=bsend, I=isend)
[3764]164   LOGICAL, PUBLIC          ::   l_isend = .FALSE.   ! isend use indicator (T if cn_mpi_send='I')
[4147]165   INTEGER, PUBLIC          ::   nn_buffer     ! size of the buffer in case of mpi_bsend
[3764]166
[2715]167   REAL(wp), DIMENSION(:), ALLOCATABLE, SAVE :: tampon  ! buffer in case of bsend
[3]168
[4230]169   LOGICAL, PUBLIC                                  ::   ln_nnogather       ! namelist control of northfold comms
[3294]170   LOGICAL, PUBLIC                                  ::   l_north_nogather = .FALSE.  ! internal control of northfold comms
171   INTEGER, PUBLIC                                  ::   ityp
[51]172   !!----------------------------------------------------------------------
[2287]173   !! NEMO/OPA 3.3 , NEMO Consortium (2010)
[888]174   !! $Id$
[2715]175   !! Software governed by the CeCILL licence     (NEMOGCM/NEMO_CeCILL.txt)
[1344]176   !!----------------------------------------------------------------------
[3]177CONTAINS
178
[2715]179
[5407]180   FUNCTION mynode( ldtxt, ldname, kumnam_ref , kumnam_cfg , kumond , kstop, localComm )
[2715]181      !!----------------------------------------------------------------------
[51]182      !!                  ***  routine mynode  ***
[3764]183      !!
[51]184      !! ** Purpose :   Find processor unit
185      !!----------------------------------------------------------------------
[3764]186      CHARACTER(len=*),DIMENSION(:), INTENT(  out) ::   ldtxt
[5407]187      CHARACTER(len=*)             , INTENT(in   ) ::   ldname
[4147]188      INTEGER                      , INTENT(in   ) ::   kumnam_ref     ! logical unit for reference namelist
189      INTEGER                      , INTENT(in   ) ::   kumnam_cfg     ! logical unit for configuration namelist
[4624]190      INTEGER                      , INTENT(inout) ::   kumond         ! logical unit for namelist output
[4147]191      INTEGER                      , INTENT(inout) ::   kstop          ! stop indicator
[1579]192      INTEGER, OPTIONAL            , INTENT(in   ) ::   localComm
[2715]193      !
[4147]194      INTEGER ::   mynode, ierr, code, ji, ii, ios
[532]195      LOGICAL ::   mpi_was_called
[2715]196      !
[3294]197      NAMELIST/nammpp/ cn_mpi_send, nn_buffer, jpni, jpnj, jpnij, ln_nnogather
[51]198      !!----------------------------------------------------------------------
[1344]199      !
[2481]200      ii = 1
201      WRITE(ldtxt(ii),*)                                                                          ;   ii = ii + 1
202      WRITE(ldtxt(ii),*) 'mynode : mpi initialisation'                                            ;   ii = ii + 1
203      WRITE(ldtxt(ii),*) '~~~~~~ '                                                                ;   ii = ii + 1
[1344]204      !
[4147]205
206      REWIND( kumnam_ref )              ! Namelist nammpp in reference namelist: mpi variables
207      READ  ( kumnam_ref, nammpp, IOSTAT = ios, ERR = 901)
208901   IF( ios /= 0 ) CALL ctl_nam ( ios , 'nammpp in reference namelist', lwp )
209
210      REWIND( kumnam_cfg )              ! Namelist nammpp in configuration namelist: mpi variables
211      READ  ( kumnam_cfg, nammpp, IOSTAT = ios, ERR = 902 )
212902   IF( ios /= 0 ) CALL ctl_nam ( ios , 'nammpp in configuration namelist', lwp )
213
[1344]214      !                              ! control print
[2481]215      WRITE(ldtxt(ii),*) '   Namelist nammpp'                                                     ;   ii = ii + 1
216      WRITE(ldtxt(ii),*) '      mpi send type                      cn_mpi_send = ', cn_mpi_send   ;   ii = ii + 1
217      WRITE(ldtxt(ii),*) '      size in bytes of exported buffer   nn_buffer   = ', nn_buffer     ;   ii = ii + 1
[300]218
[2731]219#if defined key_agrif
220      IF( .NOT. Agrif_Root() ) THEN
[3764]221         jpni  = Agrif_Parent(jpni )
[2731]222         jpnj  = Agrif_Parent(jpnj )
223         jpnij = Agrif_Parent(jpnij)
224      ENDIF
225#endif
226
[2715]227      IF(jpnij < 1)THEN
228         ! If jpnij is not specified in namelist then we calculate it - this
229         ! means there will be no land cutting out.
230         jpnij = jpni * jpnj
231      END IF
232
233      IF( (jpni < 1) .OR. (jpnj < 1) )THEN
234         WRITE(ldtxt(ii),*) '      jpni, jpnj and jpnij will be calculated automatically'; ii = ii + 1
235      ELSE
236         WRITE(ldtxt(ii),*) '      processor grid extent in i         jpni = ',jpni; ii = ii + 1
237         WRITE(ldtxt(ii),*) '      processor grid extent in j         jpnj = ',jpnj; ii = ii + 1
238         WRITE(ldtxt(ii),*) '      number of local domains           jpnij = ',jpnij; ii = ii +1
239      END IF
240
[3294]241      WRITE(ldtxt(ii),*) '      avoid use of mpi_allgather at the north fold  ln_nnogather = ', ln_nnogather  ; ii = ii + 1
242
[2480]243      CALL mpi_initialized ( mpi_was_called, code )
244      IF( code /= MPI_SUCCESS ) THEN
[3764]245         DO ji = 1, SIZE(ldtxt)
[2481]246            IF( TRIM(ldtxt(ji)) /= '' )   WRITE(*,*) ldtxt(ji)      ! control print of mynode
[3764]247         END DO
[2480]248         WRITE(*, cform_err)
249         WRITE(*, *) 'lib_mpp: Error in routine mpi_initialized'
250         CALL mpi_abort( mpi_comm_world, code, ierr )
251      ENDIF
[415]252
[2480]253      IF( mpi_was_called ) THEN
254         !
255         SELECT CASE ( cn_mpi_send )
256         CASE ( 'S' )                ! Standard mpi send (blocking)
[2481]257            WRITE(ldtxt(ii),*) '           Standard blocking mpi send (send)'                     ;   ii = ii + 1
[2480]258         CASE ( 'B' )                ! Buffer mpi send (blocking)
[2481]259            WRITE(ldtxt(ii),*) '           Buffer blocking mpi send (bsend)'                      ;   ii = ii + 1
[3764]260            IF( Agrif_Root() )   CALL mpi_init_opa( ldtxt, ii, ierr )
[2480]261         CASE ( 'I' )                ! Immediate mpi send (non-blocking send)
[2481]262            WRITE(ldtxt(ii),*) '           Immediate non-blocking send (isend)'                   ;   ii = ii + 1
[2480]263            l_isend = .TRUE.
264         CASE DEFAULT
[2481]265            WRITE(ldtxt(ii),cform_err)                                                            ;   ii = ii + 1
266            WRITE(ldtxt(ii),*) '           bad value for cn_mpi_send = ', cn_mpi_send             ;   ii = ii + 1
[2715]267            kstop = kstop + 1
[2480]268         END SELECT
269      ELSE IF ( PRESENT(localComm) .and. .not. mpi_was_called ) THEN
[2481]270         WRITE(ldtxt(ii),*) ' lib_mpp: You cannot provide a local communicator '                  ;   ii = ii + 1
271         WRITE(ldtxt(ii),*) '          without calling MPI_Init before ! '                        ;   ii = ii + 1
[2715]272         kstop = kstop + 1
[532]273      ELSE
[1601]274         SELECT CASE ( cn_mpi_send )
[524]275         CASE ( 'S' )                ! Standard mpi send (blocking)
[2481]276            WRITE(ldtxt(ii),*) '           Standard blocking mpi send (send)'                     ;   ii = ii + 1
[2480]277            CALL mpi_init( ierr )
[524]278         CASE ( 'B' )                ! Buffer mpi send (blocking)
[2481]279            WRITE(ldtxt(ii),*) '           Buffer blocking mpi send (bsend)'                      ;   ii = ii + 1
280            IF( Agrif_Root() )   CALL mpi_init_opa( ldtxt, ii, ierr )
[524]281         CASE ( 'I' )                ! Immediate mpi send (non-blocking send)
[2481]282            WRITE(ldtxt(ii),*) '           Immediate non-blocking send (isend)'                   ;   ii = ii + 1
[524]283            l_isend = .TRUE.
[2480]284            CALL mpi_init( ierr )
[524]285         CASE DEFAULT
[2481]286            WRITE(ldtxt(ii),cform_err)                                                            ;   ii = ii + 1
287            WRITE(ldtxt(ii),*) '           bad value for cn_mpi_send = ', cn_mpi_send             ;   ii = ii + 1
[2715]288            kstop = kstop + 1
[524]289         END SELECT
[2480]290         !
[415]291      ENDIF
[570]292
[3764]293      IF( PRESENT(localComm) ) THEN
[2480]294         IF( Agrif_Root() ) THEN
295            mpi_comm_opa = localComm
296         ENDIF
297      ELSE
298         CALL mpi_comm_dup( mpi_comm_world, mpi_comm_opa, code)
299         IF( code /= MPI_SUCCESS ) THEN
[3764]300            DO ji = 1, SIZE(ldtxt)
[2481]301               IF( TRIM(ldtxt(ji)) /= '' )   WRITE(*,*) ldtxt(ji)      ! control print of mynode
302            END DO
[2480]303            WRITE(*, cform_err)
304            WRITE(*, *) ' lib_mpp: Error in routine mpi_comm_dup'
305            CALL mpi_abort( mpi_comm_world, code, ierr )
306         ENDIF
[3764]307      ENDIF
[2480]308
[6204]309#if defined key_agrif
310      IF (Agrif_Root()) THEN
311         CALL Agrif_MPI_Init(mpi_comm_opa)
312      ELSE
313         CALL Agrif_MPI_set_grid_comm(mpi_comm_opa)
314      ENDIF
315#endif
316
[1344]317      CALL mpi_comm_rank( mpi_comm_opa, mpprank, ierr )
318      CALL mpi_comm_size( mpi_comm_opa, mppsize, ierr )
[629]319      mynode = mpprank
[4624]320
321      IF( mynode == 0 ) THEN
[5407]322         CALL ctl_opn( kumond, TRIM(ldname), 'UNKNOWN', 'FORMATTED', 'SEQUENTIAL', -1, 6, .FALSE. , 1 )
323         WRITE(kumond, nammpp)     
[4624]324      ENDIF
[3764]325      !
[1976]326      CALL MPI_OP_CREATE(DDPDD_MPI, .TRUE., MPI_SUMDD, ierr)
327      !
[51]328   END FUNCTION mynode
[3]329
[888]330   SUBROUTINE mpp_lnk_3d( ptab, cd_type, psgn, cd_mpp, pval )
[51]331      !!----------------------------------------------------------------------
332      !!                  ***  routine mpp_lnk_3d  ***
333      !!
334      !! ** Purpose :   Message passing manadgement
335      !!
[3764]336      !! ** Method  :   Use mppsend and mpprecv function for passing mask
[51]337      !!      between processors following neighboring subdomains.
338      !!            domain parameters
339      !!                    nlci   : first dimension of the local subdomain
340      !!                    nlcj   : second dimension of the local subdomain
341      !!                    nbondi : mark for "east-west local boundary"
342      !!                    nbondj : mark for "north-south local boundary"
[3764]343      !!                    noea   : number for local neighboring processors
[51]344      !!                    nowe   : number for local neighboring processors
345      !!                    noso   : number for local neighboring processors
346      !!                    nono   : number for local neighboring processors
347      !!
348      !! ** Action  :   ptab with update value at its periphery
349      !!
350      !!----------------------------------------------------------------------
[1344]351      REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(inout) ::   ptab     ! 3D array on which the boundary condition is applied
352      CHARACTER(len=1)                , INTENT(in   ) ::   cd_type  ! define the nature of ptab array grid-points
353      !                                                             ! = T , U , V , F , W points
354      REAL(wp)                        , INTENT(in   ) ::   psgn     ! =-1 the sign change across the north fold boundary
355      !                                                             ! =  1. , the sign is kept
[3764]356      CHARACTER(len=3), OPTIONAL      , INTENT(in   ) ::   cd_mpp   ! fill the overlap area only
[1344]357      REAL(wp)        , OPTIONAL      , INTENT(in   ) ::   pval     ! background value (used at closed boundaries)
358      !!
[1718]359      INTEGER  ::   ji, jj, jk, jl             ! dummy loop indices
[1344]360      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
361      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
[888]362      REAL(wp) ::   zland
[1344]363      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
[4152]364      !
365      REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE ::   zt3ns, zt3sn   ! 3d for north-south & south-north
366      REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE ::   zt3ew, zt3we   ! 3d for east-west & west-east
367
[51]368      !!----------------------------------------------------------------------
[4152]369     
370      ALLOCATE( zt3ns(jpi,jprecj,jpk,2), zt3sn(jpi,jprecj,jpk,2),   &
371         &      zt3ew(jpj,jpreci,jpk,2), zt3we(jpj,jpreci,jpk,2)  )
[3]372
[4152]373      !
[1344]374      IF( PRESENT( pval ) ) THEN   ;   zland = pval      ! set land value
375      ELSE                         ;   zland = 0.e0      ! zero by default
376      ENDIF
377
[51]378      ! 1. standard boundary treatment
379      ! ------------------------------
[1718]380      IF( PRESENT( cd_mpp ) ) THEN      ! only fill added line/raw with existing values
[1344]381         !
[1718]382         ! WARNING ptab is defined only between nld and nle
383         DO jk = 1, jpk
384            DO jj = nlcj+1, jpj                 ! added line(s)   (inner only)
[3764]385               ptab(nldi  :nlei  , jj          ,jk) = ptab(nldi:nlei,     nlej,jk)
[1718]386               ptab(1     :nldi-1, jj          ,jk) = ptab(nldi     ,     nlej,jk)
387               ptab(nlei+1:nlci  , jj          ,jk) = ptab(     nlei,     nlej,jk)
388            END DO
389            DO ji = nlci+1, jpi                 ! added column(s) (full)
390               ptab(ji           ,nldj  :nlej  ,jk) = ptab(     nlei,nldj:nlej,jk)
391               ptab(ji           ,1     :nldj-1,jk) = ptab(     nlei,nldj     ,jk)
392               ptab(ji           ,nlej+1:jpj   ,jk) = ptab(     nlei,     nlej,jk)
393            END DO
[610]394         END DO
[1344]395         !
[3764]396      ELSE                              ! standard close or cyclic treatment
[1344]397         !
398         !                                   ! East-West boundaries
399         !                                        !* Cyclic east-west
400         IF( nbondi == 2 .AND. (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) ) THEN
[473]401            ptab( 1 ,:,:) = ptab(jpim1,:,:)
402            ptab(jpi,:,:) = ptab(  2  ,:,:)
[1344]403         ELSE                                     !* closed
404            IF( .NOT. cd_type == 'F' )   ptab(     1       :jpreci,:,:) = zland    ! south except F-point
405                                         ptab(nlci-jpreci+1:jpi   ,:,:) = zland    ! north
[473]406         ENDIF
[1344]407         !                                   ! North-South boundaries (always closed)
408         IF( .NOT. cd_type == 'F' )   ptab(:,     1       :jprecj,:) = zland       ! south except F-point
409                                      ptab(:,nlcj-jprecj+1:jpj   ,:) = zland       ! north
410         !
[51]411      ENDIF
[3]412
[51]413      ! 2. East and west directions exchange
414      ! ------------------------------------
[3764]415      ! we play with the neigbours AND the row number because of the periodicity
[1344]416      !
417      SELECT CASE ( nbondi )      ! Read Dirichlet lateral conditions
418      CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
[51]419         iihom = nlci-nreci
420         DO jl = 1, jpreci
[4152]421            zt3ew(:,jl,:,1) = ptab(jpreci+jl,:,:)
422            zt3we(:,jl,:,1) = ptab(iihom +jl,:,:)
[51]423         END DO
[3764]424      END SELECT
[1344]425      !
426      !                           ! Migrations
[51]427      imigr = jpreci * jpj * jpk
[1344]428      !
[3764]429      SELECT CASE ( nbondi )
[51]430      CASE ( -1 )
[4152]431         CALL mppsend( 2, zt3we(1,1,1,1), imigr, noea, ml_req1 )
432         CALL mpprecv( 1, zt3ew(1,1,1,2), imigr, noea )
[300]433         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
[51]434      CASE ( 0 )
[4152]435         CALL mppsend( 1, zt3ew(1,1,1,1), imigr, nowe, ml_req1 )
436         CALL mppsend( 2, zt3we(1,1,1,1), imigr, noea, ml_req2 )
437         CALL mpprecv( 1, zt3ew(1,1,1,2), imigr, noea )
438         CALL mpprecv( 2, zt3we(1,1,1,2), imigr, nowe )
[300]439         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
440         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
[51]441      CASE ( 1 )
[4152]442         CALL mppsend( 1, zt3ew(1,1,1,1), imigr, nowe, ml_req1 )
443         CALL mpprecv( 2, zt3we(1,1,1,2), imigr, nowe )
[300]444         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
[51]445      END SELECT
[1344]446      !
447      !                           ! Write Dirichlet lateral conditions
[51]448      iihom = nlci-jpreci
[1344]449      !
[51]450      SELECT CASE ( nbondi )
451      CASE ( -1 )
452         DO jl = 1, jpreci
[4152]453            ptab(iihom+jl,:,:) = zt3ew(:,jl,:,2)
[51]454         END DO
[3764]455      CASE ( 0 )
[51]456         DO jl = 1, jpreci
[4152]457            ptab(jl      ,:,:) = zt3we(:,jl,:,2)
458            ptab(iihom+jl,:,:) = zt3ew(:,jl,:,2)
[51]459         END DO
460      CASE ( 1 )
461         DO jl = 1, jpreci
[4152]462            ptab(jl      ,:,:) = zt3we(:,jl,:,2)
[51]463         END DO
464      END SELECT
[3]465
466
[51]467      ! 3. North and south directions
468      ! -----------------------------
[1344]469      ! always closed : we play only with the neigbours
470      !
471      IF( nbondj /= 2 ) THEN      ! Read Dirichlet lateral conditions
[51]472         ijhom = nlcj-nrecj
473         DO jl = 1, jprecj
[4152]474            zt3sn(:,jl,:,1) = ptab(:,ijhom +jl,:)
475            zt3ns(:,jl,:,1) = ptab(:,jprecj+jl,:)
[51]476         END DO
477      ENDIF
[1344]478      !
479      !                           ! Migrations
[51]480      imigr = jprecj * jpi * jpk
[1344]481      !
[3764]482      SELECT CASE ( nbondj )
[51]483      CASE ( -1 )
[4152]484         CALL mppsend( 4, zt3sn(1,1,1,1), imigr, nono, ml_req1 )
485         CALL mpprecv( 3, zt3ns(1,1,1,2), imigr, nono )
[300]486         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
[51]487      CASE ( 0 )
[4152]488         CALL mppsend( 3, zt3ns(1,1,1,1), imigr, noso, ml_req1 )
489         CALL mppsend( 4, zt3sn(1,1,1,1), imigr, nono, ml_req2 )
490         CALL mpprecv( 3, zt3ns(1,1,1,2), imigr, nono )
491         CALL mpprecv( 4, zt3sn(1,1,1,2), imigr, noso )
[300]492         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
493         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
[3764]494      CASE ( 1 )
[4152]495         CALL mppsend( 3, zt3ns(1,1,1,1), imigr, noso, ml_req1 )
496         CALL mpprecv( 4, zt3sn(1,1,1,2), imigr, noso )
[300]497         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
[51]498      END SELECT
[1344]499      !
500      !                           ! Write Dirichlet lateral conditions
[51]501      ijhom = nlcj-jprecj
[1344]502      !
[51]503      SELECT CASE ( nbondj )
504      CASE ( -1 )
505         DO jl = 1, jprecj
[4152]506            ptab(:,ijhom+jl,:) = zt3ns(:,jl,:,2)
[51]507         END DO
[3764]508      CASE ( 0 )
[51]509         DO jl = 1, jprecj
[4152]510            ptab(:,jl      ,:) = zt3sn(:,jl,:,2)
511            ptab(:,ijhom+jl,:) = zt3ns(:,jl,:,2)
[51]512         END DO
513      CASE ( 1 )
514         DO jl = 1, jprecj
[4152]515            ptab(:,jl,:) = zt3sn(:,jl,:,2)
[51]516         END DO
517      END SELECT
[3]518
519
[51]520      ! 4. north fold treatment
521      ! -----------------------
[1344]522      !
523      IF( npolj /= 0 .AND. .NOT. PRESENT(cd_mpp) ) THEN
524         !
525         SELECT CASE ( jpni )
526         CASE ( 1 )     ;   CALL lbc_nfd      ( ptab, cd_type, psgn )   ! only 1 northern proc, no mpp
527         CASE DEFAULT   ;   CALL mpp_lbc_north( ptab, cd_type, psgn )   ! for all northern procs.
528         END SELECT
529         !
[473]530      ENDIF
[1344]531      !
[4152]532      DEALLOCATE( zt3ns, zt3sn, zt3ew, zt3we )
533      !
[51]534   END SUBROUTINE mpp_lnk_3d
[3]535
[5429]536   SUBROUTINE mpp_lnk_2d_multiple( pt2d_array , type_array , psgn_array , num_fields , cd_mpp, pval )
537      !!----------------------------------------------------------------------
538      !!                  ***  routine mpp_lnk_2d_multiple  ***
539      !!
540      !! ** Purpose :   Message passing management for multiple 2d arrays
541      !!
542      !! ** Method  :   Use mppsend and mpprecv function for passing mask
543      !!      between processors following neighboring subdomains.
544      !!            domain parameters
545      !!                    nlci   : first dimension of the local subdomain
546      !!                    nlcj   : second dimension of the local subdomain
547      !!                    nbondi : mark for "east-west local boundary"
548      !!                    nbondj : mark for "north-south local boundary"
549      !!                    noea   : number for local neighboring processors
550      !!                    nowe   : number for local neighboring processors
551      !!                    noso   : number for local neighboring processors
552      !!                    nono   : number for local neighboring processors
553      !!
554      !!----------------------------------------------------------------------
[3]555
[5429]556      INTEGER :: num_fields
557      TYPE( arrayptr ), DIMENSION(:) :: pt2d_array
558      CHARACTER(len=1), DIMENSION(:), INTENT(in   ) ::   type_array   ! define the nature of ptab array grid-points
559      !                                                               ! = T , U , V , F , W and I points
560      REAL(wp)        , DIMENSION(:), INTENT(in   ) ::   psgn_array   ! =-1 the sign change across the north fold boundary
561      !                                                               ! =  1. , the sign is kept
562      CHARACTER(len=3), OPTIONAL    , INTENT(in   ) ::   cd_mpp       ! fill the overlap area only
563      REAL(wp)        , OPTIONAL    , INTENT(in   ) ::   pval         ! background value (used at closed boundaries)
564      !!
565      INTEGER  ::   ji, jj, jl   ! dummy loop indices
566      INTEGER  ::   ii    !!MULTI SEND DUMMY LOOP INDICES
567      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
568      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
569
570      REAL(wp) ::   zland
571      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
572      !
573      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  zt2ns, zt2sn   ! 2d for north-south & south-north
574      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  zt2ew, zt2we   ! 2d for east-west & west-east
575
576      !!----------------------------------------------------------------------
577
578      ALLOCATE( zt2ns(jpi,jprecj,2*num_fields), zt2sn(jpi,jprecj,2*num_fields),  &
579         &      zt2ew(jpj,jpreci,2*num_fields), zt2we(jpj,jpreci,2*num_fields)   )
580
581      !
582      IF( PRESENT( pval ) ) THEN   ;   zland = pval      ! set land value
583      ELSE                         ;   zland = 0.e0      ! zero by default
584      ENDIF
585
586      ! 1. standard boundary treatment
587      ! ------------------------------
588      !
589      !First Array
590      DO ii = 1 , num_fields
591         IF( PRESENT( cd_mpp ) ) THEN      ! only fill added line/raw with existing values
592            !
593            ! WARNING pt2d is defined only between nld and nle
594            DO jj = nlcj+1, jpj                 ! added line(s)   (inner only)
595               pt2d_array(ii)%pt2d(nldi  :nlei  , jj) = pt2d_array(ii)%pt2d(nldi:nlei, nlej)
596               pt2d_array(ii)%pt2d(1     :nldi-1, jj) = pt2d_array(ii)%pt2d(nldi     , nlej)
597               pt2d_array(ii)%pt2d(nlei+1:nlci  , jj) = pt2d_array(ii)%pt2d(     nlei, nlej) 
598            END DO
599            DO ji = nlci+1, jpi                 ! added column(s) (full)
600               pt2d_array(ii)%pt2d(ji, nldj  :nlej  ) = pt2d_array(ii)%pt2d(nlei, nldj:nlej)
601               pt2d_array(ii)%pt2d(ji, 1     :nldj-1) = pt2d_array(ii)%pt2d(nlei, nldj     )
602               pt2d_array(ii)%pt2d(ji, nlej+1:jpj   ) = pt2d_array(ii)%pt2d(nlei,      nlej)
603            END DO
604            !
605         ELSE                              ! standard close or cyclic treatment
606            !
607            !                                   ! East-West boundaries
608            IF( nbondi == 2 .AND.   &                ! Cyclic east-west
609               &    (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) ) THEN
610               pt2d_array(ii)%pt2d(  1  , : ) = pt2d_array(ii)%pt2d( jpim1, : )                                    ! west
611               pt2d_array(ii)%pt2d( jpi , : ) = pt2d_array(ii)%pt2d(   2  , : )                                    ! east
612            ELSE                                     ! closed
613               IF( .NOT. type_array(ii) == 'F' )   pt2d_array(ii)%pt2d(            1 : jpreci,:) = zland    ! south except F-point
614                                                   pt2d_array(ii)%pt2d(nlci-jpreci+1 : jpi   ,:) = zland    ! north
615            ENDIF
616            !                                   ! North-South boundaries (always closed)
617               IF( .NOT. type_array(ii) == 'F' )   pt2d_array(ii)%pt2d(:,             1:jprecj ) = zland    ! south except F-point
618                                                   pt2d_array(ii)%pt2d(:, nlcj-jprecj+1:jpj    ) = zland    ! north
619            !
620         ENDIF
621      END DO
622
623      ! 2. East and west directions exchange
624      ! ------------------------------------
625      ! we play with the neigbours AND the row number because of the periodicity
626      !
627      DO ii = 1 , num_fields
628         SELECT CASE ( nbondi )      ! Read Dirichlet lateral conditions
629         CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
630            iihom = nlci-nreci
631            DO jl = 1, jpreci
632               zt2ew( : , jl , ii ) = pt2d_array(ii)%pt2d( jpreci+jl , : )
633               zt2we( : , jl , ii ) = pt2d_array(ii)%pt2d( iihom +jl , : )
634            END DO
635         END SELECT
636      END DO
637      !
638      !                           ! Migrations
639      imigr = jpreci * jpj
640      !
641      SELECT CASE ( nbondi )
642      CASE ( -1 )
643         CALL mppsend( 2, zt2we(1,1,1), num_fields*imigr, noea, ml_req1 )
644         CALL mpprecv( 1, zt2ew(1,1,num_fields+1), num_fields*imigr, noea )
645         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
646      CASE ( 0 )
647         CALL mppsend( 1, zt2ew(1,1,1), num_fields*imigr, nowe, ml_req1 )
648         CALL mppsend( 2, zt2we(1,1,1), num_fields*imigr, noea, ml_req2 )
649         CALL mpprecv( 1, zt2ew(1,1,num_fields+1), num_fields*imigr, noea )
650         CALL mpprecv( 2, zt2we(1,1,num_fields+1), num_fields*imigr, nowe )
651         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
652         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
653      CASE ( 1 )
654         CALL mppsend( 1, zt2ew(1,1,1), num_fields*imigr, nowe, ml_req1 )
655         CALL mpprecv( 2, zt2we(1,1,num_fields+1), num_fields*imigr, nowe )
656         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
657      END SELECT
658      !
659      !                           ! Write Dirichlet lateral conditions
660      iihom = nlci - jpreci
661      !
662
663      DO ii = 1 , num_fields
664         SELECT CASE ( nbondi )
665         CASE ( -1 )
666            DO jl = 1, jpreci
667               pt2d_array(ii)%pt2d( iihom+jl , : ) = zt2ew(:,jl,num_fields+ii)
668            END DO
669         CASE ( 0 )
670            DO jl = 1, jpreci
671               pt2d_array(ii)%pt2d( jl , : ) = zt2we(:,jl,num_fields+ii)
672               pt2d_array(ii)%pt2d( iihom+jl , : ) = zt2ew(:,jl,num_fields+ii)
673            END DO
674         CASE ( 1 )
675            DO jl = 1, jpreci
676               pt2d_array(ii)%pt2d( jl , : )= zt2we(:,jl,num_fields+ii)
677            END DO
678         END SELECT
679      END DO
680     
681      ! 3. North and south directions
682      ! -----------------------------
683      ! always closed : we play only with the neigbours
684      !
685      !First Array
686      DO ii = 1 , num_fields
687         IF( nbondj /= 2 ) THEN      ! Read Dirichlet lateral conditions
688            ijhom = nlcj-nrecj
689            DO jl = 1, jprecj
690               zt2sn(:,jl , ii) = pt2d_array(ii)%pt2d( : , ijhom +jl )
691               zt2ns(:,jl , ii) = pt2d_array(ii)%pt2d( : , jprecj+jl )
692            END DO
693         ENDIF
694      END DO
695      !
696      !                           ! Migrations
697      imigr = jprecj * jpi
698      !
699      SELECT CASE ( nbondj )
700      CASE ( -1 )
701         CALL mppsend( 4, zt2sn(1,1,1), num_fields*imigr, nono, ml_req1 )
702         CALL mpprecv( 3, zt2ns(1,1,num_fields+1), num_fields*imigr, nono )
703         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
704      CASE ( 0 )
705         CALL mppsend( 3, zt2ns(1,1,1), num_fields*imigr, noso, ml_req1 )
706         CALL mppsend( 4, zt2sn(1,1,1), num_fields*imigr, nono, ml_req2 )
707         CALL mpprecv( 3, zt2ns(1,1,num_fields+1), num_fields*imigr, nono )
708         CALL mpprecv( 4, zt2sn(1,1,num_fields+1), num_fields*imigr, noso )
709         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
710         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
711      CASE ( 1 )
712         CALL mppsend( 3, zt2ns(1,1,1), num_fields*imigr, noso, ml_req1 )
713         CALL mpprecv( 4, zt2sn(1,1,num_fields+1), num_fields*imigr, noso )
714         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
715      END SELECT
716      !
717      !                           ! Write Dirichlet lateral conditions
718      ijhom = nlcj - jprecj
719      !
720
721      DO ii = 1 , num_fields
722         !First Array
723         SELECT CASE ( nbondj )
724         CASE ( -1 )
725            DO jl = 1, jprecj
726               pt2d_array(ii)%pt2d( : , ijhom+jl ) = zt2ns( : , jl , num_fields+ii )
727            END DO
728         CASE ( 0 )
729            DO jl = 1, jprecj
730               pt2d_array(ii)%pt2d( : , jl ) = zt2sn( : , jl , num_fields + ii)
731               pt2d_array(ii)%pt2d( : , ijhom + jl ) = zt2ns( : , jl , num_fields + ii )
732            END DO
733         CASE ( 1 )
734            DO jl = 1, jprecj
735               pt2d_array(ii)%pt2d( : , jl ) = zt2sn( : , jl , num_fields + ii )
736            END DO
737         END SELECT
738      END DO
739     
740      ! 4. north fold treatment
741      ! -----------------------
742      !
743         !First Array
[6476]744      IF( npolj /= 0 .AND. .NOT. PRESENT(cd_mpp) ) THEN
[5429]745         !
[6476]746         SELECT CASE ( jpni )
747         CASE ( 1 )     ;   
748             DO ii = 1 , num_fields 
749                       CALL lbc_nfd      ( pt2d_array(ii)%pt2d( : , : ), type_array(ii) , psgn_array(ii) )   ! only 1 northern proc, no mpp
750             END DO
751         CASE DEFAULT   ;   CALL mpp_lbc_north_2d_multiple( pt2d_array, type_array, psgn_array, num_fields )   ! for all northern procs.
752         END SELECT
753         !
754      ENDIF
755        !
[5429]756     
757      DEALLOCATE( zt2ns, zt2sn, zt2ew, zt2we )
758      !
759   END SUBROUTINE mpp_lnk_2d_multiple
760
761   
762   SUBROUTINE load_array(pt2d,cd_type,psgn,pt2d_array, type_array, psgn_array,num_fields)
763      !!---------------------------------------------------------------------
764      REAL(wp), DIMENSION(jpi,jpj), TARGET   ,   INTENT(inout) ::   pt2d    ! Second 2D array on which the boundary condition is applied
765      CHARACTER(len=1)            , INTENT(in   ) ::   cd_type ! define the nature of ptab array grid-points
766      REAL(wp)                    , INTENT(in   ) ::   psgn    ! =-1 the sign change across the north fold boundary
767      TYPE(arrayptr)   , DIMENSION(9) ::   pt2d_array
768      CHARACTER(len=1) , DIMENSION(9) ::   type_array    ! define the nature of ptab array grid-points
769      REAL(wp)         , DIMENSION(9) ::   psgn_array    ! =-1 the sign change across the north fold boundary
770      INTEGER                      , INTENT (inout):: num_fields 
771      !!---------------------------------------------------------------------
772      num_fields=num_fields+1
773      pt2d_array(num_fields)%pt2d=>pt2d
774      type_array(num_fields)=cd_type
775      psgn_array(num_fields)=psgn
776   END SUBROUTINE load_array
777   
778   
779   SUBROUTINE mpp_lnk_2d_9( pt2dA, cd_typeA, psgnA, pt2dB, cd_typeB, psgnB, pt2dC, cd_typeC, psgnC   &
780      &                   , pt2dD, cd_typeD, psgnD, pt2dE, cd_typeE, psgnE, pt2dF, cd_typeF, psgnF   &
781      &                   , pt2dG, cd_typeG, psgnG, pt2dH, cd_typeH, psgnH, pt2dI, cd_typeI, psgnI, cd_mpp, pval)
782      !!---------------------------------------------------------------------
783      ! Second 2D array on which the boundary condition is applied
784      REAL(wp), DIMENSION(jpi,jpj), TARGET          , INTENT(inout) ::   pt2dA   
785      REAL(wp), DIMENSION(jpi,jpj), TARGET, OPTIONAL, INTENT(inout) ::   pt2dB , pt2dC , pt2dD , pt2dE
786      REAL(wp), DIMENSION(jpi,jpj), TARGET, OPTIONAL, INTENT(inout) ::   pt2dF , pt2dG , pt2dH , pt2dI 
787      ! define the nature of ptab array grid-points
788      CHARACTER(len=1)                              , INTENT(in   ) ::   cd_typeA
789      CHARACTER(len=1)                    , OPTIONAL, INTENT(in   ) ::   cd_typeB , cd_typeC , cd_typeD , cd_typeE
790      CHARACTER(len=1)                    , OPTIONAL, INTENT(in   ) ::   cd_typeF , cd_typeG , cd_typeH , cd_typeI
791      ! =-1 the sign change across the north fold boundary
792      REAL(wp)                                      , INTENT(in   ) ::   psgnA   
793      REAL(wp)                            , OPTIONAL, INTENT(in   ) ::   psgnB , psgnC , psgnD , psgnE
794      REAL(wp)                            , OPTIONAL, INTENT(in   ) ::   psgnF , psgnG , psgnH , psgnI   
795      CHARACTER(len=3)                    , OPTIONAL, INTENT(in   ) ::   cd_mpp   ! fill the overlap area only
796      REAL(wp)                            , OPTIONAL, INTENT(in   ) ::   pval     ! background value (used at closed boundaries)
797      !!
798      TYPE(arrayptr)   , DIMENSION(9) ::   pt2d_array 
799      CHARACTER(len=1) , DIMENSION(9) ::   type_array    ! define the nature of ptab array grid-points
800      !                                                         ! = T , U , V , F , W and I points
801      REAL(wp)         , DIMENSION(9) ::   psgn_array    ! =-1 the sign change across the north fold boundary
802      INTEGER :: num_fields
803      !!---------------------------------------------------------------------
804
805      num_fields = 0
806
807      !! Load the first array
808      CALL load_array(pt2dA,cd_typeA,psgnA,pt2d_array, type_array, psgn_array,num_fields)
809
810      !! Look if more arrays are added
811      IF(PRESENT (psgnB) )CALL load_array(pt2dB,cd_typeB,psgnB,pt2d_array, type_array, psgn_array,num_fields)
812      IF(PRESENT (psgnC) )CALL load_array(pt2dC,cd_typeC,psgnC,pt2d_array, type_array, psgn_array,num_fields)
813      IF(PRESENT (psgnD) )CALL load_array(pt2dD,cd_typeD,psgnD,pt2d_array, type_array, psgn_array,num_fields)
814      IF(PRESENT (psgnE) )CALL load_array(pt2dE,cd_typeE,psgnE,pt2d_array, type_array, psgn_array,num_fields)
815      IF(PRESENT (psgnF) )CALL load_array(pt2dF,cd_typeF,psgnF,pt2d_array, type_array, psgn_array,num_fields)
816      IF(PRESENT (psgnG) )CALL load_array(pt2dG,cd_typeG,psgnG,pt2d_array, type_array, psgn_array,num_fields)
817      IF(PRESENT (psgnH) )CALL load_array(pt2dH,cd_typeH,psgnH,pt2d_array, type_array, psgn_array,num_fields)
818      IF(PRESENT (psgnI) )CALL load_array(pt2dI,cd_typeI,psgnI,pt2d_array, type_array, psgn_array,num_fields)
819     
820      CALL mpp_lnk_2d_multiple(pt2d_array,type_array,psgn_array,num_fields,cd_mpp,pval)
821   END SUBROUTINE mpp_lnk_2d_9
822
823
[888]824   SUBROUTINE mpp_lnk_2d( pt2d, cd_type, psgn, cd_mpp, pval )
[51]825      !!----------------------------------------------------------------------
826      !!                  ***  routine mpp_lnk_2d  ***
[3764]827      !!
[51]828      !! ** Purpose :   Message passing manadgement for 2d array
829      !!
[3764]830      !! ** Method  :   Use mppsend and mpprecv function for passing mask
[51]831      !!      between processors following neighboring subdomains.
832      !!            domain parameters
833      !!                    nlci   : first dimension of the local subdomain
834      !!                    nlcj   : second dimension of the local subdomain
835      !!                    nbondi : mark for "east-west local boundary"
836      !!                    nbondj : mark for "north-south local boundary"
[3764]837      !!                    noea   : number for local neighboring processors
[51]838      !!                    nowe   : number for local neighboring processors
839      !!                    noso   : number for local neighboring processors
840      !!                    nono   : number for local neighboring processors
841      !!
842      !!----------------------------------------------------------------------
[1344]843      REAL(wp), DIMENSION(jpi,jpj), INTENT(inout) ::   pt2d     ! 2D array on which the boundary condition is applied
844      CHARACTER(len=1)            , INTENT(in   ) ::   cd_type  ! define the nature of ptab array grid-points
845      !                                                         ! = T , U , V , F , W and I points
846      REAL(wp)                    , INTENT(in   ) ::   psgn     ! =-1 the sign change across the north fold boundary
847      !                                                         ! =  1. , the sign is kept
[3764]848      CHARACTER(len=3), OPTIONAL  , INTENT(in   ) ::   cd_mpp   ! fill the overlap area only
[1344]849      REAL(wp)        , OPTIONAL  , INTENT(in   ) ::   pval     ! background value (used at closed boundaries)
850      !!
851      INTEGER  ::   ji, jj, jl   ! dummy loop indices
852      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
853      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
[888]854      REAL(wp) ::   zland
[1344]855      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
[4152]856      !
857      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  zt2ns, zt2sn   ! 2d for north-south & south-north
858      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  zt2ew, zt2we   ! 2d for east-west & west-east
859
[51]860      !!----------------------------------------------------------------------
[3]861
[4152]862      ALLOCATE( zt2ns(jpi,jprecj,2), zt2sn(jpi,jprecj,2),  &
863         &      zt2ew(jpj,jpreci,2), zt2we(jpj,jpreci,2)   )
864
865      !
[1344]866      IF( PRESENT( pval ) ) THEN   ;   zland = pval      ! set land value
867      ELSE                         ;   zland = 0.e0      ! zero by default
[888]868      ENDIF
869
[51]870      ! 1. standard boundary treatment
871      ! ------------------------------
[1344]872      !
[1718]873      IF( PRESENT( cd_mpp ) ) THEN      ! only fill added line/raw with existing values
[1344]874         !
[1718]875         ! WARNING pt2d is defined only between nld and nle
876         DO jj = nlcj+1, jpj                 ! added line(s)   (inner only)
[3764]877            pt2d(nldi  :nlei  , jj          ) = pt2d(nldi:nlei,     nlej)
[1718]878            pt2d(1     :nldi-1, jj          ) = pt2d(nldi     ,     nlej)
879            pt2d(nlei+1:nlci  , jj          ) = pt2d(     nlei,     nlej)
[610]880         END DO
[1718]881         DO ji = nlci+1, jpi                 ! added column(s) (full)
882            pt2d(ji           ,nldj  :nlej  ) = pt2d(     nlei,nldj:nlej)
883            pt2d(ji           ,1     :nldj-1) = pt2d(     nlei,nldj     )
884            pt2d(ji           ,nlej+1:jpj   ) = pt2d(     nlei,     nlej)
[1344]885         END DO
886         !
[3764]887      ELSE                              ! standard close or cyclic treatment
[1344]888         !
889         !                                   ! East-West boundaries
890         IF( nbondi == 2 .AND.   &                ! Cyclic east-west
[473]891            &    (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) ) THEN
[1344]892            pt2d( 1 ,:) = pt2d(jpim1,:)                                    ! west
893            pt2d(jpi,:) = pt2d(  2  ,:)                                    ! east
894         ELSE                                     ! closed
895            IF( .NOT. cd_type == 'F' )   pt2d(     1       :jpreci,:) = zland    ! south except F-point
896                                         pt2d(nlci-jpreci+1:jpi   ,:) = zland    ! north
[473]897         ENDIF
[1344]898         !                                   ! North-South boundaries (always closed)
899            IF( .NOT. cd_type == 'F' )   pt2d(:,     1       :jprecj) = zland    !south except F-point
900                                         pt2d(:,nlcj-jprecj+1:jpj   ) = zland    ! north
901         !
[51]902      ENDIF
[3]903
[1344]904      ! 2. East and west directions exchange
905      ! ------------------------------------
[3764]906      ! we play with the neigbours AND the row number because of the periodicity
[1344]907      !
908      SELECT CASE ( nbondi )      ! Read Dirichlet lateral conditions
909      CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
[51]910         iihom = nlci-nreci
911         DO jl = 1, jpreci
[4152]912            zt2ew(:,jl,1) = pt2d(jpreci+jl,:)
913            zt2we(:,jl,1) = pt2d(iihom +jl,:)
[51]914         END DO
915      END SELECT
[1344]916      !
917      !                           ! Migrations
[51]918      imigr = jpreci * jpj
[1344]919      !
[51]920      SELECT CASE ( nbondi )
921      CASE ( -1 )
[4152]922         CALL mppsend( 2, zt2we(1,1,1), imigr, noea, ml_req1 )
923         CALL mpprecv( 1, zt2ew(1,1,2), imigr, noea )
[300]924         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
[51]925      CASE ( 0 )
[4152]926         CALL mppsend( 1, zt2ew(1,1,1), imigr, nowe, ml_req1 )
927         CALL mppsend( 2, zt2we(1,1,1), imigr, noea, ml_req2 )
928         CALL mpprecv( 1, zt2ew(1,1,2), imigr, noea )
929         CALL mpprecv( 2, zt2we(1,1,2), imigr, nowe )
[300]930         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
931         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
[51]932      CASE ( 1 )
[4152]933         CALL mppsend( 1, zt2ew(1,1,1), imigr, nowe, ml_req1 )
934         CALL mpprecv( 2, zt2we(1,1,2), imigr, nowe )
[300]935         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
[51]936      END SELECT
[1344]937      !
938      !                           ! Write Dirichlet lateral conditions
[51]939      iihom = nlci - jpreci
[1344]940      !
[51]941      SELECT CASE ( nbondi )
942      CASE ( -1 )
943         DO jl = 1, jpreci
[4152]944            pt2d(iihom+jl,:) = zt2ew(:,jl,2)
[51]945         END DO
946      CASE ( 0 )
947         DO jl = 1, jpreci
[4152]948            pt2d(jl      ,:) = zt2we(:,jl,2)
949            pt2d(iihom+jl,:) = zt2ew(:,jl,2)
[51]950         END DO
951      CASE ( 1 )
952         DO jl = 1, jpreci
[4152]953            pt2d(jl      ,:) = zt2we(:,jl,2)
[51]954         END DO
955      END SELECT
[3]956
957
[51]958      ! 3. North and south directions
959      ! -----------------------------
[1344]960      ! always closed : we play only with the neigbours
961      !
962      IF( nbondj /= 2 ) THEN      ! Read Dirichlet lateral conditions
[51]963         ijhom = nlcj-nrecj
964         DO jl = 1, jprecj
[4152]965            zt2sn(:,jl,1) = pt2d(:,ijhom +jl)
966            zt2ns(:,jl,1) = pt2d(:,jprecj+jl)
[51]967         END DO
968      ENDIF
[1344]969      !
970      !                           ! Migrations
[51]971      imigr = jprecj * jpi
[1344]972      !
[51]973      SELECT CASE ( nbondj )
974      CASE ( -1 )
[4152]975         CALL mppsend( 4, zt2sn(1,1,1), imigr, nono, ml_req1 )
976         CALL mpprecv( 3, zt2ns(1,1,2), imigr, nono )
[300]977         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
[51]978      CASE ( 0 )
[4152]979         CALL mppsend( 3, zt2ns(1,1,1), imigr, noso, ml_req1 )
980         CALL mppsend( 4, zt2sn(1,1,1), imigr, nono, ml_req2 )
981         CALL mpprecv( 3, zt2ns(1,1,2), imigr, nono )
982         CALL mpprecv( 4, zt2sn(1,1,2), imigr, noso )
[300]983         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
984         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
[51]985      CASE ( 1 )
[4152]986         CALL mppsend( 3, zt2ns(1,1,1), imigr, noso, ml_req1 )
987         CALL mpprecv( 4, zt2sn(1,1,2), imigr, noso )
[300]988         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
[51]989      END SELECT
[1344]990      !
991      !                           ! Write Dirichlet lateral conditions
[51]992      ijhom = nlcj - jprecj
[1344]993      !
[51]994      SELECT CASE ( nbondj )
995      CASE ( -1 )
996         DO jl = 1, jprecj
[4152]997            pt2d(:,ijhom+jl) = zt2ns(:,jl,2)
[51]998         END DO
999      CASE ( 0 )
1000         DO jl = 1, jprecj
[4152]1001            pt2d(:,jl      ) = zt2sn(:,jl,2)
1002            pt2d(:,ijhom+jl) = zt2ns(:,jl,2)
[51]1003         END DO
[3764]1004      CASE ( 1 )
[51]1005         DO jl = 1, jprecj
[4152]1006            pt2d(:,jl      ) = zt2sn(:,jl,2)
[51]1007         END DO
[1344]1008      END SELECT
[3]1009
[1344]1010
[51]1011      ! 4. north fold treatment
1012      ! -----------------------
[1344]1013      !
1014      IF( npolj /= 0 .AND. .NOT. PRESENT(cd_mpp) ) THEN
1015         !
1016         SELECT CASE ( jpni )
1017         CASE ( 1 )     ;   CALL lbc_nfd      ( pt2d, cd_type, psgn )   ! only 1 northern proc, no mpp
1018         CASE DEFAULT   ;   CALL mpp_lbc_north( pt2d, cd_type, psgn )   ! for all northern procs.
1019         END SELECT
1020         !
[473]1021      ENDIF
[1344]1022      !
[4152]1023      DEALLOCATE( zt2ns, zt2sn, zt2ew, zt2we )
1024      !
[51]1025   END SUBROUTINE mpp_lnk_2d
[3]1026
1027
[473]1028   SUBROUTINE mpp_lnk_3d_gather( ptab1, cd_type1, ptab2, cd_type2, psgn )
1029      !!----------------------------------------------------------------------
1030      !!                  ***  routine mpp_lnk_3d_gather  ***
1031      !!
1032      !! ** Purpose :   Message passing manadgement for two 3D arrays
1033      !!
[3764]1034      !! ** Method  :   Use mppsend and mpprecv function for passing mask
[473]1035      !!      between processors following neighboring subdomains.
1036      !!            domain parameters
1037      !!                    nlci   : first dimension of the local subdomain
1038      !!                    nlcj   : second dimension of the local subdomain
1039      !!                    nbondi : mark for "east-west local boundary"
1040      !!                    nbondj : mark for "north-south local boundary"
[3764]1041      !!                    noea   : number for local neighboring processors
[473]1042      !!                    nowe   : number for local neighboring processors
1043      !!                    noso   : number for local neighboring processors
1044      !!                    nono   : number for local neighboring processors
1045      !!
1046      !! ** Action  :   ptab1 and ptab2  with update value at its periphery
1047      !!
1048      !!----------------------------------------------------------------------
[3764]1049      REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(inout) ::   ptab1     ! first and second 3D array on which
[1344]1050      REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(inout) ::   ptab2     ! the boundary condition is applied
[3764]1051      CHARACTER(len=1)                , INTENT(in   ) ::   cd_type1  ! nature of ptab1 and ptab2 arrays
[1344]1052      CHARACTER(len=1)                , INTENT(in   ) ::   cd_type2  ! i.e. grid-points = T , U , V , F or W points
1053      REAL(wp)                        , INTENT(in   ) ::   psgn      ! =-1 the sign change across the north fold boundary
1054      !!                                                             ! =  1. , the sign is kept
1055      INTEGER  ::   jl   ! dummy loop indices
1056      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
1057      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
1058      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
[4152]1059      !
1060      REAL(wp), DIMENSION(:,:,:,:,:), ALLOCATABLE ::   zt4ns, zt4sn   ! 2 x 3d for north-south & south-north
1061      REAL(wp), DIMENSION(:,:,:,:,:), ALLOCATABLE ::   zt4ew, zt4we   ! 2 x 3d for east-west & west-east
1062
[473]1063      !!----------------------------------------------------------------------
[4152]1064      ALLOCATE( zt4ns(jpi,jprecj,jpk,2,2), zt4sn(jpi,jprecj,jpk,2,2) ,    &
1065         &      zt4ew(jpj,jpreci,jpk,2,2), zt4we(jpj,jpreci,jpk,2,2) )
[473]1066
[4152]1067
[473]1068      ! 1. standard boundary treatment
1069      ! ------------------------------
[1344]1070      !                                      ! East-West boundaries
1071      !                                           !* Cyclic east-west
1072      IF( nbondi == 2 .AND. (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) ) THEN
[473]1073         ptab1( 1 ,:,:) = ptab1(jpim1,:,:)
1074         ptab1(jpi,:,:) = ptab1(  2  ,:,:)
1075         ptab2( 1 ,:,:) = ptab2(jpim1,:,:)
1076         ptab2(jpi,:,:) = ptab2(  2  ,:,:)
[1344]1077      ELSE                                        !* closed
1078         IF( .NOT. cd_type1 == 'F' )   ptab1(     1       :jpreci,:,:) = 0.e0    ! south except at F-point
1079         IF( .NOT. cd_type2 == 'F' )   ptab2(     1       :jpreci,:,:) = 0.e0
1080                                       ptab1(nlci-jpreci+1:jpi   ,:,:) = 0.e0    ! north
1081                                       ptab2(nlci-jpreci+1:jpi   ,:,:) = 0.e0
[473]1082      ENDIF
1083
[3764]1084
[1344]1085      !                                      ! North-South boundaries
1086      IF( .NOT. cd_type1 == 'F' )   ptab1(:,     1       :jprecj,:) = 0.e0    ! south except at F-point
1087      IF( .NOT. cd_type2 == 'F' )   ptab2(:,     1       :jprecj,:) = 0.e0
1088                                    ptab1(:,nlcj-jprecj+1:jpj   ,:) = 0.e0    ! north
1089                                    ptab2(:,nlcj-jprecj+1:jpj   ,:) = 0.e0
[473]1090
1091
1092      ! 2. East and west directions exchange
1093      ! ------------------------------------
[3764]1094      ! we play with the neigbours AND the row number because of the periodicity
[1344]1095      !
1096      SELECT CASE ( nbondi )      ! Read Dirichlet lateral conditions
1097      CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
[473]1098         iihom = nlci-nreci
1099         DO jl = 1, jpreci
[4152]1100            zt4ew(:,jl,:,1,1) = ptab1(jpreci+jl,:,:)
1101            zt4we(:,jl,:,1,1) = ptab1(iihom +jl,:,:)
1102            zt4ew(:,jl,:,2,1) = ptab2(jpreci+jl,:,:)
1103            zt4we(:,jl,:,2,1) = ptab2(iihom +jl,:,:)
[473]1104         END DO
1105      END SELECT
[1344]1106      !
1107      !                           ! Migrations
[473]1108      imigr = jpreci * jpj * jpk *2
[1344]1109      !
[3764]1110      SELECT CASE ( nbondi )
[473]1111      CASE ( -1 )
[4152]1112         CALL mppsend( 2, zt4we(1,1,1,1,1), imigr, noea, ml_req1 )
1113         CALL mpprecv( 1, zt4ew(1,1,1,1,2), imigr, noea )
[473]1114         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
1115      CASE ( 0 )
[4152]1116         CALL mppsend( 1, zt4ew(1,1,1,1,1), imigr, nowe, ml_req1 )
1117         CALL mppsend( 2, zt4we(1,1,1,1,1), imigr, noea, ml_req2 )
1118         CALL mpprecv( 1, zt4ew(1,1,1,1,2), imigr, noea )
1119         CALL mpprecv( 2, zt4we(1,1,1,1,2), imigr, nowe )
[473]1120         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
1121         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
1122      CASE ( 1 )
[4152]1123         CALL mppsend( 1, zt4ew(1,1,1,1,1), imigr, nowe, ml_req1 )
1124         CALL mpprecv( 2, zt4we(1,1,1,1,2), imigr, nowe )
[473]1125         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
1126      END SELECT
[1344]1127      !
1128      !                           ! Write Dirichlet lateral conditions
1129      iihom = nlci - jpreci
1130      !
[473]1131      SELECT CASE ( nbondi )
1132      CASE ( -1 )
1133         DO jl = 1, jpreci
[4152]1134            ptab1(iihom+jl,:,:) = zt4ew(:,jl,:,1,2)
1135            ptab2(iihom+jl,:,:) = zt4ew(:,jl,:,2,2)
[473]1136         END DO
[3764]1137      CASE ( 0 )
[473]1138         DO jl = 1, jpreci
[4152]1139            ptab1(jl      ,:,:) = zt4we(:,jl,:,1,2)
1140            ptab1(iihom+jl,:,:) = zt4ew(:,jl,:,1,2)
1141            ptab2(jl      ,:,:) = zt4we(:,jl,:,2,2)
1142            ptab2(iihom+jl,:,:) = zt4ew(:,jl,:,2,2)
[473]1143         END DO
1144      CASE ( 1 )
1145         DO jl = 1, jpreci
[4152]1146            ptab1(jl      ,:,:) = zt4we(:,jl,:,1,2)
1147            ptab2(jl      ,:,:) = zt4we(:,jl,:,2,2)
[473]1148         END DO
1149      END SELECT
1150
1151
1152      ! 3. North and south directions
1153      ! -----------------------------
[1344]1154      ! always closed : we play only with the neigbours
1155      !
1156      IF( nbondj /= 2 ) THEN      ! Read Dirichlet lateral conditions
1157         ijhom = nlcj - nrecj
[473]1158         DO jl = 1, jprecj
[4152]1159            zt4sn(:,jl,:,1,1) = ptab1(:,ijhom +jl,:)
1160            zt4ns(:,jl,:,1,1) = ptab1(:,jprecj+jl,:)
1161            zt4sn(:,jl,:,2,1) = ptab2(:,ijhom +jl,:)
1162            zt4ns(:,jl,:,2,1) = ptab2(:,jprecj+jl,:)
[473]1163         END DO
1164      ENDIF
[1344]1165      !
1166      !                           ! Migrations
[473]1167      imigr = jprecj * jpi * jpk * 2
[1344]1168      !
[3764]1169      SELECT CASE ( nbondj )
[473]1170      CASE ( -1 )
[4152]1171         CALL mppsend( 4, zt4sn(1,1,1,1,1), imigr, nono, ml_req1 )
1172         CALL mpprecv( 3, zt4ns(1,1,1,1,2), imigr, nono )
[473]1173         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
1174      CASE ( 0 )
[4152]1175         CALL mppsend( 3, zt4ns(1,1,1,1,1), imigr, noso, ml_req1 )
1176         CALL mppsend( 4, zt4sn(1,1,1,1,1), imigr, nono, ml_req2 )
1177         CALL mpprecv( 3, zt4ns(1,1,1,1,2), imigr, nono )
1178         CALL mpprecv( 4, zt4sn(1,1,1,1,2), imigr, noso )
[473]1179         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
1180         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
[3764]1181      CASE ( 1 )
[4152]1182         CALL mppsend( 3, zt4ns(1,1,1,1,1), imigr, noso, ml_req1 )
1183         CALL mpprecv( 4, zt4sn(1,1,1,1,2), imigr, noso )
[473]1184         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
1185      END SELECT
[1344]1186      !
1187      !                           ! Write Dirichlet lateral conditions
1188      ijhom = nlcj - jprecj
1189      !
[473]1190      SELECT CASE ( nbondj )
1191      CASE ( -1 )
1192         DO jl = 1, jprecj
[4152]1193            ptab1(:,ijhom+jl,:) = zt4ns(:,jl,:,1,2)
1194            ptab2(:,ijhom+jl,:) = zt4ns(:,jl,:,2,2)
[473]1195         END DO
[3764]1196      CASE ( 0 )
[473]1197         DO jl = 1, jprecj
[4152]1198            ptab1(:,jl      ,:) = zt4sn(:,jl,:,1,2)
1199            ptab1(:,ijhom+jl,:) = zt4ns(:,jl,:,1,2)
1200            ptab2(:,jl      ,:) = zt4sn(:,jl,:,2,2)
1201            ptab2(:,ijhom+jl,:) = zt4ns(:,jl,:,2,2)
[473]1202         END DO
1203      CASE ( 1 )
1204         DO jl = 1, jprecj
[4152]1205            ptab1(:,jl,:) = zt4sn(:,jl,:,1,2)
1206            ptab2(:,jl,:) = zt4sn(:,jl,:,2,2)
[473]1207         END DO
1208      END SELECT
1209
1210
1211      ! 4. north fold treatment
1212      ! -----------------------
[1344]1213      IF( npolj /= 0 ) THEN
1214         !
1215         SELECT CASE ( jpni )
[3764]1216         CASE ( 1 )
[1344]1217            CALL lbc_nfd      ( ptab1, cd_type1, psgn )   ! only for northern procs.
1218            CALL lbc_nfd      ( ptab2, cd_type2, psgn )
1219         CASE DEFAULT
1220            CALL mpp_lbc_north( ptab1, cd_type1, psgn )   ! for all northern procs.
1221            CALL mpp_lbc_north (ptab2, cd_type2, psgn)
[3764]1222         END SELECT
[1344]1223         !
1224      ENDIF
1225      !
[4152]1226      DEALLOCATE( zt4ns, zt4sn, zt4ew, zt4we )
1227      !
[473]1228   END SUBROUTINE mpp_lnk_3d_gather
1229
1230
[3609]1231   SUBROUTINE mpp_lnk_2d_e( pt2d, cd_type, psgn, jpri, jprj )
[311]1232      !!----------------------------------------------------------------------
1233      !!                  ***  routine mpp_lnk_2d_e  ***
[3764]1234      !!
[311]1235      !! ** Purpose :   Message passing manadgement for 2d array (with halo)
1236      !!
[3764]1237      !! ** Method  :   Use mppsend and mpprecv function for passing mask
[311]1238      !!      between processors following neighboring subdomains.
1239      !!            domain parameters
1240      !!                    nlci   : first dimension of the local subdomain
1241      !!                    nlcj   : second dimension of the local subdomain
[3609]1242      !!                    jpri   : number of rows for extra outer halo
1243      !!                    jprj   : number of columns for extra outer halo
[311]1244      !!                    nbondi : mark for "east-west local boundary"
1245      !!                    nbondj : mark for "north-south local boundary"
[3764]1246      !!                    noea   : number for local neighboring processors
[311]1247      !!                    nowe   : number for local neighboring processors
1248      !!                    noso   : number for local neighboring processors
1249      !!                    nono   : number for local neighboring processors
1250      !!
1251      !!----------------------------------------------------------------------
[3609]1252      INTEGER                                             , INTENT(in   ) ::   jpri
1253      INTEGER                                             , INTENT(in   ) ::   jprj
1254      REAL(wp), DIMENSION(1-jpri:jpi+jpri,1-jprj:jpj+jprj), INTENT(inout) ::   pt2d     ! 2D array with extra halo
1255      CHARACTER(len=1)                                    , INTENT(in   ) ::   cd_type  ! nature of ptab array grid-points
1256      !                                                                                 ! = T , U , V , F , W and I points
1257      REAL(wp)                                            , INTENT(in   ) ::   psgn     ! =-1 the sign change across the
1258      !!                                                                                ! north boundary, =  1. otherwise
[1344]1259      INTEGER  ::   jl   ! dummy loop indices
1260      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
1261      INTEGER  ::   ipreci, iprecj             ! temporary integers
1262      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
1263      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
[3609]1264      !!
1265      REAL(wp), DIMENSION(1-jpri:jpi+jpri,jprecj+jprj,2) :: r2dns
1266      REAL(wp), DIMENSION(1-jpri:jpi+jpri,jprecj+jprj,2) :: r2dsn
1267      REAL(wp), DIMENSION(1-jprj:jpj+jprj,jpreci+jpri,2) :: r2dwe
1268      REAL(wp), DIMENSION(1-jprj:jpj+jprj,jpreci+jpri,2) :: r2dew
[1344]1269      !!----------------------------------------------------------------------
[311]1270
[3609]1271      ipreci = jpreci + jpri      ! take into account outer extra 2D overlap area
1272      iprecj = jprecj + jprj
[311]1273
1274
1275      ! 1. standard boundary treatment
1276      ! ------------------------------
[1344]1277      ! Order matters Here !!!!
1278      !
1279      !                                      !* North-South boundaries (always colsed)
[3609]1280      IF( .NOT. cd_type == 'F' )   pt2d(:,  1-jprj   :  jprecj  ) = 0.e0    ! south except at F-point
1281                                   pt2d(:,nlcj-jprecj+1:jpj+jprj) = 0.e0    ! north
[3764]1282
[1344]1283      !                                      ! East-West boundaries
1284      !                                           !* Cyclic east-west
1285      IF( nbondi == 2 .AND. (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) ) THEN
[3609]1286         pt2d(1-jpri:     1    ,:) = pt2d(jpim1-jpri:  jpim1 ,:)       ! east
1287         pt2d(   jpi  :jpi+jpri,:) = pt2d(     2      :2+jpri,:)       ! west
[1344]1288         !
1289      ELSE                                        !* closed
[3609]1290         IF( .NOT. cd_type == 'F' )   pt2d(  1-jpri   :jpreci    ,:) = 0.e0    ! south except at F-point
1291                                      pt2d(nlci-jpreci+1:jpi+jpri,:) = 0.e0    ! north
[1344]1292      ENDIF
1293      !
[311]1294
[1344]1295      ! north fold treatment
1296      ! -----------------------
1297      IF( npolj /= 0 ) THEN
1298         !
1299         SELECT CASE ( jpni )
[3609]1300         CASE ( 1 )     ;   CALL lbc_nfd        ( pt2d(1:jpi,1:jpj+jprj), cd_type, psgn, pr2dj=jprj )
[1344]1301         CASE DEFAULT   ;   CALL mpp_lbc_north_e( pt2d                    , cd_type, psgn               )
[3764]1302         END SELECT
[1344]1303         !
[311]1304      ENDIF
1305
[1344]1306      ! 2. East and west directions exchange
1307      ! ------------------------------------
[3764]1308      ! we play with the neigbours AND the row number because of the periodicity
[1344]1309      !
1310      SELECT CASE ( nbondi )      ! Read Dirichlet lateral conditions
1311      CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
[3609]1312         iihom = nlci-nreci-jpri
[311]1313         DO jl = 1, ipreci
[3609]1314            r2dew(:,jl,1) = pt2d(jpreci+jl,:)
1315            r2dwe(:,jl,1) = pt2d(iihom +jl,:)
[311]1316         END DO
1317      END SELECT
[1344]1318      !
1319      !                           ! Migrations
[3609]1320      imigr = ipreci * ( jpj + 2*jprj)
[1344]1321      !
[311]1322      SELECT CASE ( nbondi )
1323      CASE ( -1 )
[3609]1324         CALL mppsend( 2, r2dwe(1-jprj,1,1), imigr, noea, ml_req1 )
1325         CALL mpprecv( 1, r2dew(1-jprj,1,2), imigr, noea )
[311]1326         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
1327      CASE ( 0 )
[3609]1328         CALL mppsend( 1, r2dew(1-jprj,1,1), imigr, nowe, ml_req1 )
1329         CALL mppsend( 2, r2dwe(1-jprj,1,1), imigr, noea, ml_req2 )
1330         CALL mpprecv( 1, r2dew(1-jprj,1,2), imigr, noea )
1331         CALL mpprecv( 2, r2dwe(1-jprj,1,2), imigr, nowe )
[311]1332         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
1333         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
1334      CASE ( 1 )
[3609]1335         CALL mppsend( 1, r2dew(1-jprj,1,1), imigr, nowe, ml_req1 )
1336         CALL mpprecv( 2, r2dwe(1-jprj,1,2), imigr, nowe )
[311]1337         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
1338      END SELECT
[1344]1339      !
1340      !                           ! Write Dirichlet lateral conditions
[311]1341      iihom = nlci - jpreci
[1344]1342      !
[311]1343      SELECT CASE ( nbondi )
1344      CASE ( -1 )
1345         DO jl = 1, ipreci
[3609]1346            pt2d(iihom+jl,:) = r2dew(:,jl,2)
[311]1347         END DO
1348      CASE ( 0 )
1349         DO jl = 1, ipreci
[3609]1350            pt2d(jl-jpri,:) = r2dwe(:,jl,2)
1351            pt2d( iihom+jl,:) = r2dew(:,jl,2)
[311]1352         END DO
1353      CASE ( 1 )
1354         DO jl = 1, ipreci
[3609]1355            pt2d(jl-jpri,:) = r2dwe(:,jl,2)
[311]1356         END DO
1357      END SELECT
1358
1359
1360      ! 3. North and south directions
1361      ! -----------------------------
[1344]1362      ! always closed : we play only with the neigbours
1363      !
1364      IF( nbondj /= 2 ) THEN      ! Read Dirichlet lateral conditions
[3609]1365         ijhom = nlcj-nrecj-jprj
[311]1366         DO jl = 1, iprecj
[3609]1367            r2dsn(:,jl,1) = pt2d(:,ijhom +jl)
1368            r2dns(:,jl,1) = pt2d(:,jprecj+jl)
[311]1369         END DO
1370      ENDIF
[1344]1371      !
1372      !                           ! Migrations
[3609]1373      imigr = iprecj * ( jpi + 2*jpri )
[1344]1374      !
[311]1375      SELECT CASE ( nbondj )
1376      CASE ( -1 )
[3609]1377         CALL mppsend( 4, r2dsn(1-jpri,1,1), imigr, nono, ml_req1 )
1378         CALL mpprecv( 3, r2dns(1-jpri,1,2), imigr, nono )
[311]1379         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
1380      CASE ( 0 )
[3609]1381         CALL mppsend( 3, r2dns(1-jpri,1,1), imigr, noso, ml_req1 )
1382         CALL mppsend( 4, r2dsn(1-jpri,1,1), imigr, nono, ml_req2 )
1383         CALL mpprecv( 3, r2dns(1-jpri,1,2), imigr, nono )
1384         CALL mpprecv( 4, r2dsn(1-jpri,1,2), imigr, noso )
[311]1385         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
1386         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
1387      CASE ( 1 )
[3609]1388         CALL mppsend( 3, r2dns(1-jpri,1,1), imigr, noso, ml_req1 )
1389         CALL mpprecv( 4, r2dsn(1-jpri,1,2), imigr, noso )
[311]1390         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
1391      END SELECT
[1344]1392      !
1393      !                           ! Write Dirichlet lateral conditions
[3764]1394      ijhom = nlcj - jprecj
[1344]1395      !
[311]1396      SELECT CASE ( nbondj )
1397      CASE ( -1 )
1398         DO jl = 1, iprecj
[3609]1399            pt2d(:,ijhom+jl) = r2dns(:,jl,2)
[311]1400         END DO
1401      CASE ( 0 )
1402         DO jl = 1, iprecj
[3609]1403            pt2d(:,jl-jprj) = r2dsn(:,jl,2)
1404            pt2d(:,ijhom+jl ) = r2dns(:,jl,2)
[311]1405         END DO
[3764]1406      CASE ( 1 )
[311]1407         DO jl = 1, iprecj
[3609]1408            pt2d(:,jl-jprj) = r2dsn(:,jl,2)
[311]1409         END DO
[1344]1410      END SELECT
[311]1411
1412   END SUBROUTINE mpp_lnk_2d_e
1413
1414
[1344]1415   SUBROUTINE mppsend( ktyp, pmess, kbytes, kdest, md_req )
[51]1416      !!----------------------------------------------------------------------
1417      !!                  ***  routine mppsend  ***
[3764]1418      !!
[51]1419      !! ** Purpose :   Send messag passing array
1420      !!
1421      !!----------------------------------------------------------------------
[1344]1422      REAL(wp), INTENT(inout) ::   pmess(*)   ! array of real
1423      INTEGER , INTENT(in   ) ::   kbytes     ! size of the array pmess
1424      INTEGER , INTENT(in   ) ::   kdest      ! receive process number
1425      INTEGER , INTENT(in   ) ::   ktyp       ! tag of the message
1426      INTEGER , INTENT(in   ) ::   md_req     ! argument for isend
1427      !!
1428      INTEGER ::   iflag
[51]1429      !!----------------------------------------------------------------------
[1344]1430      !
[1601]1431      SELECT CASE ( cn_mpi_send )
[300]1432      CASE ( 'S' )                ! Standard mpi send (blocking)
[1344]1433         CALL mpi_send ( pmess, kbytes, mpi_double_precision, kdest , ktyp, mpi_comm_opa        , iflag )
[300]1434      CASE ( 'B' )                ! Buffer mpi send (blocking)
[1344]1435         CALL mpi_bsend( pmess, kbytes, mpi_double_precision, kdest , ktyp, mpi_comm_opa        , iflag )
[300]1436      CASE ( 'I' )                ! Immediate mpi send (non-blocking send)
[1344]1437         ! be carefull, one more argument here : the mpi request identifier..
1438         CALL mpi_isend( pmess, kbytes, mpi_double_precision, kdest , ktyp, mpi_comm_opa, md_req, iflag )
[300]1439      END SELECT
[1344]1440      !
[51]1441   END SUBROUTINE mppsend
[3]1442
1443
[3294]1444   SUBROUTINE mpprecv( ktyp, pmess, kbytes, ksource )
[51]1445      !!----------------------------------------------------------------------
1446      !!                  ***  routine mpprecv  ***
1447      !!
1448      !! ** Purpose :   Receive messag passing array
1449      !!
1450      !!----------------------------------------------------------------------
[1344]1451      REAL(wp), INTENT(inout) ::   pmess(*)   ! array of real
1452      INTEGER , INTENT(in   ) ::   kbytes     ! suze of the array pmess
1453      INTEGER , INTENT(in   ) ::   ktyp       ! Tag of the recevied message
[3764]1454      INTEGER, OPTIONAL, INTENT(in) :: ksource    ! source process number
[1344]1455      !!
[51]1456      INTEGER :: istatus(mpi_status_size)
1457      INTEGER :: iflag
[3294]1458      INTEGER :: use_source
[1344]1459      !!----------------------------------------------------------------------
1460      !
[3294]1461
[3764]1462      ! If a specific process number has been passed to the receive call,
[3294]1463      ! use that one. Default is to use mpi_any_source
1464      use_source=mpi_any_source
1465      if(present(ksource)) then
1466         use_source=ksource
1467      end if
1468
1469      CALL mpi_recv( pmess, kbytes, mpi_double_precision, use_source, ktyp, mpi_comm_opa, istatus, iflag )
[1344]1470      !
[51]1471   END SUBROUTINE mpprecv
[3]1472
1473
[51]1474   SUBROUTINE mppgather( ptab, kp, pio )
1475      !!----------------------------------------------------------------------
1476      !!                   ***  routine mppgather  ***
[3764]1477      !!
1478      !! ** Purpose :   Transfert between a local subdomain array and a work
[51]1479      !!     array which is distributed following the vertical level.
1480      !!
[1344]1481      !!----------------------------------------------------------------------
1482      REAL(wp), DIMENSION(jpi,jpj),       INTENT(in   ) ::   ptab   ! subdomain input array
1483      INTEGER ,                           INTENT(in   ) ::   kp     ! record length
1484      REAL(wp), DIMENSION(jpi,jpj,jpnij), INTENT(  out) ::   pio    ! subdomain input array
[51]1485      !!
[1344]1486      INTEGER :: itaille, ierror   ! temporary integer
[51]1487      !!---------------------------------------------------------------------
[1344]1488      !
1489      itaille = jpi * jpj
1490      CALL mpi_gather( ptab, itaille, mpi_double_precision, pio, itaille     ,   &
[3764]1491         &                            mpi_double_precision, kp , mpi_comm_opa, ierror )
[1344]1492      !
[51]1493   END SUBROUTINE mppgather
[3]1494
1495
[51]1496   SUBROUTINE mppscatter( pio, kp, ptab )
1497      !!----------------------------------------------------------------------
1498      !!                  ***  routine mppscatter  ***
1499      !!
[3764]1500      !! ** Purpose :   Transfert between awork array which is distributed
[51]1501      !!      following the vertical level and the local subdomain array.
1502      !!
1503      !!----------------------------------------------------------------------
1504      REAL(wp), DIMENSION(jpi,jpj,jpnij)  ::  pio        ! output array
1505      INTEGER                             ::   kp        ! Tag (not used with MPI
1506      REAL(wp), DIMENSION(jpi,jpj)        ::  ptab       ! subdomain array input
[1344]1507      !!
1508      INTEGER :: itaille, ierror   ! temporary integer
[51]1509      !!---------------------------------------------------------------------
[1344]1510      !
[51]1511      itaille=jpi*jpj
[1344]1512      !
1513      CALL mpi_scatter( pio, itaille, mpi_double_precision, ptab, itaille     ,   &
1514         &                            mpi_double_precision, kp  , mpi_comm_opa, ierror )
1515      !
[51]1516   END SUBROUTINE mppscatter
[3]1517
1518
[869]1519   SUBROUTINE mppmax_a_int( ktab, kdim, kcom )
[681]1520      !!----------------------------------------------------------------------
1521      !!                  ***  routine mppmax_a_int  ***
[3764]1522      !!
[681]1523      !! ** Purpose :   Find maximum value in an integer layout array
1524      !!
1525      !!----------------------------------------------------------------------
[1344]1526      INTEGER , INTENT(in   )                  ::   kdim   ! size of array
1527      INTEGER , INTENT(inout), DIMENSION(kdim) ::   ktab   ! input array
[3764]1528      INTEGER , INTENT(in   ), OPTIONAL        ::   kcom   !
[1344]1529      !!
1530      INTEGER :: ierror, localcomm   ! temporary integer
[681]1531      INTEGER, DIMENSION(kdim) ::   iwork
[1344]1532      !!----------------------------------------------------------------------
1533      !
[869]1534      localcomm = mpi_comm_opa
[1344]1535      IF( PRESENT(kcom) )   localcomm = kcom
1536      !
1537      CALL mpi_allreduce( ktab, iwork, kdim, mpi_integer, mpi_max, localcomm, ierror )
1538      !
[681]1539      ktab(:) = iwork(:)
[1344]1540      !
[681]1541   END SUBROUTINE mppmax_a_int
1542
1543
[869]1544   SUBROUTINE mppmax_int( ktab, kcom )
[681]1545      !!----------------------------------------------------------------------
1546      !!                  ***  routine mppmax_int  ***
1547      !!
[1344]1548      !! ** Purpose :   Find maximum value in an integer layout array
[681]1549      !!
1550      !!----------------------------------------------------------------------
[1344]1551      INTEGER, INTENT(inout)           ::   ktab      ! ???
1552      INTEGER, INTENT(in   ), OPTIONAL ::   kcom      ! ???
[3764]1553      !!
[1344]1554      INTEGER ::   ierror, iwork, localcomm   ! temporary integer
1555      !!----------------------------------------------------------------------
1556      !
[3764]1557      localcomm = mpi_comm_opa
[1344]1558      IF( PRESENT(kcom) )   localcomm = kcom
1559      !
1560      CALL mpi_allreduce( ktab, iwork, 1, mpi_integer, mpi_max, localcomm, ierror)
1561      !
[681]1562      ktab = iwork
[1344]1563      !
[681]1564   END SUBROUTINE mppmax_int
1565
1566
[869]1567   SUBROUTINE mppmin_a_int( ktab, kdim, kcom )
[51]1568      !!----------------------------------------------------------------------
1569      !!                  ***  routine mppmin_a_int  ***
[3764]1570      !!
[51]1571      !! ** Purpose :   Find minimum value in an integer layout array
1572      !!
1573      !!----------------------------------------------------------------------
1574      INTEGER , INTENT( in  )                  ::   kdim        ! size of array
1575      INTEGER , INTENT(inout), DIMENSION(kdim) ::   ktab        ! input array
[888]1576      INTEGER , INTENT( in  ), OPTIONAL        ::   kcom        ! input array
[1344]1577      !!
1578      INTEGER ::   ierror, localcomm   ! temporary integer
[51]1579      INTEGER, DIMENSION(kdim) ::   iwork
[1344]1580      !!----------------------------------------------------------------------
1581      !
[869]1582      localcomm = mpi_comm_opa
[1344]1583      IF( PRESENT(kcom) )   localcomm = kcom
1584      !
1585      CALL mpi_allreduce( ktab, iwork, kdim, mpi_integer, mpi_min, localcomm, ierror )
1586      !
[51]1587      ktab(:) = iwork(:)
[1344]1588      !
[51]1589   END SUBROUTINE mppmin_a_int
[3]1590
[13]1591
[1345]1592   SUBROUTINE mppmin_int( ktab, kcom )
[51]1593      !!----------------------------------------------------------------------
1594      !!                  ***  routine mppmin_int  ***
1595      !!
[1344]1596      !! ** Purpose :   Find minimum value in an integer layout array
[51]1597      !!
1598      !!----------------------------------------------------------------------
1599      INTEGER, INTENT(inout) ::   ktab      ! ???
[1345]1600      INTEGER , INTENT( in  ), OPTIONAL        ::   kcom        ! input array
[1344]1601      !!
[1345]1602      INTEGER ::  ierror, iwork, localcomm
[1344]1603      !!----------------------------------------------------------------------
1604      !
[1345]1605      localcomm = mpi_comm_opa
1606      IF( PRESENT(kcom) )   localcomm = kcom
[1344]1607      !
[1345]1608     CALL mpi_allreduce( ktab, iwork, 1, mpi_integer, mpi_min, localcomm, ierror )
1609      !
[51]1610      ktab = iwork
[1344]1611      !
[51]1612   END SUBROUTINE mppmin_int
[3]1613
[13]1614
[51]1615   SUBROUTINE mppsum_a_int( ktab, kdim )
1616      !!----------------------------------------------------------------------
1617      !!                  ***  routine mppsum_a_int  ***
[3764]1618      !!
[1344]1619      !! ** Purpose :   Global integer sum, 1D array case
[51]1620      !!
1621      !!----------------------------------------------------------------------
[1344]1622      INTEGER, INTENT(in   )                   ::   kdim      ! ???
[51]1623      INTEGER, INTENT(inout), DIMENSION (kdim) ::   ktab      ! ???
[1344]1624      !!
[51]1625      INTEGER :: ierror
1626      INTEGER, DIMENSION (kdim) ::  iwork
[1344]1627      !!----------------------------------------------------------------------
1628      !
1629      CALL mpi_allreduce( ktab, iwork, kdim, mpi_integer, mpi_sum, mpi_comm_opa, ierror )
1630      !
[51]1631      ktab(:) = iwork(:)
[1344]1632      !
[51]1633   END SUBROUTINE mppsum_a_int
[3]1634
[13]1635
[1344]1636   SUBROUTINE mppsum_int( ktab )
1637      !!----------------------------------------------------------------------
1638      !!                 ***  routine mppsum_int  ***
[3764]1639      !!
[1344]1640      !! ** Purpose :   Global integer sum
1641      !!
1642      !!----------------------------------------------------------------------
1643      INTEGER, INTENT(inout) ::   ktab
[3764]1644      !!
[1344]1645      INTEGER :: ierror, iwork
1646      !!----------------------------------------------------------------------
1647      !
1648      CALL mpi_allreduce( ktab, iwork, 1, mpi_integer, mpi_sum, mpi_comm_opa, ierror )
1649      !
1650      ktab = iwork
1651      !
1652   END SUBROUTINE mppsum_int
[3]1653
[13]1654
[1344]1655   SUBROUTINE mppmax_a_real( ptab, kdim, kcom )
1656      !!----------------------------------------------------------------------
1657      !!                 ***  routine mppmax_a_real  ***
[3764]1658      !!
[1344]1659      !! ** Purpose :   Maximum
1660      !!
1661      !!----------------------------------------------------------------------
1662      INTEGER , INTENT(in   )                  ::   kdim
1663      REAL(wp), INTENT(inout), DIMENSION(kdim) ::   ptab
1664      INTEGER , INTENT(in   ), OPTIONAL        ::   kcom
1665      !!
1666      INTEGER :: ierror, localcomm
1667      REAL(wp), DIMENSION(kdim) ::  zwork
1668      !!----------------------------------------------------------------------
1669      !
1670      localcomm = mpi_comm_opa
1671      IF( PRESENT(kcom) ) localcomm = kcom
1672      !
1673      CALL mpi_allreduce( ptab, zwork, kdim, mpi_double_precision, mpi_max, localcomm, ierror )
1674      ptab(:) = zwork(:)
1675      !
1676   END SUBROUTINE mppmax_a_real
[3]1677
1678
[1344]1679   SUBROUTINE mppmax_real( ptab, kcom )
1680      !!----------------------------------------------------------------------
1681      !!                  ***  routine mppmax_real  ***
[3764]1682      !!
[1344]1683      !! ** Purpose :   Maximum
1684      !!
1685      !!----------------------------------------------------------------------
1686      REAL(wp), INTENT(inout)           ::   ptab   ! ???
1687      INTEGER , INTENT(in   ), OPTIONAL ::   kcom   ! ???
1688      !!
1689      INTEGER  ::   ierror, localcomm
1690      REAL(wp) ::   zwork
1691      !!----------------------------------------------------------------------
1692      !
[3764]1693      localcomm = mpi_comm_opa
[1344]1694      IF( PRESENT(kcom) )   localcomm = kcom
1695      !
1696      CALL mpi_allreduce( ptab, zwork, 1, mpi_double_precision, mpi_max, localcomm, ierror )
1697      ptab = zwork
1698      !
1699   END SUBROUTINE mppmax_real
[13]1700
[6476]1701   SUBROUTINE mppmax_real_multiple( ptab, NUM , kcom  )
1702      !!----------------------------------------------------------------------
1703      !!                  ***  routine mppmax_real  ***
1704      !!
1705      !! ** Purpose :   Maximum
1706      !!
1707      !!----------------------------------------------------------------------
1708      REAL(wp), DIMENSION(:) ,  INTENT(inout)           ::   ptab   ! ???
1709      INTEGER , INTENT(in   )           ::   NUM
1710      INTEGER , INTENT(in   ), OPTIONAL ::   kcom   ! ???
1711      !!
1712      INTEGER  ::   ierror, localcomm
1713      REAL(wp) , POINTER , DIMENSION(:) ::   zwork
1714      !!----------------------------------------------------------------------
1715      !
1716      CALL wrk_alloc(NUM , zwork)
1717      localcomm = mpi_comm_opa
1718      IF( PRESENT(kcom) )   localcomm = kcom
1719      !
1720      CALL mpi_allreduce( ptab, zwork, NUM, mpi_double_precision, mpi_max, localcomm, ierror )
1721      ptab = zwork
1722      CALL wrk_dealloc(NUM , zwork)
1723      !
1724   END SUBROUTINE mppmax_real_multiple
[3]1725
[6476]1726
[1344]1727   SUBROUTINE mppmin_a_real( ptab, kdim, kcom )
1728      !!----------------------------------------------------------------------
1729      !!                 ***  routine mppmin_a_real  ***
[3764]1730      !!
[1344]1731      !! ** Purpose :   Minimum of REAL, array case
1732      !!
1733      !!-----------------------------------------------------------------------
1734      INTEGER , INTENT(in   )                  ::   kdim
1735      REAL(wp), INTENT(inout), DIMENSION(kdim) ::   ptab
1736      INTEGER , INTENT(in   ), OPTIONAL        ::   kcom
1737      !!
1738      INTEGER :: ierror, localcomm
1739      REAL(wp), DIMENSION(kdim) ::   zwork
1740      !!-----------------------------------------------------------------------
1741      !
[3764]1742      localcomm = mpi_comm_opa
[1344]1743      IF( PRESENT(kcom) ) localcomm = kcom
1744      !
1745      CALL mpi_allreduce( ptab, zwork, kdim, mpi_double_precision, mpi_min, localcomm, ierror )
1746      ptab(:) = zwork(:)
1747      !
1748   END SUBROUTINE mppmin_a_real
[3]1749
1750
[1344]1751   SUBROUTINE mppmin_real( ptab, kcom )
1752      !!----------------------------------------------------------------------
1753      !!                  ***  routine mppmin_real  ***
[3764]1754      !!
[1344]1755      !! ** Purpose :   minimum of REAL, scalar case
1756      !!
1757      !!-----------------------------------------------------------------------
[3764]1758      REAL(wp), INTENT(inout)           ::   ptab        !
[1344]1759      INTEGER , INTENT(in   ), OPTIONAL :: kcom
1760      !!
1761      INTEGER  ::   ierror
1762      REAL(wp) ::   zwork
1763      INTEGER :: localcomm
1764      !!-----------------------------------------------------------------------
1765      !
[3764]1766      localcomm = mpi_comm_opa
[1344]1767      IF( PRESENT(kcom) )   localcomm = kcom
1768      !
1769      CALL mpi_allreduce( ptab, zwork, 1, mpi_double_precision, mpi_min, localcomm, ierror )
1770      ptab = zwork
1771      !
1772   END SUBROUTINE mppmin_real
[13]1773
[3]1774
[1344]1775   SUBROUTINE mppsum_a_real( ptab, kdim, kcom )
1776      !!----------------------------------------------------------------------
1777      !!                  ***  routine mppsum_a_real  ***
[3764]1778      !!
[1344]1779      !! ** Purpose :   global sum, REAL ARRAY argument case
1780      !!
1781      !!-----------------------------------------------------------------------
1782      INTEGER , INTENT( in )                     ::   kdim      ! size of ptab
1783      REAL(wp), DIMENSION(kdim), INTENT( inout ) ::   ptab      ! input array
1784      INTEGER , INTENT( in ), OPTIONAL           :: kcom
1785      !!
1786      INTEGER                   ::   ierror    ! temporary integer
[3764]1787      INTEGER                   ::   localcomm
1788      REAL(wp), DIMENSION(kdim) ::   zwork     ! temporary workspace
[1344]1789      !!-----------------------------------------------------------------------
1790      !
[3764]1791      localcomm = mpi_comm_opa
[1344]1792      IF( PRESENT(kcom) )   localcomm = kcom
1793      !
1794      CALL mpi_allreduce( ptab, zwork, kdim, mpi_double_precision, mpi_sum, localcomm, ierror )
1795      ptab(:) = zwork(:)
1796      !
1797   END SUBROUTINE mppsum_a_real
[869]1798
[3]1799
[1344]1800   SUBROUTINE mppsum_real( ptab, kcom )
1801      !!----------------------------------------------------------------------
1802      !!                  ***  routine mppsum_real  ***
[3764]1803      !!
[1344]1804      !! ** Purpose :   global sum, SCALAR argument case
1805      !!
1806      !!-----------------------------------------------------------------------
1807      REAL(wp), INTENT(inout)           ::   ptab   ! input scalar
1808      INTEGER , INTENT(in   ), OPTIONAL ::   kcom
1809      !!
[3764]1810      INTEGER  ::   ierror, localcomm
[1344]1811      REAL(wp) ::   zwork
1812      !!-----------------------------------------------------------------------
1813      !
[3764]1814      localcomm = mpi_comm_opa
[1344]1815      IF( PRESENT(kcom) ) localcomm = kcom
1816      !
1817      CALL mpi_allreduce( ptab, zwork, 1, mpi_double_precision, mpi_sum, localcomm, ierror )
1818      ptab = zwork
1819      !
1820   END SUBROUTINE mppsum_real
[3]1821
[1976]1822   SUBROUTINE mppsum_realdd( ytab, kcom )
1823      !!----------------------------------------------------------------------
1824      !!                  ***  routine mppsum_realdd ***
1825      !!
1826      !! ** Purpose :   global sum in Massively Parallel Processing
1827      !!                SCALAR argument case for double-double precision
1828      !!
1829      !!-----------------------------------------------------------------------
1830      COMPLEX(wp), INTENT(inout)         :: ytab    ! input scalar
1831      INTEGER , INTENT( in  ), OPTIONAL :: kcom
[3]1832
[1976]1833      !! * Local variables   (MPI version)
1834      INTEGER  ::    ierror
1835      INTEGER  ::   localcomm
1836      COMPLEX(wp) :: zwork
1837
1838      localcomm = mpi_comm_opa
1839      IF( PRESENT(kcom) ) localcomm = kcom
1840
1841      ! reduce local sums into global sum
1842      CALL MPI_ALLREDUCE (ytab, zwork, 1, MPI_DOUBLE_COMPLEX, &
1843                       MPI_SUMDD,localcomm,ierror)
1844      ytab = zwork
1845
1846   END SUBROUTINE mppsum_realdd
[3764]1847
1848
[1976]1849   SUBROUTINE mppsum_a_realdd( ytab, kdim, kcom )
1850      !!----------------------------------------------------------------------
1851      !!                  ***  routine mppsum_a_realdd  ***
1852      !!
1853      !! ** Purpose :   global sum in Massively Parallel Processing
1854      !!                COMPLEX ARRAY case for double-double precision
1855      !!
1856      !!-----------------------------------------------------------------------
1857      INTEGER , INTENT( in )                        ::   kdim      ! size of ytab
1858      COMPLEX(wp), DIMENSION(kdim), INTENT( inout ) ::   ytab      ! input array
1859      INTEGER , INTENT( in  ), OPTIONAL :: kcom
1860
1861      !! * Local variables   (MPI version)
1862      INTEGER                      :: ierror    ! temporary integer
1863      INTEGER                      ::   localcomm
1864      COMPLEX(wp), DIMENSION(kdim) :: zwork     ! temporary workspace
1865
1866      localcomm = mpi_comm_opa
1867      IF( PRESENT(kcom) ) localcomm = kcom
1868
1869      CALL MPI_ALLREDUCE (ytab, zwork, kdim, MPI_DOUBLE_COMPLEX, &
1870                       MPI_SUMDD,localcomm,ierror)
1871      ytab(:) = zwork(:)
1872
1873   END SUBROUTINE mppsum_a_realdd
[3764]1874
[1344]1875   SUBROUTINE mpp_minloc2d( ptab, pmask, pmin, ki,kj )
1876      !!------------------------------------------------------------------------
1877      !!             ***  routine mpp_minloc  ***
1878      !!
1879      !! ** Purpose :   Compute the global minimum of an array ptab
1880      !!              and also give its global position
1881      !!
1882      !! ** Method  :   Use MPI_ALLREDUCE with MPI_MINLOC
1883      !!
1884      !!--------------------------------------------------------------------------
1885      REAL(wp), DIMENSION (jpi,jpj), INTENT(in   ) ::   ptab    ! Local 2D array
1886      REAL(wp), DIMENSION (jpi,jpj), INTENT(in   ) ::   pmask   ! Local mask
1887      REAL(wp)                     , INTENT(  out) ::   pmin    ! Global minimum of ptab
1888      INTEGER                      , INTENT(  out) ::   ki, kj   ! index of minimum in global frame
1889      !!
1890      INTEGER , DIMENSION(2)   ::   ilocs
1891      INTEGER :: ierror
1892      REAL(wp) ::   zmin   ! local minimum
1893      REAL(wp), DIMENSION(2,1) ::   zain, zaout
1894      !!-----------------------------------------------------------------------
1895      !
1896      zmin  = MINVAL( ptab(:,:) , mask= pmask == 1.e0 )
1897      ilocs = MINLOC( ptab(:,:) , mask= pmask == 1.e0 )
1898      !
1899      ki = ilocs(1) + nimpp - 1
1900      kj = ilocs(2) + njmpp - 1
1901      !
1902      zain(1,:)=zmin
1903      zain(2,:)=ki+10000.*kj
1904      !
1905      CALL MPI_ALLREDUCE( zain,zaout, 1, MPI_2DOUBLE_PRECISION,MPI_MINLOC,MPI_COMM_OPA,ierror)
1906      !
1907      pmin = zaout(1,1)
1908      kj = INT(zaout(2,1)/10000.)
1909      ki = INT(zaout(2,1) - 10000.*kj )
1910      !
1911   END SUBROUTINE mpp_minloc2d
[13]1912
[3]1913
[1344]1914   SUBROUTINE mpp_minloc3d( ptab, pmask, pmin, ki, kj ,kk)
1915      !!------------------------------------------------------------------------
1916      !!             ***  routine mpp_minloc  ***
1917      !!
1918      !! ** Purpose :   Compute the global minimum of an array ptab
1919      !!              and also give its global position
1920      !!
1921      !! ** Method  :   Use MPI_ALLREDUCE with MPI_MINLOC
1922      !!
1923      !!--------------------------------------------------------------------------
1924      REAL(wp), DIMENSION (jpi,jpj,jpk), INTENT(in   ) ::   ptab         ! Local 2D array
1925      REAL(wp), DIMENSION (jpi,jpj,jpk), INTENT(in   ) ::   pmask        ! Local mask
1926      REAL(wp)                         , INTENT(  out) ::   pmin         ! Global minimum of ptab
1927      INTEGER                          , INTENT(  out) ::   ki, kj, kk   ! index of minimum in global frame
1928      !!
1929      INTEGER  ::   ierror
1930      REAL(wp) ::   zmin     ! local minimum
1931      INTEGER , DIMENSION(3)   ::   ilocs
1932      REAL(wp), DIMENSION(2,1) ::   zain, zaout
1933      !!-----------------------------------------------------------------------
1934      !
1935      zmin  = MINVAL( ptab(:,:,:) , mask= pmask == 1.e0 )
1936      ilocs = MINLOC( ptab(:,:,:) , mask= pmask == 1.e0 )
1937      !
1938      ki = ilocs(1) + nimpp - 1
1939      kj = ilocs(2) + njmpp - 1
1940      kk = ilocs(3)
1941      !
1942      zain(1,:)=zmin
1943      zain(2,:)=ki+10000.*kj+100000000.*kk
1944      !
1945      CALL MPI_ALLREDUCE( zain,zaout, 1, MPI_2DOUBLE_PRECISION,MPI_MINLOC,MPI_COMM_OPA,ierror)
1946      !
1947      pmin = zaout(1,1)
1948      kk   = INT( zaout(2,1) / 100000000. )
1949      kj   = INT( zaout(2,1) - kk * 100000000. ) / 10000
1950      ki   = INT( zaout(2,1) - kk * 100000000. -kj * 10000. )
1951      !
1952   END SUBROUTINE mpp_minloc3d
[13]1953
[3]1954
[1344]1955   SUBROUTINE mpp_maxloc2d( ptab, pmask, pmax, ki, kj )
1956      !!------------------------------------------------------------------------
1957      !!             ***  routine mpp_maxloc  ***
1958      !!
1959      !! ** Purpose :   Compute the global maximum of an array ptab
1960      !!              and also give its global position
1961      !!
1962      !! ** Method  :   Use MPI_ALLREDUCE with MPI_MINLOC
1963      !!
1964      !!--------------------------------------------------------------------------
1965      REAL(wp), DIMENSION (jpi,jpj), INTENT(in   ) ::   ptab     ! Local 2D array
1966      REAL(wp), DIMENSION (jpi,jpj), INTENT(in   ) ::   pmask    ! Local mask
1967      REAL(wp)                     , INTENT(  out) ::   pmax     ! Global maximum of ptab
1968      INTEGER                      , INTENT(  out) ::   ki, kj   ! index of maximum in global frame
[3764]1969      !!
[1344]1970      INTEGER  :: ierror
1971      INTEGER, DIMENSION (2)   ::   ilocs
1972      REAL(wp) :: zmax   ! local maximum
1973      REAL(wp), DIMENSION(2,1) ::   zain, zaout
1974      !!-----------------------------------------------------------------------
1975      !
1976      zmax  = MAXVAL( ptab(:,:) , mask= pmask == 1.e0 )
1977      ilocs = MAXLOC( ptab(:,:) , mask= pmask == 1.e0 )
1978      !
1979      ki = ilocs(1) + nimpp - 1
1980      kj = ilocs(2) + njmpp - 1
1981      !
1982      zain(1,:) = zmax
1983      zain(2,:) = ki + 10000. * kj
1984      !
1985      CALL MPI_ALLREDUCE( zain,zaout, 1, MPI_2DOUBLE_PRECISION,MPI_MAXLOC,MPI_COMM_OPA,ierror)
1986      !
1987      pmax = zaout(1,1)
1988      kj   = INT( zaout(2,1) / 10000.     )
1989      ki   = INT( zaout(2,1) - 10000.* kj )
1990      !
1991   END SUBROUTINE mpp_maxloc2d
[3]1992
[13]1993
[1344]1994   SUBROUTINE mpp_maxloc3d( ptab, pmask, pmax, ki, kj, kk )
1995      !!------------------------------------------------------------------------
1996      !!             ***  routine mpp_maxloc  ***
1997      !!
1998      !! ** Purpose :  Compute the global maximum of an array ptab
1999      !!              and also give its global position
2000      !!
2001      !! ** Method : Use MPI_ALLREDUCE with MPI_MINLOC
2002      !!
2003      !!--------------------------------------------------------------------------
2004      REAL(wp), DIMENSION (jpi,jpj,jpk), INTENT(in   ) ::   ptab         ! Local 2D array
2005      REAL(wp), DIMENSION (jpi,jpj,jpk), INTENT(in   ) ::   pmask        ! Local mask
2006      REAL(wp)                         , INTENT(  out) ::   pmax         ! Global maximum of ptab
2007      INTEGER                          , INTENT(  out) ::   ki, kj, kk   ! index of maximum in global frame
[3764]2008      !!
[1344]2009      REAL(wp) :: zmax   ! local maximum
2010      REAL(wp), DIMENSION(2,1) ::   zain, zaout
2011      INTEGER , DIMENSION(3)   ::   ilocs
2012      INTEGER :: ierror
2013      !!-----------------------------------------------------------------------
2014      !
2015      zmax  = MAXVAL( ptab(:,:,:) , mask= pmask == 1.e0 )
2016      ilocs = MAXLOC( ptab(:,:,:) , mask= pmask == 1.e0 )
2017      !
2018      ki = ilocs(1) + nimpp - 1
2019      kj = ilocs(2) + njmpp - 1
2020      kk = ilocs(3)
2021      !
2022      zain(1,:)=zmax
2023      zain(2,:)=ki+10000.*kj+100000000.*kk
2024      !
2025      CALL MPI_ALLREDUCE( zain,zaout, 1, MPI_2DOUBLE_PRECISION,MPI_MAXLOC,MPI_COMM_OPA,ierror)
2026      !
2027      pmax = zaout(1,1)
2028      kk   = INT( zaout(2,1) / 100000000. )
2029      kj   = INT( zaout(2,1) - kk * 100000000. ) / 10000
2030      ki   = INT( zaout(2,1) - kk * 100000000. -kj * 10000. )
2031      !
2032   END SUBROUTINE mpp_maxloc3d
[3]2033
[869]2034
[1344]2035   SUBROUTINE mppsync()
2036      !!----------------------------------------------------------------------
2037      !!                  ***  routine mppsync  ***
[3764]2038      !!
[1344]2039      !! ** Purpose :   Massively parallel processors, synchroneous
2040      !!
2041      !!-----------------------------------------------------------------------
2042      INTEGER :: ierror
2043      !!-----------------------------------------------------------------------
2044      !
2045      CALL mpi_barrier( mpi_comm_opa, ierror )
2046      !
2047   END SUBROUTINE mppsync
[3]2048
2049
[1344]2050   SUBROUTINE mppstop
2051      !!----------------------------------------------------------------------
2052      !!                  ***  routine mppstop  ***
[3764]2053      !!
[3294]2054      !! ** purpose :   Stop massively parallel processors method
[1344]2055      !!
2056      !!----------------------------------------------------------------------
2057      INTEGER ::   info
2058      !!----------------------------------------------------------------------
2059      !
2060      CALL mppsync
2061      CALL mpi_finalize( info )
2062      !
2063   END SUBROUTINE mppstop
[3]2064
2065
[1344]2066   SUBROUTINE mpp_comm_free( kcom )
2067      !!----------------------------------------------------------------------
2068      !!----------------------------------------------------------------------
2069      INTEGER, INTENT(in) ::   kcom
2070      !!
2071      INTEGER :: ierr
2072      !!----------------------------------------------------------------------
2073      !
2074      CALL MPI_COMM_FREE(kcom, ierr)
2075      !
2076   END SUBROUTINE mpp_comm_free
[3]2077
[869]2078
[2715]2079   SUBROUTINE mpp_ini_ice( pindic, kumout )
[1344]2080      !!----------------------------------------------------------------------
2081      !!               ***  routine mpp_ini_ice  ***
2082      !!
2083      !! ** Purpose :   Initialize special communicator for ice areas
2084      !!      condition together with global variables needed in the ddmpp folding
2085      !!
2086      !! ** Method  : - Look for ice processors in ice routines
2087      !!              - Put their number in nrank_ice
2088      !!              - Create groups for the world processors and the ice processors
2089      !!              - Create a communicator for ice processors
2090      !!
2091      !! ** output
2092      !!      njmppmax = njmpp for northern procs
2093      !!      ndim_rank_ice = number of processors with ice
2094      !!      nrank_ice (ndim_rank_ice) = ice processors
[3625]2095      !!      ngrp_iworld = group ID for the world processors
[1344]2096      !!      ngrp_ice = group ID for the ice processors
2097      !!      ncomm_ice = communicator for the ice procs.
2098      !!      n_ice_root = number (in the world) of proc 0 in the ice comm.
2099      !!
2100      !!----------------------------------------------------------------------
[2715]2101      INTEGER, INTENT(in) ::   pindic
2102      INTEGER, INTENT(in) ::   kumout   ! ocean.output logical unit
[1344]2103      !!
2104      INTEGER :: jjproc
[2715]2105      INTEGER :: ii, ierr
2106      INTEGER, ALLOCATABLE, DIMENSION(:) ::   kice
2107      INTEGER, ALLOCATABLE, DIMENSION(:) ::   zwork
[1344]2108      !!----------------------------------------------------------------------
2109      !
[2715]2110      ! Since this is just an init routine and these arrays are of length jpnij
2111      ! then don't use wrk_nemo module - just allocate and deallocate.
2112      ALLOCATE( kice(jpnij), zwork(jpnij), STAT=ierr )
2113      IF( ierr /= 0 ) THEN
2114         WRITE(kumout, cform_err)
2115         WRITE(kumout,*) 'mpp_ini_ice : failed to allocate 2, 1D arrays (jpnij in length)'
2116         CALL mppstop
2117      ENDIF
2118
[1344]2119      ! Look for how many procs with sea-ice
2120      !
2121      kice = 0
2122      DO jjproc = 1, jpnij
[3764]2123         IF( jjproc == narea .AND. pindic .GT. 0 )   kice(jjproc) = 1
[1344]2124      END DO
2125      !
2126      zwork = 0
2127      CALL MPI_ALLREDUCE( kice, zwork, jpnij, mpi_integer, mpi_sum, mpi_comm_opa, ierr )
[3764]2128      ndim_rank_ice = SUM( zwork )
[3]2129
[1344]2130      ! Allocate the right size to nrank_north
[1441]2131      IF( ALLOCATED ( nrank_ice ) )   DEALLOCATE( nrank_ice )
[1344]2132      ALLOCATE( nrank_ice(ndim_rank_ice) )
2133      !
[3764]2134      ii = 0
[1344]2135      nrank_ice = 0
2136      DO jjproc = 1, jpnij
2137         IF( zwork(jjproc) == 1) THEN
2138            ii = ii + 1
[3764]2139            nrank_ice(ii) = jjproc -1
[1344]2140         ENDIF
2141      END DO
[1208]2142
[1344]2143      ! Create the world group
[3625]2144      CALL MPI_COMM_GROUP( mpi_comm_opa, ngrp_iworld, ierr )
[869]2145
[1344]2146      ! Create the ice group from the world group
[3625]2147      CALL MPI_GROUP_INCL( ngrp_iworld, ndim_rank_ice, nrank_ice, ngrp_ice, ierr )
[869]2148
[1344]2149      ! Create the ice communicator , ie the pool of procs with sea-ice
2150      CALL MPI_COMM_CREATE( mpi_comm_opa, ngrp_ice, ncomm_ice, ierr )
[869]2151
[1344]2152      ! Find proc number in the world of proc 0 in the north
2153      ! The following line seems to be useless, we just comment & keep it as reminder
[3625]2154      ! CALL MPI_GROUP_TRANSLATE_RANKS(ngrp_ice,1,0,ngrp_iworld,n_ice_root,ierr)
[1344]2155      !
[3625]2156      CALL MPI_GROUP_FREE(ngrp_ice, ierr)
2157      CALL MPI_GROUP_FREE(ngrp_iworld, ierr)
2158
[2715]2159      DEALLOCATE(kice, zwork)
2160      !
[1344]2161   END SUBROUTINE mpp_ini_ice
[869]2162
2163
[2715]2164   SUBROUTINE mpp_ini_znl( kumout )
[1345]2165      !!----------------------------------------------------------------------
2166      !!               ***  routine mpp_ini_znl  ***
2167      !!
2168      !! ** Purpose :   Initialize special communicator for computing zonal sum
2169      !!
2170      !! ** Method  : - Look for processors in the same row
2171      !!              - Put their number in nrank_znl
2172      !!              - Create group for the znl processors
2173      !!              - Create a communicator for znl processors
2174      !!              - Determine if processor should write znl files
2175      !!
2176      !! ** output
2177      !!      ndim_rank_znl = number of processors on the same row
2178      !!      ngrp_znl = group ID for the znl processors
2179      !!      ncomm_znl = communicator for the ice procs.
2180      !!      n_znl_root = number (in the world) of proc 0 in the ice comm.
2181      !!
2182      !!----------------------------------------------------------------------
[2715]2183      INTEGER, INTENT(in) ::   kumout   ! ocean.output logical units
[1345]2184      !
[2715]2185      INTEGER :: jproc      ! dummy loop integer
2186      INTEGER :: ierr, ii   ! local integer
2187      INTEGER, ALLOCATABLE, DIMENSION(:) ::   kwork
2188      !!----------------------------------------------------------------------
[1345]2189      !-$$     WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - ngrp_world     : ', ngrp_world
2190      !-$$     WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - mpi_comm_world : ', mpi_comm_world
2191      !-$$     WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - mpi_comm_opa   : ', mpi_comm_opa
2192      !
[2715]2193      ALLOCATE( kwork(jpnij), STAT=ierr )
2194      IF( ierr /= 0 ) THEN
2195         WRITE(kumout, cform_err)
2196         WRITE(kumout,*) 'mpp_ini_znl : failed to allocate 1D array of length jpnij'
2197         CALL mppstop
2198      ENDIF
2199
2200      IF( jpnj == 1 ) THEN
[1345]2201         ngrp_znl  = ngrp_world
2202         ncomm_znl = mpi_comm_opa
2203      ELSE
2204         !
2205         CALL MPI_ALLGATHER ( njmpp, 1, mpi_integer, kwork, 1, mpi_integer, mpi_comm_opa, ierr )
2206         !-$$        WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - kwork pour njmpp : ', kwork
2207         !-$$        CALL flush(numout)
2208         !
2209         ! Count number of processors on the same row
2210         ndim_rank_znl = 0
2211         DO jproc=1,jpnij
2212            IF ( kwork(jproc) == njmpp ) THEN
2213               ndim_rank_znl = ndim_rank_znl + 1
2214            ENDIF
2215         END DO
2216         !-$$        WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - ndim_rank_znl : ', ndim_rank_znl
2217         !-$$        CALL flush(numout)
2218         ! Allocate the right size to nrank_znl
[1441]2219         IF (ALLOCATED (nrank_znl)) DEALLOCATE(nrank_znl)
[1345]2220         ALLOCATE(nrank_znl(ndim_rank_znl))
[3764]2221         ii = 0
[1345]2222         nrank_znl (:) = 0
2223         DO jproc=1,jpnij
2224            IF ( kwork(jproc) == njmpp) THEN
2225               ii = ii + 1
[3764]2226               nrank_znl(ii) = jproc -1
[1345]2227            ENDIF
2228         END DO
2229         !-$$        WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - nrank_znl : ', nrank_znl
2230         !-$$        CALL flush(numout)
2231
2232         ! Create the opa group
2233         CALL MPI_COMM_GROUP(mpi_comm_opa,ngrp_opa,ierr)
2234         !-$$        WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - ngrp_opa : ', ngrp_opa
2235         !-$$        CALL flush(numout)
2236
2237         ! Create the znl group from the opa group
2238         CALL MPI_GROUP_INCL  ( ngrp_opa, ndim_rank_znl, nrank_znl, ngrp_znl, ierr )
2239         !-$$        WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - ngrp_znl ', ngrp_znl
2240         !-$$        CALL flush(numout)
2241
2242         ! Create the znl communicator from the opa communicator, ie the pool of procs in the same row
2243         CALL MPI_COMM_CREATE ( mpi_comm_opa, ngrp_znl, ncomm_znl, ierr )
2244         !-$$        WRITE (numout,*) 'mpp_ini_znl ', nproc, ' - ncomm_znl ', ncomm_znl
2245         !-$$        CALL flush(numout)
2246         !
2247      END IF
2248
2249      ! Determines if processor if the first (starting from i=1) on the row
[3764]2250      IF ( jpni == 1 ) THEN
[1345]2251         l_znl_root = .TRUE.
2252      ELSE
2253         l_znl_root = .FALSE.
2254         kwork (1) = nimpp
2255         CALL mpp_min ( kwork(1), kcom = ncomm_znl)
2256         IF ( nimpp == kwork(1)) l_znl_root = .TRUE.
2257      END IF
2258
[2715]2259      DEALLOCATE(kwork)
2260
[1345]2261   END SUBROUTINE mpp_ini_znl
2262
2263
[1344]2264   SUBROUTINE mpp_ini_north
2265      !!----------------------------------------------------------------------
2266      !!               ***  routine mpp_ini_north  ***
2267      !!
[3764]2268      !! ** Purpose :   Initialize special communicator for north folding
[1344]2269      !!      condition together with global variables needed in the mpp folding
2270      !!
2271      !! ** Method  : - Look for northern processors
2272      !!              - Put their number in nrank_north
2273      !!              - Create groups for the world processors and the north processors
2274      !!              - Create a communicator for northern processors
2275      !!
2276      !! ** output
2277      !!      njmppmax = njmpp for northern procs
2278      !!      ndim_rank_north = number of processors in the northern line
2279      !!      nrank_north (ndim_rank_north) = number  of the northern procs.
2280      !!      ngrp_world = group ID for the world processors
2281      !!      ngrp_north = group ID for the northern processors
2282      !!      ncomm_north = communicator for the northern procs.
2283      !!      north_root = number (in the world) of proc 0 in the northern comm.
2284      !!
2285      !!----------------------------------------------------------------------
2286      INTEGER ::   ierr
2287      INTEGER ::   jjproc
2288      INTEGER ::   ii, ji
2289      !!----------------------------------------------------------------------
2290      !
2291      njmppmax = MAXVAL( njmppt )
2292      !
2293      ! Look for how many procs on the northern boundary
2294      ndim_rank_north = 0
2295      DO jjproc = 1, jpnij
2296         IF( njmppt(jjproc) == njmppmax )   ndim_rank_north = ndim_rank_north + 1
2297      END DO
2298      !
2299      ! Allocate the right size to nrank_north
[1441]2300      IF (ALLOCATED (nrank_north)) DEALLOCATE(nrank_north)
[1344]2301      ALLOCATE( nrank_north(ndim_rank_north) )
[869]2302
[1344]2303      ! Fill the nrank_north array with proc. number of northern procs.
2304      ! Note : the rank start at 0 in MPI
2305      ii = 0
2306      DO ji = 1, jpnij
2307         IF ( njmppt(ji) == njmppmax   ) THEN
2308            ii=ii+1
2309            nrank_north(ii)=ji-1
2310         END IF
2311      END DO
2312      !
2313      ! create the world group
2314      CALL MPI_COMM_GROUP( mpi_comm_opa, ngrp_world, ierr )
2315      !
2316      ! Create the North group from the world group
2317      CALL MPI_GROUP_INCL( ngrp_world, ndim_rank_north, nrank_north, ngrp_north, ierr )
2318      !
2319      ! Create the North communicator , ie the pool of procs in the north group
2320      CALL MPI_COMM_CREATE( mpi_comm_opa, ngrp_north, ncomm_north, ierr )
2321      !
2322   END SUBROUTINE mpp_ini_north
[869]2323
2324
[1344]2325   SUBROUTINE mpp_lbc_north_3d( pt3d, cd_type, psgn )
[51]2326      !!---------------------------------------------------------------------
2327      !!                   ***  routine mpp_lbc_north_3d  ***
2328      !!
[3764]2329      !! ** Purpose :   Ensure proper north fold horizontal bondary condition
[1344]2330      !!              in mpp configuration in case of jpn1 > 1
[51]2331      !!
[1344]2332      !! ** Method  :   North fold condition and mpp with more than one proc
[3764]2333      !!              in i-direction require a specific treatment. We gather
[1344]2334      !!              the 4 northern lines of the global domain on 1 processor
2335      !!              and apply lbc north-fold on this sub array. Then we
2336      !!              scatter the north fold array back to the processors.
[51]2337      !!
2338      !!----------------------------------------------------------------------
[1344]2339      REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(inout) ::   pt3d      ! 3D array on which the b.c. is applied
2340      CHARACTER(len=1)                , INTENT(in   ) ::   cd_type   ! nature of pt3d grid-points
2341      !                                                              !   = T ,  U , V , F or W  gridpoints
[4230]2342      REAL(wp)                        , INTENT(in   ) ::   psgn      ! = -1. the sign change across the north fold
[1344]2343      !!                                                             ! =  1. , the sign is kept
[4230]2344      INTEGER ::   ji, jj, jr, jk
[1344]2345      INTEGER ::   ierr, itaille, ildi, ilei, iilb
2346      INTEGER ::   ijpj, ijpjm1, ij, iproc
[4230]2347      INTEGER, DIMENSION (jpmaxngh)          ::   ml_req_nf          !for mpi_isend when avoiding mpi_allgather
[3294]2348      INTEGER                                ::   ml_err             ! for mpi_isend when avoiding mpi_allgather
2349      INTEGER, DIMENSION(MPI_STATUS_SIZE)    ::   ml_stat            ! for mpi_isend when avoiding mpi_allgather
[4152]2350      !                                                              ! Workspace for message transfers avoiding mpi_allgather
2351      REAL(wp), DIMENSION(:,:,:)  , ALLOCATABLE   :: ztab
2352      REAL(wp), DIMENSION(:,:,:)  , ALLOCATABLE   :: znorthloc, zfoldwk     
2353      REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE   :: znorthgloio
[4230]2354      REAL(wp), DIMENSION(:,:,:)  , ALLOCATABLE   :: ztabl, ztabr
[4152]2355
[4230]2356      INTEGER :: istatus(mpi_status_size)
2357      INTEGER :: iflag
[51]2358      !!----------------------------------------------------------------------
[3764]2359      !
[4230]2360      ALLOCATE( ztab(jpiglo,4,jpk) , znorthloc(jpi,4,jpk), zfoldwk(jpi,4,jpk), znorthgloio(jpi,4,jpk,jpni) )
2361      ALLOCATE( ztabl(jpi,4,jpk), ztabr(jpi*jpmaxngh, 4, jpk) ) 
[4152]2362
[1344]2363      ijpj   = 4
2364      ijpjm1 = 3
2365      !
[4671]2366      znorthloc(:,:,:) = 0
[4230]2367      DO jk = 1, jpk
2368         DO jj = nlcj - ijpj +1, nlcj          ! put in xnorthloc the last 4 jlines of pt3d
2369            ij = jj - nlcj + ijpj
2370            znorthloc(:,ij,jk) = pt3d(:,jj,jk)
2371         END DO
[1344]2372      END DO
2373      !
[4152]2374      !                                     ! Build in procs of ncomm_north the znorthgloio
[1344]2375      itaille = jpi * jpk * ijpj
[4230]2376
[3294]2377      IF ( l_north_nogather ) THEN
2378         !
[4230]2379        ztabr(:,:,:) = 0
[4671]2380        ztabl(:,:,:) = 0
2381
[4230]2382        DO jk = 1, jpk
2383           DO jj = nlcj-ijpj+1, nlcj          ! First put local values into the global array
2384              ij = jj - nlcj + ijpj
[4671]2385              DO ji = nfsloop, nfeloop
[4230]2386                 ztabl(ji,ij,jk) = pt3d(ji,jj,jk)
2387              END DO
2388           END DO
2389        END DO
2390
2391         DO jr = 1,nsndto
[4671]2392            IF ((nfipproc(isendto(jr),jpnj) .ne. (narea-1)) .and. (nfipproc(isendto(jr),jpnj) .ne. -1)) THEN
2393              CALL mppsend( 5, znorthloc, itaille, nfipproc(isendto(jr),jpnj), ml_req_nf(jr) )
2394            ENDIF
[4230]2395         END DO
2396         DO jr = 1,nsndto
[4671]2397            iproc = nfipproc(isendto(jr),jpnj)
2398            IF(iproc .ne. -1) THEN
2399               ilei = nleit (iproc+1)
2400               ildi = nldit (iproc+1)
2401               iilb = nfiimpp(isendto(jr),jpnj) - nfiimpp(isendto(1),jpnj)
2402            ENDIF
2403            IF((iproc .ne. (narea-1)) .and. (iproc .ne. -1)) THEN
2404              CALL mpprecv(5, zfoldwk, itaille, iproc)
[4230]2405              DO jk = 1, jpk
2406                 DO jj = 1, ijpj
[4671]2407                    DO ji = ildi, ilei
[4230]2408                       ztabr(iilb+ji,jj,jk) = zfoldwk(ji,jj,jk)
2409                    END DO
2410                 END DO
2411              END DO
[4671]2412           ELSE IF (iproc .eq. (narea-1)) THEN
[4230]2413              DO jk = 1, jpk
2414                 DO jj = 1, ijpj
[4671]2415                    DO ji = ildi, ilei
[4230]2416                       ztabr(iilb+ji,jj,jk) = pt3d(ji,nlcj-ijpj+jj,jk)
2417                    END DO
2418                 END DO
2419              END DO
2420           ENDIF
2421         END DO
2422         IF (l_isend) THEN
2423            DO jr = 1,nsndto
[4765]2424               IF ((nfipproc(isendto(jr),jpnj) .ne. (narea-1)) .and. (nfipproc(isendto(jr),jpnj) .ne. -1)) THEN
2425                  CALL mpi_wait(ml_req_nf(jr), ml_stat, ml_err)
2426               ENDIF   
[4230]2427            END DO
2428         ENDIF
[4232]2429         CALL mpp_lbc_nfd( ztabl, ztabr, cd_type, psgn )   ! North fold boundary condition
[4230]2430         DO jk = 1, jpk
2431            DO jj = nlcj-ijpj+1, nlcj             ! Scatter back to pt3d
2432               ij = jj - nlcj + ijpj
2433               DO ji= 1, nlci
2434                  pt3d(ji,jj,jk) = ztabl(ji,ij,jk)
2435               END DO
[1344]2436            END DO
2437         END DO
[3294]2438         !
2439
[4230]2440      ELSE
[4152]2441         CALL MPI_ALLGATHER( znorthloc  , itaille, MPI_DOUBLE_PRECISION,                &
2442            &                znorthgloio, itaille, MPI_DOUBLE_PRECISION, ncomm_north, ierr )
[3294]2443         !
[4230]2444         ztab(:,:,:) = 0.e0
[3294]2445         DO jr = 1, ndim_rank_north         ! recover the global north array
2446            iproc = nrank_north(jr) + 1
2447            ildi  = nldit (iproc)
2448            ilei  = nleit (iproc)
2449            iilb  = nimppt(iproc)
[4230]2450            DO jk = 1, jpk
2451               DO jj = 1, ijpj
2452                  DO ji = ildi, ilei
2453                    ztab(ji+iilb-1,jj,jk) = znorthgloio(ji,jj,jk,jr)
2454                  END DO
[3294]2455               END DO
2456            END DO
2457         END DO
[4230]2458         CALL lbc_nfd( ztab, cd_type, psgn )   ! North fold boundary condition
2459         !
2460         DO jk = 1, jpk
2461            DO jj = nlcj-ijpj+1, nlcj             ! Scatter back to pt3d
2462               ij = jj - nlcj + ijpj
2463               DO ji= 1, nlci
2464                  pt3d(ji,jj,jk) = ztab(ji+nimpp-1,ij,jk)
2465               END DO
2466            END DO
2467         END DO
2468         !
[3294]2469      ENDIF
[1344]2470      !
[4152]2471      ! The ztab array has been either:
[3294]2472      !  a. Fully populated by the mpi_allgather operation or
[3764]2473      !  b. Had the active points for this domain and northern neighbours populated
[3294]2474      !     by peer to peer exchanges
[3764]2475      ! Either way the array may be folded by lbc_nfd and the result for the span of
[3294]2476      ! this domain will be identical.
2477      !
[4152]2478      DEALLOCATE( ztab, znorthloc, zfoldwk, znorthgloio )
[4230]2479      DEALLOCATE( ztabl, ztabr ) 
[4152]2480      !
[1344]2481   END SUBROUTINE mpp_lbc_north_3d
[3]2482
2483
[1344]2484   SUBROUTINE mpp_lbc_north_2d( pt2d, cd_type, psgn)
2485      !!---------------------------------------------------------------------
2486      !!                   ***  routine mpp_lbc_north_2d  ***
2487      !!
[3764]2488      !! ** Purpose :   Ensure proper north fold horizontal bondary condition
[1344]2489      !!              in mpp configuration in case of jpn1 > 1 (for 2d array )
2490      !!
2491      !! ** Method  :   North fold condition and mpp with more than one proc
[3764]2492      !!              in i-direction require a specific treatment. We gather
[1344]2493      !!              the 4 northern lines of the global domain on 1 processor
2494      !!              and apply lbc north-fold on this sub array. Then we
2495      !!              scatter the north fold array back to the processors.
2496      !!
2497      !!----------------------------------------------------------------------
[4230]2498      REAL(wp), DIMENSION(jpi,jpj), INTENT(inout) ::   pt2d      ! 2D array on which the b.c. is applied
2499      CHARACTER(len=1)            , INTENT(in   ) ::   cd_type   ! nature of pt2d grid-points
[1344]2500      !                                                          !   = T ,  U , V , F or W  gridpoints
[4230]2501      REAL(wp)                    , INTENT(in   ) ::   psgn      ! = -1. the sign change across the north fold
[1344]2502      !!                                                             ! =  1. , the sign is kept
2503      INTEGER ::   ji, jj, jr
2504      INTEGER ::   ierr, itaille, ildi, ilei, iilb
2505      INTEGER ::   ijpj, ijpjm1, ij, iproc
[4230]2506      INTEGER, DIMENSION (jpmaxngh)      ::   ml_req_nf          !for mpi_isend when avoiding mpi_allgather
[3294]2507      INTEGER                            ::   ml_err             ! for mpi_isend when avoiding mpi_allgather
2508      INTEGER, DIMENSION(MPI_STATUS_SIZE)::   ml_stat            ! for mpi_isend when avoiding mpi_allgather
[4152]2509      !                                                              ! Workspace for message transfers avoiding mpi_allgather
2510      REAL(wp), DIMENSION(:,:)  , ALLOCATABLE   :: ztab
2511      REAL(wp), DIMENSION(:,:)  , ALLOCATABLE   :: znorthloc, zfoldwk     
2512      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE   :: znorthgloio
[4230]2513      REAL(wp), DIMENSION(:,:)  , ALLOCATABLE   :: ztabl, ztabr
2514      INTEGER :: istatus(mpi_status_size)
2515      INTEGER :: iflag
[1344]2516      !!----------------------------------------------------------------------
2517      !
[4152]2518      ALLOCATE( ztab(jpiglo,4), znorthloc(jpi,4), zfoldwk(jpi,4), znorthgloio(jpi,4,jpni) )
[4230]2519      ALLOCATE( ztabl(jpi,4), ztabr(jpi*jpmaxngh, 4) ) 
[4152]2520      !
[1344]2521      ijpj   = 4
2522      ijpjm1 = 3
2523      !
[4152]2524      DO jj = nlcj-ijpj+1, nlcj             ! put in znorthloc the last 4 jlines of pt2d
[1344]2525         ij = jj - nlcj + ijpj
[4152]2526         znorthloc(:,ij) = pt2d(:,jj)
[1344]2527      END DO
[3]2528
[4152]2529      !                                     ! Build in procs of ncomm_north the znorthgloio
[1344]2530      itaille = jpi * ijpj
[3294]2531      IF ( l_north_nogather ) THEN
2532         !
[4230]2533         ! Avoid the use of mpi_allgather by exchanging only with the processes already identified
[3294]2534         ! (in nemo_northcomms) as being  involved in this process' northern boundary exchange
2535         !
[4230]2536         ztabr(:,:) = 0
[4671]2537         ztabl(:,:) = 0
2538
[3294]2539         DO jj = nlcj-ijpj+1, nlcj          ! First put local values into the global array
2540            ij = jj - nlcj + ijpj
[4671]2541              DO ji = nfsloop, nfeloop
[4230]2542               ztabl(ji,ij) = pt2d(ji,jj)
[13]2543            END DO
2544         END DO
[3294]2545
[4230]2546         DO jr = 1,nsndto
[4671]2547            IF ((nfipproc(isendto(jr),jpnj) .ne. (narea-1)) .and. (nfipproc(isendto(jr),jpnj) .ne. -1)) THEN
2548               CALL mppsend(5, znorthloc, itaille, nfipproc(isendto(jr),jpnj), ml_req_nf(jr))
2549            ENDIF
[4230]2550         END DO
2551         DO jr = 1,nsndto
[4671]2552            iproc = nfipproc(isendto(jr),jpnj)
2553            IF(iproc .ne. -1) THEN
2554               ilei = nleit (iproc+1)
2555               ildi = nldit (iproc+1)
2556               iilb = nfiimpp(isendto(jr),jpnj) - nfiimpp(isendto(1),jpnj)
2557            ENDIF
2558            IF((iproc .ne. (narea-1)) .and. (iproc .ne. -1)) THEN
2559              CALL mpprecv(5, zfoldwk, itaille, iproc)
[4230]2560              DO jj = 1, ijpj
[4671]2561                 DO ji = ildi, ilei
[4230]2562                    ztabr(iilb+ji,jj) = zfoldwk(ji,jj)
2563                 END DO
2564              END DO
[4671]2565            ELSE IF (iproc .eq. (narea-1)) THEN
[4230]2566              DO jj = 1, ijpj
[4671]2567                 DO ji = ildi, ilei
[4230]2568                    ztabr(iilb+ji,jj) = pt2d(ji,nlcj-ijpj+jj)
2569                 END DO
2570              END DO
2571            ENDIF
2572         END DO
2573         IF (l_isend) THEN
2574            DO jr = 1,nsndto
[4671]2575               IF ((nfipproc(isendto(jr),jpnj) .ne. (narea-1)) .and. (nfipproc(isendto(jr),jpnj) .ne. -1)) THEN
2576                  CALL mpi_wait(ml_req_nf(jr), ml_stat, ml_err)
2577               ENDIF
[4230]2578            END DO
2579         ENDIF
2580         CALL mpp_lbc_nfd( ztabl, ztabr, cd_type, psgn )   ! North fold boundary condition
[3294]2581         !
[4230]2582         DO jj = nlcj-ijpj+1, nlcj             ! Scatter back to pt2d
2583            ij = jj - nlcj + ijpj
2584            DO ji = 1, nlci
2585               pt2d(ji,jj) = ztabl(ji,ij)
2586            END DO
2587         END DO
[3294]2588         !
[4230]2589      ELSE
[4152]2590         CALL MPI_ALLGATHER( znorthloc  , itaille, MPI_DOUBLE_PRECISION,        &
2591            &                znorthgloio, itaille, MPI_DOUBLE_PRECISION, ncomm_north, ierr )
[3294]2592         !
[4230]2593         ztab(:,:) = 0.e0
[3294]2594         DO jr = 1, ndim_rank_north            ! recover the global north array
2595            iproc = nrank_north(jr) + 1
2596            ildi = nldit (iproc)
2597            ilei = nleit (iproc)
2598            iilb = nimppt(iproc)
2599            DO jj = 1, ijpj
2600               DO ji = ildi, ilei
[4152]2601                  ztab(ji+iilb-1,jj) = znorthgloio(ji,jj,jr)
[3294]2602               END DO
2603            END DO
2604         END DO
[4230]2605         CALL lbc_nfd( ztab, cd_type, psgn )   ! North fold boundary condition
2606         !
2607         DO jj = nlcj-ijpj+1, nlcj             ! Scatter back to pt2d
2608            ij = jj - nlcj + ijpj
2609            DO ji = 1, nlci
2610               pt2d(ji,jj) = ztab(ji+nimpp-1,ij)
2611            END DO
2612         END DO
2613         !
[3294]2614      ENDIF
[4152]2615      DEALLOCATE( ztab, znorthloc, zfoldwk, znorthgloio )
[4230]2616      DEALLOCATE( ztabl, ztabr ) 
[4152]2617      !
[13]2618   END SUBROUTINE mpp_lbc_north_2d
[3]2619
[6476]2620   SUBROUTINE mpp_lbc_north_2d_multiple( pt2d_array, cd_type, psgn, num_fields)
2621      !!---------------------------------------------------------------------
2622      !!                   ***  routine mpp_lbc_north_2d  ***
2623      !!
2624      !! ** Purpose :   Ensure proper north fold horizontal bondary condition
2625      !!              in mpp configuration in case of jpn1 > 1
2626      !!              (for multiple 2d arrays )
2627      !!
2628      !! ** Method  :   North fold condition and mpp with more than one proc
2629      !!              in i-direction require a specific treatment. We gather
2630      !!              the 4 northern lines of the global domain on 1 processor
2631      !!              and apply lbc north-fold on this sub array. Then we
2632      !!              scatter the north fold array back to the processors.
2633      !!
2634      !!----------------------------------------------------------------------
2635      INTEGER ,  INTENT (in   ) ::   num_fields  ! number of variables contained in pt2d
2636      TYPE( arrayptr ), DIMENSION(:) :: pt2d_array
2637      CHARACTER(len=1), DIMENSION(:), INTENT(in   ) ::   cd_type   ! nature of pt2d grid-points
2638      !                                                          !   = T ,  U , V , F or W  gridpoints
2639      REAL(wp), DIMENSION(:), INTENT(in   ) ::   psgn      ! = -1. the sign change across the north fold
2640      !!                                                             ! =  1. , the sign is kept
2641      INTEGER ::   ji, jj, jr, jk
2642      INTEGER ::   ierr, itaille, ildi, ilei, iilb
2643      INTEGER ::   ijpj, ijpjm1, ij, iproc
2644      INTEGER, DIMENSION (jpmaxngh)      ::   ml_req_nf          !for mpi_isend when avoiding mpi_allgather
2645      INTEGER                            ::   ml_err             ! for mpi_isend when avoiding mpi_allgather
2646      INTEGER, DIMENSION(MPI_STATUS_SIZE)::   ml_stat            ! for mpi_isend when avoiding mpi_allgather
2647      !                                                              ! Workspace for message transfers avoiding mpi_allgather
2648      REAL(wp), DIMENSION(:,:,:)  , ALLOCATABLE   :: ztab
2649      REAL(wp), DIMENSION(:,:,:)  , ALLOCATABLE   :: znorthloc, zfoldwk
2650      REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE   :: znorthgloio
2651      REAL(wp), DIMENSION(:,:,:)  , ALLOCATABLE   :: ztabl, ztabr
2652      INTEGER :: istatus(mpi_status_size)
2653      INTEGER :: iflag
2654      !!----------------------------------------------------------------------
2655      !
[6917]2656      ALLOCATE( ztab(jpiglo,4,num_fields), znorthloc(jpi,4,num_fields), zfoldwk(jpi,4,num_fields),   & 
2657            &   znorthgloio(jpi,4,num_fields,jpni) )   ! expanded to 3 dimensions
[6476]2658      ALLOCATE( ztabl(jpi,4,num_fields), ztabr(jpi*jpmaxngh, 4,num_fields) )
2659      !
2660      ijpj   = 4
2661      ijpjm1 = 3
2662      !
2663     
2664      DO jk = 1, num_fields
2665         DO jj = nlcj-ijpj+1, nlcj             ! put in znorthloc the last 4 jlines of pt2d (for every variable)
2666            ij = jj - nlcj + ijpj
2667            znorthloc(:,ij,jk) = pt2d_array(jk)%pt2d(:,jj)
2668         END DO
2669      END DO
2670      !                                     ! Build in procs of ncomm_north the znorthgloio
2671      itaille = jpi * ijpj
2672                                                                 
2673      IF ( l_north_nogather ) THEN
2674         !
2675         ! Avoid the use of mpi_allgather by exchanging only with the processes already identified
2676         ! (in nemo_northcomms) as being  involved in this process' northern boundary exchange
2677         !
2678         ztabr(:,:,:) = 0
2679         ztabl(:,:,:) = 0
[3]2680
[6476]2681         DO jk = 1, num_fields
2682            DO jj = nlcj-ijpj+1, nlcj          ! First put local values into the global array
2683               ij = jj - nlcj + ijpj
2684               DO ji = nfsloop, nfeloop
2685                  ztabl(ji,ij,jk) = pt2d_array(jk)%pt2d(ji,jj)
2686               END DO
2687            END DO
2688         END DO
2689
2690         DO jr = 1,nsndto
2691            IF ((nfipproc(isendto(jr),jpnj) .ne. (narea-1)) .and. (nfipproc(isendto(jr),jpnj) .ne. -1)) THEN
2692               CALL mppsend(5, znorthloc, itaille*num_fields, nfipproc(isendto(jr),jpnj), ml_req_nf(jr)) ! Buffer expanded "num_fields" times
2693            ENDIF
2694         END DO
2695         DO jr = 1,nsndto
2696            iproc = nfipproc(isendto(jr),jpnj)
2697            IF(iproc .ne. -1) THEN
2698               ilei = nleit (iproc+1)
2699               ildi = nldit (iproc+1)
2700               iilb = nfiimpp(isendto(jr),jpnj) - nfiimpp(isendto(1),jpnj)
2701            ENDIF
2702            IF((iproc .ne. (narea-1)) .and. (iproc .ne. -1)) THEN
2703              CALL mpprecv(5, zfoldwk, itaille*num_fields, iproc) ! Buffer expanded "num_fields" times
2704              DO jk = 1 , num_fields
2705                 DO jj = 1, ijpj
2706                    DO ji = ildi, ilei
2707                       ztabr(iilb+ji,jj,jk) = zfoldwk(ji,jj,jk)       ! Modified to 3D
2708                    END DO
2709                 END DO
2710              END DO
2711            ELSE IF (iproc .eq. (narea-1)) THEN
2712              DO jk = 1, num_fields
2713                 DO jj = 1, ijpj
2714                    DO ji = ildi, ilei
2715                          ztabr(iilb+ji,jj,jk) = pt2d_array(jk)%pt2d(ji,nlcj-ijpj+jj)       ! Modified to 3D
2716                    END DO
2717                 END DO
2718              END DO
2719            ENDIF
2720         END DO
2721         IF (l_isend) THEN
2722            DO jr = 1,nsndto
2723               IF ((nfipproc(isendto(jr),jpnj) .ne. (narea-1)) .and. (nfipproc(isendto(jr),jpnj) .ne. -1)) THEN
2724                  CALL mpi_wait(ml_req_nf(jr), ml_stat, ml_err)
2725               ENDIF
2726            END DO
2727         ENDIF
2728         !
2729         DO ji = 1, num_fields     ! Loop to manage 3D variables
2730            CALL mpp_lbc_nfd( ztabl(:,:,ji), ztabr(:,:,ji), cd_type(ji), psgn(ji) )  ! North fold boundary condition
2731         END DO
2732         !
2733         DO jk = 1, num_fields
2734            DO jj = nlcj-ijpj+1, nlcj             ! Scatter back to pt2d
2735               ij = jj - nlcj + ijpj
2736               DO ji = 1, nlci
2737                  pt2d_array(jk)%pt2d(ji,jj) = ztabl(ji,ij,jk)       ! Modified to 3D
2738               END DO
2739            END DO
2740         END DO
2741         
2742         !
2743      ELSE
2744         !
2745         CALL MPI_ALLGATHER( znorthloc  , itaille*num_fields, MPI_DOUBLE_PRECISION,        &
2746            &                znorthgloio, itaille*num_fields, MPI_DOUBLE_PRECISION, ncomm_north, ierr )
2747         !
2748         ztab(:,:,:) = 0.e0
2749         DO jk = 1, num_fields
2750            DO jr = 1, ndim_rank_north            ! recover the global north array
2751               iproc = nrank_north(jr) + 1
2752               ildi = nldit (iproc)
2753               ilei = nleit (iproc)
2754               iilb = nimppt(iproc)
2755               DO jj = 1, ijpj
2756                  DO ji = ildi, ilei
2757                     ztab(ji+iilb-1,jj,jk) = znorthgloio(ji,jj,jk,jr)
2758                  END DO
2759               END DO
2760            END DO
2761         END DO
2762         
2763         DO ji = 1, num_fields
2764            CALL lbc_nfd( ztab(:,:,ji), cd_type(ji), psgn(ji) )   ! North fold boundary condition
2765         END DO
2766         !
2767         DO jk = 1, num_fields
2768            DO jj = nlcj-ijpj+1, nlcj             ! Scatter back to pt2d
2769               ij = jj - nlcj + ijpj
2770               DO ji = 1, nlci
2771                  pt2d_array(jk)%pt2d(ji,jj) = ztab(ji+nimpp-1,ij,jk)
2772               END DO
2773            END DO
2774         END DO
2775         !
2776         !
2777      ENDIF
2778      DEALLOCATE( ztab, znorthloc, zfoldwk, znorthgloio )
2779      DEALLOCATE( ztabl, ztabr )
2780      !
2781   END SUBROUTINE mpp_lbc_north_2d_multiple
2782
[1344]2783   SUBROUTINE mpp_lbc_north_e( pt2d, cd_type, psgn)
2784      !!---------------------------------------------------------------------
2785      !!                   ***  routine mpp_lbc_north_2d  ***
2786      !!
[3764]2787      !! ** Purpose :   Ensure proper north fold horizontal bondary condition
2788      !!              in mpp configuration in case of jpn1 > 1 and for 2d
[1344]2789      !!              array with outer extra halo
2790      !!
2791      !! ** Method  :   North fold condition and mpp with more than one proc
[3764]2792      !!              in i-direction require a specific treatment. We gather
2793      !!              the 4+2*jpr2dj northern lines of the global domain on 1
2794      !!              processor and apply lbc north-fold on this sub array.
[1344]2795      !!              Then we scatter the north fold array back to the processors.
2796      !!
2797      !!----------------------------------------------------------------------
2798      REAL(wp), DIMENSION(1-jpr2di:jpi+jpr2di,1-jpr2dj:jpj+jpr2dj), INTENT(inout) ::   pt2d     ! 2D array with extra halo
2799      CHARACTER(len=1)                                            , INTENT(in   ) ::   cd_type  ! nature of pt3d grid-points
2800      !                                                                                         !   = T ,  U , V , F or W -points
[3764]2801      REAL(wp)                                                    , INTENT(in   ) ::   psgn     ! = -1. the sign change across the
[1344]2802      !!                                                                                        ! north fold, =  1. otherwise
2803      INTEGER ::   ji, jj, jr
2804      INTEGER ::   ierr, itaille, ildi, ilei, iilb
2805      INTEGER ::   ijpj, ij, iproc
[4152]2806      !
2807      REAL(wp), DIMENSION(:,:)  , ALLOCATABLE  ::  ztab_e, znorthloc_e
2808      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE  ::  znorthgloio_e
2809
[1344]2810      !!----------------------------------------------------------------------
2811      !
[4152]2812      ALLOCATE( ztab_e(jpiglo,4+2*jpr2dj), znorthloc_e(jpi,4+2*jpr2dj), znorthgloio_e(jpi,4+2*jpr2dj,jpni) )
2813
2814      !
[1344]2815      ijpj=4
[4152]2816      ztab_e(:,:) = 0.e0
[311]2817
[1344]2818      ij=0
[4152]2819      ! put in znorthloc_e the last 4 jlines of pt2d
[1344]2820      DO jj = nlcj - ijpj + 1 - jpr2dj, nlcj +jpr2dj
2821         ij = ij + 1
2822         DO ji = 1, jpi
[4152]2823            znorthloc_e(ji,ij)=pt2d(ji,jj)
[1344]2824         END DO
2825      END DO
2826      !
2827      itaille = jpi * ( ijpj + 2 * jpr2dj )
[4152]2828      CALL MPI_ALLGATHER( znorthloc_e(1,1)  , itaille, MPI_DOUBLE_PRECISION,    &
2829         &                znorthgloio_e(1,1,1), itaille, MPI_DOUBLE_PRECISION, ncomm_north, ierr )
[1344]2830      !
2831      DO jr = 1, ndim_rank_north            ! recover the global north array
2832         iproc = nrank_north(jr) + 1
2833         ildi = nldit (iproc)
2834         ilei = nleit (iproc)
2835         iilb = nimppt(iproc)
2836         DO jj = 1, ijpj+2*jpr2dj
2837            DO ji = ildi, ilei
[4152]2838               ztab_e(ji+iilb-1,jj) = znorthgloio_e(ji,jj,jr)
[311]2839            END DO
[1344]2840         END DO
2841      END DO
[311]2842
2843
[1344]2844      ! 2. North-Fold boundary conditions
2845      ! ----------------------------------
[4152]2846      CALL lbc_nfd( ztab_e(:,:), cd_type, psgn, pr2dj = jpr2dj )
[311]2847
[1344]2848      ij = jpr2dj
2849      !! Scatter back to pt2d
2850      DO jj = nlcj - ijpj + 1 , nlcj +jpr2dj
[3764]2851      ij  = ij +1
[1344]2852         DO ji= 1, nlci
[4152]2853            pt2d(ji,jj) = ztab_e(ji+nimpp-1,ij)
[311]2854         END DO
2855      END DO
[1344]2856      !
[4152]2857      DEALLOCATE( ztab_e, znorthloc_e, znorthgloio_e )
2858      !
[311]2859   END SUBROUTINE mpp_lbc_north_e
2860
[3680]2861      SUBROUTINE mpp_lnk_bdy_3d( ptab, cd_type, psgn, ib_bdy )
2862      !!----------------------------------------------------------------------
2863      !!                  ***  routine mpp_lnk_bdy_3d  ***
2864      !!
2865      !! ** Purpose :   Message passing management
2866      !!
2867      !! ** Method  :   Use mppsend and mpprecv function for passing BDY boundaries
2868      !!      between processors following neighboring subdomains.
2869      !!            domain parameters
2870      !!                    nlci   : first dimension of the local subdomain
2871      !!                    nlcj   : second dimension of the local subdomain
2872      !!                    nbondi_bdy : mark for "east-west local boundary"
2873      !!                    nbondj_bdy : mark for "north-south local boundary"
2874      !!                    noea   : number for local neighboring processors
2875      !!                    nowe   : number for local neighboring processors
2876      !!                    noso   : number for local neighboring processors
2877      !!                    nono   : number for local neighboring processors
2878      !!
2879      !! ** Action  :   ptab with update value at its periphery
2880      !!
2881      !!----------------------------------------------------------------------
[389]2882
[3680]2883      USE lbcnfd          ! north fold
2884
2885      INCLUDE 'mpif.h'
2886
2887      REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(inout) ::   ptab     ! 3D array on which the boundary condition is applied
2888      CHARACTER(len=1)                , INTENT(in   ) ::   cd_type  ! define the nature of ptab array grid-points
2889      !                                                             ! = T , U , V , F , W points
2890      REAL(wp)                        , INTENT(in   ) ::   psgn     ! =-1 the sign change across the north fold boundary
2891      !                                                             ! =  1. , the sign is kept
2892      INTEGER                         , INTENT(in   ) ::   ib_bdy   ! BDY boundary set
2893      INTEGER  ::   ji, jj, jk, jl             ! dummy loop indices
2894      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
2895      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
2896      REAL(wp) ::   zland
2897      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
[4152]2898      !
2899      REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE ::   zt3ns, zt3sn   ! 3d for north-south & south-north
2900      REAL(wp), DIMENSION(:,:,:,:), ALLOCATABLE ::   zt3ew, zt3we   ! 3d for east-west & west-east
2901
[3680]2902      !!----------------------------------------------------------------------
[4152]2903     
2904      ALLOCATE( zt3ns(jpi,jprecj,jpk,2), zt3sn(jpi,jprecj,jpk,2),   &
2905         &      zt3ew(jpj,jpreci,jpk,2), zt3we(jpj,jpreci,jpk,2)  )
[3680]2906
2907      zland = 0.e0
2908
2909      ! 1. standard boundary treatment
2910      ! ------------------------------
2911     
2912      !                                   ! East-West boundaries
2913      !                                        !* Cyclic east-west
2914
2915      IF( nbondi == 2) THEN
2916        IF (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) THEN
2917          ptab( 1 ,:,:) = ptab(jpim1,:,:)
2918          ptab(jpi,:,:) = ptab(  2  ,:,:)
2919        ELSE
2920          IF( .NOT. cd_type == 'F' )   ptab(     1       :jpreci,:,:) = zland    ! south except F-point
2921          ptab(nlci-jpreci+1:jpi   ,:,:) = zland    ! north
2922        ENDIF
2923      ELSEIF(nbondi == -1) THEN
2924        IF( .NOT. cd_type == 'F' )   ptab(     1       :jpreci,:,:) = zland    ! south except F-point
2925      ELSEIF(nbondi == 1) THEN
2926        ptab(nlci-jpreci+1:jpi   ,:,:) = zland    ! north
2927      ENDIF                                     !* closed
2928
2929      IF (nbondj == 2 .OR. nbondj == -1) THEN
2930        IF( .NOT. cd_type == 'F' )   ptab(:,     1       :jprecj,:) = zland       ! south except F-point
2931      ELSEIF (nbondj == 2 .OR. nbondj == 1) THEN
2932        ptab(:,nlcj-jprecj+1:jpj   ,:) = zland       ! north
2933      ENDIF
2934     
2935      !
2936
2937      ! 2. East and west directions exchange
2938      ! ------------------------------------
2939      ! we play with the neigbours AND the row number because of the periodicity
2940      !
2941      SELECT CASE ( nbondi_bdy(ib_bdy) )      ! Read Dirichlet lateral conditions
2942      CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
2943         iihom = nlci-nreci
2944         DO jl = 1, jpreci
[4152]2945            zt3ew(:,jl,:,1) = ptab(jpreci+jl,:,:)
2946            zt3we(:,jl,:,1) = ptab(iihom +jl,:,:)
[3680]2947         END DO
2948      END SELECT
2949      !
2950      !                           ! Migrations
2951      imigr = jpreci * jpj * jpk
2952      !
2953      SELECT CASE ( nbondi_bdy(ib_bdy) )
2954      CASE ( -1 )
[4152]2955         CALL mppsend( 2, zt3we(1,1,1,1), imigr, noea, ml_req1 )
[3680]2956      CASE ( 0 )
[4152]2957         CALL mppsend( 1, zt3ew(1,1,1,1), imigr, nowe, ml_req1 )
2958         CALL mppsend( 2, zt3we(1,1,1,1), imigr, noea, ml_req2 )
[3680]2959      CASE ( 1 )
[4152]2960         CALL mppsend( 1, zt3ew(1,1,1,1), imigr, nowe, ml_req1 )
[3680]2961      END SELECT
2962      !
2963      SELECT CASE ( nbondi_bdy_b(ib_bdy) )
2964      CASE ( -1 )
[4152]2965         CALL mpprecv( 1, zt3ew(1,1,1,2), imigr, noea )
[3680]2966      CASE ( 0 )
[4152]2967         CALL mpprecv( 1, zt3ew(1,1,1,2), imigr, noea )
2968         CALL mpprecv( 2, zt3we(1,1,1,2), imigr, nowe )
[3680]2969      CASE ( 1 )
[4152]2970         CALL mpprecv( 2, zt3we(1,1,1,2), imigr, nowe )
[3680]2971      END SELECT
2972      !
2973      SELECT CASE ( nbondi_bdy(ib_bdy) )
2974      CASE ( -1 )
2975         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
2976      CASE ( 0 )
2977         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
2978         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
2979      CASE ( 1 )
2980         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
2981      END SELECT
2982      !
2983      !                           ! Write Dirichlet lateral conditions
2984      iihom = nlci-jpreci
2985      !
2986      SELECT CASE ( nbondi_bdy_b(ib_bdy) )
2987      CASE ( -1 )
2988         DO jl = 1, jpreci
[4152]2989            ptab(iihom+jl,:,:) = zt3ew(:,jl,:,2)
[3680]2990         END DO
2991      CASE ( 0 )
2992         DO jl = 1, jpreci
[4152]2993            ptab(jl      ,:,:) = zt3we(:,jl,:,2)
2994            ptab(iihom+jl,:,:) = zt3ew(:,jl,:,2)
[3680]2995         END DO
2996      CASE ( 1 )
2997         DO jl = 1, jpreci
[4152]2998            ptab(jl      ,:,:) = zt3we(:,jl,:,2)
[3680]2999         END DO
3000      END SELECT
3001
3002
3003      ! 3. North and south directions
3004      ! -----------------------------
3005      ! always closed : we play only with the neigbours
3006      !
3007      IF( nbondj_bdy(ib_bdy) /= 2 ) THEN      ! Read Dirichlet lateral conditions
3008         ijhom = nlcj-nrecj
3009         DO jl = 1, jprecj
[4152]3010            zt3sn(:,jl,:,1) = ptab(:,ijhom +jl,:)
3011            zt3ns(:,jl,:,1) = ptab(:,jprecj+jl,:)
[3680]3012         END DO
3013      ENDIF
3014      !
3015      !                           ! Migrations
3016      imigr = jprecj * jpi * jpk
3017      !
3018      SELECT CASE ( nbondj_bdy(ib_bdy) )
3019      CASE ( -1 )
[4152]3020         CALL mppsend( 4, zt3sn(1,1,1,1), imigr, nono, ml_req1 )
[3680]3021      CASE ( 0 )
[4152]3022         CALL mppsend( 3, zt3ns(1,1,1,1), imigr, noso, ml_req1 )
3023         CALL mppsend( 4, zt3sn(1,1,1,1), imigr, nono, ml_req2 )
[3680]3024      CASE ( 1 )
[4152]3025         CALL mppsend( 3, zt3ns(1,1,1,1), imigr, noso, ml_req1 )
[3680]3026      END SELECT
3027      !
3028      SELECT CASE ( nbondj_bdy_b(ib_bdy) )
3029      CASE ( -1 )
[4152]3030         CALL mpprecv( 3, zt3ns(1,1,1,2), imigr, nono )
[3680]3031      CASE ( 0 )
[4152]3032         CALL mpprecv( 3, zt3ns(1,1,1,2), imigr, nono )
3033         CALL mpprecv( 4, zt3sn(1,1,1,2), imigr, noso )
[3680]3034      CASE ( 1 )
[4152]3035         CALL mpprecv( 4, zt3sn(1,1,1,2), imigr, noso )
[3680]3036      END SELECT
3037      !
3038      SELECT CASE ( nbondj_bdy(ib_bdy) )
3039      CASE ( -1 )
3040         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3041      CASE ( 0 )
3042         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3043         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
3044      CASE ( 1 )
3045         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3046      END SELECT
3047      !
3048      !                           ! Write Dirichlet lateral conditions
3049      ijhom = nlcj-jprecj
3050      !
3051      SELECT CASE ( nbondj_bdy_b(ib_bdy) )
3052      CASE ( -1 )
3053         DO jl = 1, jprecj
[4152]3054            ptab(:,ijhom+jl,:) = zt3ns(:,jl,:,2)
[3680]3055         END DO
3056      CASE ( 0 )
3057         DO jl = 1, jprecj
[4152]3058            ptab(:,jl      ,:) = zt3sn(:,jl,:,2)
3059            ptab(:,ijhom+jl,:) = zt3ns(:,jl,:,2)
[3680]3060         END DO
3061      CASE ( 1 )
3062         DO jl = 1, jprecj
[4152]3063            ptab(:,jl,:) = zt3sn(:,jl,:,2)
[3680]3064         END DO
3065      END SELECT
3066
3067
3068      ! 4. north fold treatment
3069      ! -----------------------
3070      !
3071      IF( npolj /= 0) THEN
3072         !
3073         SELECT CASE ( jpni )
3074         CASE ( 1 )     ;   CALL lbc_nfd      ( ptab, cd_type, psgn )   ! only 1 northern proc, no mpp
3075         CASE DEFAULT   ;   CALL mpp_lbc_north( ptab, cd_type, psgn )   ! for all northern procs.
3076         END SELECT
3077         !
3078      ENDIF
3079      !
[4152]3080      DEALLOCATE( zt3ns, zt3sn, zt3ew, zt3we  )
3081      !
[3680]3082   END SUBROUTINE mpp_lnk_bdy_3d
3083
3084      SUBROUTINE mpp_lnk_bdy_2d( ptab, cd_type, psgn, ib_bdy )
3085      !!----------------------------------------------------------------------
3086      !!                  ***  routine mpp_lnk_bdy_2d  ***
3087      !!
3088      !! ** Purpose :   Message passing management
3089      !!
3090      !! ** Method  :   Use mppsend and mpprecv function for passing BDY boundaries
3091      !!      between processors following neighboring subdomains.
3092      !!            domain parameters
3093      !!                    nlci   : first dimension of the local subdomain
3094      !!                    nlcj   : second dimension of the local subdomain
3095      !!                    nbondi_bdy : mark for "east-west local boundary"
3096      !!                    nbondj_bdy : mark for "north-south local boundary"
3097      !!                    noea   : number for local neighboring processors
3098      !!                    nowe   : number for local neighboring processors
3099      !!                    noso   : number for local neighboring processors
3100      !!                    nono   : number for local neighboring processors
3101      !!
3102      !! ** Action  :   ptab with update value at its periphery
3103      !!
3104      !!----------------------------------------------------------------------
3105
3106      USE lbcnfd          ! north fold
3107
3108      INCLUDE 'mpif.h'
3109
3110      REAL(wp), DIMENSION(jpi,jpj)    , INTENT(inout) ::   ptab     ! 3D array on which the boundary condition is applied
3111      CHARACTER(len=1)                , INTENT(in   ) ::   cd_type  ! define the nature of ptab array grid-points
3112      !                                                             ! = T , U , V , F , W points
3113      REAL(wp)                        , INTENT(in   ) ::   psgn     ! =-1 the sign change across the north fold boundary
3114      !                                                             ! =  1. , the sign is kept
3115      INTEGER                         , INTENT(in   ) ::   ib_bdy   ! BDY boundary set
3116      INTEGER  ::   ji, jj, jl             ! dummy loop indices
3117      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
3118      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
3119      REAL(wp) ::   zland
3120      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
[4152]3121      !
3122      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  zt2ns, zt2sn   ! 2d for north-south & south-north
3123      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::  zt2ew, zt2we   ! 2d for east-west & west-east
3124
[3680]3125      !!----------------------------------------------------------------------
3126
[4152]3127      ALLOCATE( zt2ns(jpi,jprecj,2), zt2sn(jpi,jprecj,2),  &
3128         &      zt2ew(jpj,jpreci,2), zt2we(jpj,jpreci,2)   )
3129
[3680]3130      zland = 0.e0
3131
3132      ! 1. standard boundary treatment
3133      ! ------------------------------
3134     
3135      !                                   ! East-West boundaries
3136      !                                        !* Cyclic east-west
3137
3138      IF( nbondi == 2) THEN
3139        IF (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) THEN
3140          ptab( 1 ,:) = ptab(jpim1,:)
3141          ptab(jpi,:) = ptab(  2  ,:)
3142        ELSE
3143          IF( .NOT. cd_type == 'F' )   ptab(     1       :jpreci,:) = zland    ! south except F-point
3144          ptab(nlci-jpreci+1:jpi   ,:) = zland    ! north
3145        ENDIF
3146      ELSEIF(nbondi == -1) THEN
3147        IF( .NOT. cd_type == 'F' )   ptab(     1       :jpreci,:) = zland    ! south except F-point
3148      ELSEIF(nbondi == 1) THEN
3149        ptab(nlci-jpreci+1:jpi   ,:) = zland    ! north
3150      ENDIF                                     !* closed
3151
3152      IF (nbondj == 2 .OR. nbondj == -1) THEN
3153        IF( .NOT. cd_type == 'F' )   ptab(:,     1       :jprecj) = zland       ! south except F-point
3154      ELSEIF (nbondj == 2 .OR. nbondj == 1) THEN
3155        ptab(:,nlcj-jprecj+1:jpj) = zland       ! north
3156      ENDIF
3157     
3158      !
3159
3160      ! 2. East and west directions exchange
3161      ! ------------------------------------
3162      ! we play with the neigbours AND the row number because of the periodicity
3163      !
3164      SELECT CASE ( nbondi_bdy(ib_bdy) )      ! Read Dirichlet lateral conditions
3165      CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
3166         iihom = nlci-nreci
3167         DO jl = 1, jpreci
[4152]3168            zt2ew(:,jl,1) = ptab(jpreci+jl,:)
3169            zt2we(:,jl,1) = ptab(iihom +jl,:)
[3680]3170         END DO
3171      END SELECT
3172      !
3173      !                           ! Migrations
3174      imigr = jpreci * jpj
3175      !
3176      SELECT CASE ( nbondi_bdy(ib_bdy) )
3177      CASE ( -1 )
[4152]3178         CALL mppsend( 2, zt2we(1,1,1), imigr, noea, ml_req1 )
[3680]3179      CASE ( 0 )
[4152]3180         CALL mppsend( 1, zt2ew(1,1,1), imigr, nowe, ml_req1 )
3181         CALL mppsend( 2, zt2we(1,1,1), imigr, noea, ml_req2 )
[3680]3182      CASE ( 1 )
[4152]3183         CALL mppsend( 1, zt2ew(1,1,1), imigr, nowe, ml_req1 )
[3680]3184      END SELECT
3185      !
3186      SELECT CASE ( nbondi_bdy_b(ib_bdy) )
3187      CASE ( -1 )
[4152]3188         CALL mpprecv( 1, zt2ew(1,1,2), imigr, noea )
[3680]3189      CASE ( 0 )
[4152]3190         CALL mpprecv( 1, zt2ew(1,1,2), imigr, noea )
3191         CALL mpprecv( 2, zt2we(1,1,2), imigr, nowe )
[3680]3192      CASE ( 1 )
[4152]3193         CALL mpprecv( 2, zt2we(1,1,2), imigr, nowe )
[3680]3194      END SELECT
3195      !
3196      SELECT CASE ( nbondi_bdy(ib_bdy) )
3197      CASE ( -1 )
3198         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3199      CASE ( 0 )
3200         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3201         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
3202      CASE ( 1 )
3203         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3204      END SELECT
3205      !
3206      !                           ! Write Dirichlet lateral conditions
3207      iihom = nlci-jpreci
3208      !
3209      SELECT CASE ( nbondi_bdy_b(ib_bdy) )
3210      CASE ( -1 )
3211         DO jl = 1, jpreci
[4152]3212            ptab(iihom+jl,:) = zt2ew(:,jl,2)
[3680]3213         END DO
3214      CASE ( 0 )
3215         DO jl = 1, jpreci
[4152]3216            ptab(jl      ,:) = zt2we(:,jl,2)
3217            ptab(iihom+jl,:) = zt2ew(:,jl,2)
[3680]3218         END DO
3219      CASE ( 1 )
3220         DO jl = 1, jpreci
[4152]3221            ptab(jl      ,:) = zt2we(:,jl,2)
[3680]3222         END DO
3223      END SELECT
3224
3225
3226      ! 3. North and south directions
3227      ! -----------------------------
3228      ! always closed : we play only with the neigbours
3229      !
3230      IF( nbondj_bdy(ib_bdy) /= 2 ) THEN      ! Read Dirichlet lateral conditions
3231         ijhom = nlcj-nrecj
3232         DO jl = 1, jprecj
[4152]3233            zt2sn(:,jl,1) = ptab(:,ijhom +jl)
3234            zt2ns(:,jl,1) = ptab(:,jprecj+jl)
[3680]3235         END DO
3236      ENDIF
3237      !
3238      !                           ! Migrations
3239      imigr = jprecj * jpi
3240      !
3241      SELECT CASE ( nbondj_bdy(ib_bdy) )
3242      CASE ( -1 )
[4152]3243         CALL mppsend( 4, zt2sn(1,1,1), imigr, nono, ml_req1 )
[3680]3244      CASE ( 0 )
[4152]3245         CALL mppsend( 3, zt2ns(1,1,1), imigr, noso, ml_req1 )
3246         CALL mppsend( 4, zt2sn(1,1,1), imigr, nono, ml_req2 )
[3680]3247      CASE ( 1 )
[4152]3248         CALL mppsend( 3, zt2ns(1,1,1), imigr, noso, ml_req1 )
[3680]3249      END SELECT
3250      !
3251      SELECT CASE ( nbondj_bdy_b(ib_bdy) )
3252      CASE ( -1 )
[4152]3253         CALL mpprecv( 3, zt2ns(1,1,2), imigr, nono )
[3680]3254      CASE ( 0 )
[4152]3255         CALL mpprecv( 3, zt2ns(1,1,2), imigr, nono )
3256         CALL mpprecv( 4, zt2sn(1,1,2), imigr, noso )
[3680]3257      CASE ( 1 )
[4152]3258         CALL mpprecv( 4, zt2sn(1,1,2), imigr, noso )
[3680]3259      END SELECT
3260      !
3261      SELECT CASE ( nbondj_bdy(ib_bdy) )
3262      CASE ( -1 )
3263         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3264      CASE ( 0 )
3265         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3266         IF(l_isend) CALL mpi_wait(ml_req2, ml_stat, ml_err)
3267      CASE ( 1 )
3268         IF(l_isend) CALL mpi_wait(ml_req1, ml_stat, ml_err)
3269      END SELECT
3270      !
3271      !                           ! Write Dirichlet lateral conditions
3272      ijhom = nlcj-jprecj
3273      !
3274      SELECT CASE ( nbondj_bdy_b(ib_bdy) )
3275      CASE ( -1 )
3276         DO jl = 1, jprecj
[4152]3277            ptab(:,ijhom+jl) = zt2ns(:,jl,2)
[3680]3278         END DO
3279      CASE ( 0 )
3280         DO jl = 1, jprecj
[4152]3281            ptab(:,jl      ) = zt2sn(:,jl,2)
3282            ptab(:,ijhom+jl) = zt2ns(:,jl,2)
[3680]3283         END DO
3284      CASE ( 1 )
3285         DO jl = 1, jprecj
[4152]3286            ptab(:,jl) = zt2sn(:,jl,2)
[3680]3287         END DO
3288      END SELECT
3289
3290
3291      ! 4. north fold treatment
3292      ! -----------------------
3293      !
3294      IF( npolj /= 0) THEN
3295         !
3296         SELECT CASE ( jpni )
3297         CASE ( 1 )     ;   CALL lbc_nfd      ( ptab, cd_type, psgn )   ! only 1 northern proc, no mpp
3298         CASE DEFAULT   ;   CALL mpp_lbc_north( ptab, cd_type, psgn )   ! for all northern procs.
3299         END SELECT
3300         !
3301      ENDIF
3302      !
[4152]3303      DEALLOCATE( zt2ns, zt2sn, zt2ew, zt2we  )
3304      !
[3680]3305   END SUBROUTINE mpp_lnk_bdy_2d
3306
[2481]3307   SUBROUTINE mpi_init_opa( ldtxt, ksft, code )
[1344]3308      !!---------------------------------------------------------------------
3309      !!                   ***  routine mpp_init.opa  ***
3310      !!
3311      !! ** Purpose :: export and attach a MPI buffer for bsend
3312      !!
3313      !! ** Method  :: define buffer size in namelist, if 0 no buffer attachment
3314      !!            but classical mpi_init
[3764]3315      !!
3316      !! History :: 01/11 :: IDRIS initial version for IBM only
[1344]3317      !!            08/04 :: R. Benshila, generalisation
3318      !!---------------------------------------------------------------------
[3764]3319      CHARACTER(len=*),DIMENSION(:), INTENT(  out) ::   ldtxt
[2481]3320      INTEGER                      , INTENT(inout) ::   ksft
3321      INTEGER                      , INTENT(  out) ::   code
3322      INTEGER                                      ::   ierr, ji
3323      LOGICAL                                      ::   mpi_was_called
[1344]3324      !!---------------------------------------------------------------------
3325      !
3326      CALL mpi_initialized( mpi_was_called, code )      ! MPI initialization
[532]3327      IF ( code /= MPI_SUCCESS ) THEN
[3764]3328         DO ji = 1, SIZE(ldtxt)
[2481]3329            IF( TRIM(ldtxt(ji)) /= '' )   WRITE(*,*) ldtxt(ji)      ! control print of mynode
[3764]3330         END DO
[2481]3331         WRITE(*, cform_err)
3332         WRITE(*, *) ' lib_mpp: Error in routine mpi_initialized'
[1344]3333         CALL mpi_abort( mpi_comm_world, code, ierr )
[532]3334      ENDIF
[1344]3335      !
3336      IF( .NOT. mpi_was_called ) THEN
3337         CALL mpi_init( code )
3338         CALL mpi_comm_dup( mpi_comm_world, mpi_comm_opa, code )
[532]3339         IF ( code /= MPI_SUCCESS ) THEN
[3764]3340            DO ji = 1, SIZE(ldtxt)
[2481]3341               IF( TRIM(ldtxt(ji)) /= '' )   WRITE(*,*) ldtxt(ji)      ! control print of mynode
3342            END DO
3343            WRITE(*, cform_err)
3344            WRITE(*, *) ' lib_mpp: Error in routine mpi_comm_dup'
[532]3345            CALL mpi_abort( mpi_comm_world, code, ierr )
3346         ENDIF
3347      ENDIF
[1344]3348      !
[897]3349      IF( nn_buffer > 0 ) THEN
[2481]3350         WRITE(ldtxt(ksft),*) 'mpi_bsend, buffer allocation of  : ', nn_buffer   ;   ksft = ksft + 1
[897]3351         ! Buffer allocation and attachment
[2481]3352         ALLOCATE( tampon(nn_buffer), stat = ierr )
[3764]3353         IF( ierr /= 0 ) THEN
3354            DO ji = 1, SIZE(ldtxt)
[2481]3355               IF( TRIM(ldtxt(ji)) /= '' )   WRITE(*,*) ldtxt(ji)      ! control print of mynode
3356            END DO
3357            WRITE(*, cform_err)
3358            WRITE(*, *) ' lib_mpp: Error in ALLOCATE', ierr
3359            CALL mpi_abort( mpi_comm_world, code, ierr )
3360         END IF
3361         CALL mpi_buffer_attach( tampon, nn_buffer, code )
[897]3362      ENDIF
[1344]3363      !
[13]3364   END SUBROUTINE mpi_init_opa
[3]3365
[1976]3366   SUBROUTINE DDPDD_MPI (ydda, yddb, ilen, itype)
3367      !!---------------------------------------------------------------------
3368      !!   Routine DDPDD_MPI: used by reduction operator MPI_SUMDD
3369      !!
3370      !!   Modification of original codes written by David H. Bailey
3371      !!   This subroutine computes yddb(i) = ydda(i)+yddb(i)
3372      !!---------------------------------------------------------------------
3373      INTEGER, INTENT(in)                         :: ilen, itype
3374      COMPLEX(wp), DIMENSION(ilen), INTENT(in)     :: ydda
3375      COMPLEX(wp), DIMENSION(ilen), INTENT(inout)  :: yddb
3376      !
3377      REAL(wp) :: zerr, zt1, zt2    ! local work variables
3378      INTEGER :: ji, ztmp           ! local scalar
3379
3380      ztmp = itype   ! avoid compilation warning
3381
3382      DO ji=1,ilen
3383      ! Compute ydda + yddb using Knuth's trick.
3384         zt1  = real(ydda(ji)) + real(yddb(ji))
3385         zerr = zt1 - real(ydda(ji))
3386         zt2  = ((real(yddb(ji)) - zerr) + (real(ydda(ji)) - (zt1 - zerr))) &
3387                + aimag(ydda(ji)) + aimag(yddb(ji))
3388
3389         ! The result is zt1 + zt2, after normalization.
3390         yddb(ji) = cmplx ( zt1 + zt2, zt2 - ((zt1 + zt2) - zt1),wp )
3391      END DO
3392
3393   END SUBROUTINE DDPDD_MPI
3394
[4990]3395   SUBROUTINE mpp_lbc_north_icb( pt2d, cd_type, psgn, pr2dj)
3396      !!---------------------------------------------------------------------
3397      !!                   ***  routine mpp_lbc_north_icb  ***
3398      !!
3399      !! ** Purpose :   Ensure proper north fold horizontal bondary condition
3400      !!              in mpp configuration in case of jpn1 > 1 and for 2d
3401      !!              array with outer extra halo
3402      !!
3403      !! ** Method  :   North fold condition and mpp with more than one proc
3404      !!              in i-direction require a specific treatment. We gather
3405      !!              the 4+2*jpr2dj northern lines of the global domain on 1
3406      !!              processor and apply lbc north-fold on this sub array.
3407      !!              Then we scatter the north fold array back to the processors.
3408      !!              This version accounts for an extra halo with icebergs.
3409      !!
3410      !!----------------------------------------------------------------------
3411      REAL(wp), DIMENSION(:,:), INTENT(inout) ::   pt2d     ! 2D array with extra halo
3412      CHARACTER(len=1)        , INTENT(in   ) ::   cd_type  ! nature of pt3d grid-points
3413      !                                                     !   = T ,  U , V , F or W -points
3414      REAL(wp)                , INTENT(in   ) ::   psgn     ! = -1. the sign change across the
3415      !!                                                    ! north fold, =  1. otherwise
3416      INTEGER, OPTIONAL       , INTENT(in   ) ::   pr2dj
3417      INTEGER ::   ji, jj, jr
3418      INTEGER ::   ierr, itaille, ildi, ilei, iilb
3419      INTEGER ::   ijpj, ij, iproc, ipr2dj
3420      !
3421      REAL(wp), DIMENSION(:,:)  , ALLOCATABLE  ::  ztab_e, znorthloc_e
3422      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE  ::  znorthgloio_e
3423
3424      !!----------------------------------------------------------------------
3425      !
3426      ijpj=4
3427      IF( PRESENT(pr2dj) ) THEN           ! use of additional halos
3428         ipr2dj = pr2dj
3429      ELSE
3430         ipr2dj = 0
3431      ENDIF
3432      ALLOCATE( ztab_e(jpiglo,4+2*ipr2dj), znorthloc_e(jpi,4+2*ipr2dj), znorthgloio_e(jpi,4+2*ipr2dj,jpni) )
3433
3434      !
3435      ztab_e(:,:) = 0.e0
3436
3437      ij=0
3438      ! put in znorthloc_e the last 4 jlines of pt2d
3439      DO jj = nlcj - ijpj + 1 - ipr2dj, nlcj +ipr2dj
3440         ij = ij + 1
3441         DO ji = 1, jpi
3442            znorthloc_e(ji,ij)=pt2d(ji,jj)
3443         END DO
3444      END DO
3445      !
3446      itaille = jpi * ( ijpj + 2 * ipr2dj )
3447      CALL MPI_ALLGATHER( znorthloc_e(1,1)  , itaille, MPI_DOUBLE_PRECISION,    &
3448         &                znorthgloio_e(1,1,1), itaille, MPI_DOUBLE_PRECISION, ncomm_north, ierr )
3449      !
3450      DO jr = 1, ndim_rank_north            ! recover the global north array
3451         iproc = nrank_north(jr) + 1
3452         ildi = nldit (iproc)
3453         ilei = nleit (iproc)
3454         iilb = nimppt(iproc)
3455         DO jj = 1, ijpj+2*ipr2dj
3456            DO ji = ildi, ilei
3457               ztab_e(ji+iilb-1,jj) = znorthgloio_e(ji,jj,jr)
3458            END DO
3459         END DO
3460      END DO
3461
3462
3463      ! 2. North-Fold boundary conditions
3464      ! ----------------------------------
3465      CALL lbc_nfd( ztab_e(:,:), cd_type, psgn, pr2dj = ipr2dj )
3466
3467      ij = ipr2dj
3468      !! Scatter back to pt2d
3469      DO jj = nlcj - ijpj + 1 , nlcj +ipr2dj
3470      ij  = ij +1
3471         DO ji= 1, nlci
3472            pt2d(ji,jj) = ztab_e(ji+nimpp-1,ij)
3473         END DO
3474      END DO
3475      !
3476      DEALLOCATE( ztab_e, znorthloc_e, znorthgloio_e )
3477      !
3478   END SUBROUTINE mpp_lbc_north_icb
3479
3480   SUBROUTINE mpp_lnk_2d_icb( pt2d, cd_type, psgn, jpri, jprj )
3481      !!----------------------------------------------------------------------
3482      !!                  ***  routine mpp_lnk_2d_icb  ***
3483      !!
3484      !! ** Purpose :   Message passing manadgement for 2d array (with extra halo and icebergs)
3485      !!
3486      !! ** Method  :   Use mppsend and mpprecv function for passing mask
3487      !!      between processors following neighboring subdomains.
3488      !!            domain parameters
3489      !!                    nlci   : first dimension of the local subdomain
3490      !!                    nlcj   : second dimension of the local subdomain
3491      !!                    jpri   : number of rows for extra outer halo
3492      !!                    jprj   : number of columns for extra outer halo
3493      !!                    nbondi : mark for "east-west local boundary"
3494      !!                    nbondj : mark for "north-south local boundary"
3495      !!                    noea   : number for local neighboring processors
3496      !!                    nowe   : number for local neighboring processors
3497      !!                    noso   : number for local neighboring processors
3498      !!                    nono   : number for local neighboring processors
3499      !!
3500      !!----------------------------------------------------------------------
3501      INTEGER                                             , INTENT(in   ) ::   jpri
3502      INTEGER                                             , INTENT(in   ) ::   jprj
3503      REAL(wp), DIMENSION(1-jpri:jpi+jpri,1-jprj:jpj+jprj), INTENT(inout) ::   pt2d     ! 2D array with extra halo
3504      CHARACTER(len=1)                                    , INTENT(in   ) ::   cd_type  ! nature of ptab array grid-points
3505      !                                                                                 ! = T , U , V , F , W and I points
3506      REAL(wp)                                            , INTENT(in   ) ::   psgn     ! =-1 the sign change across the
3507      !!                                                                                ! north boundary, =  1. otherwise
3508      INTEGER  ::   jl   ! dummy loop indices
3509      INTEGER  ::   imigr, iihom, ijhom        ! temporary integers
3510      INTEGER  ::   ipreci, iprecj             ! temporary integers
3511      INTEGER  ::   ml_req1, ml_req2, ml_err   ! for key_mpi_isend
3512      INTEGER, DIMENSION(MPI_STATUS_SIZE) ::   ml_stat   ! for key_mpi_isend
3513      !!
3514      REAL(wp), DIMENSION(1-jpri:jpi+jpri,jprecj+jprj,2) :: r2dns
3515      REAL(wp), DIMENSION(1-jpri:jpi+jpri,jprecj+jprj,2) :: r2dsn
3516      REAL(wp), DIMENSION(1-jprj:jpj+jprj,jpreci+jpri,2) :: r2dwe
3517      REAL(wp), DIMENSION(1-jprj:jpj+jprj,jpreci+jpri,2) :: r2dew
3518      !!----------------------------------------------------------------------
3519
3520      ipreci = jpreci + jpri      ! take into account outer extra 2D overlap area
3521      iprecj = jprecj + jprj
3522
3523
3524      ! 1. standard boundary treatment
3525      ! ------------------------------
3526      ! Order matters Here !!!!
3527      !
3528      !                                      ! East-West boundaries
3529      !                                           !* Cyclic east-west
3530      IF( nbondi == 2 .AND. (nperio == 1 .OR. nperio == 4 .OR. nperio == 6) ) THEN
3531         pt2d(1-jpri:     1    ,:) = pt2d(jpim1-jpri:  jpim1 ,:)       ! east
3532         pt2d(   jpi  :jpi+jpri,:) = pt2d(     2      :2+jpri,:)       ! west
3533         !
3534      ELSE                                        !* closed
3535         IF( .NOT. cd_type == 'F' )   pt2d(  1-jpri   :jpreci    ,:) = 0.e0    ! south except at F-point
3536                                      pt2d(nlci-jpreci+1:jpi+jpri,:) = 0.e0    ! north
3537      ENDIF
3538      !
3539
3540      ! north fold treatment
3541      ! -----------------------
3542      IF( npolj /= 0 ) THEN
3543         !
3544         SELECT CASE ( jpni )
3545         CASE ( 1 )     ;   CALL lbc_nfd        ( pt2d(1:jpi,1:jpj+jprj), cd_type, psgn, pr2dj=jprj )
3546         CASE DEFAULT   ;   CALL mpp_lbc_north_icb( pt2d(1:jpi,1:jpj+jprj)  , cd_type, psgn , pr2dj=jprj  )
3547         END SELECT
3548         !
3549      ENDIF
3550
3551      ! 2. East and west directions exchange
3552      ! ------------------------------------
3553      ! we play with the neigbours AND the row number because of the periodicity
3554      !
3555      SELECT CASE ( nbondi )      ! Read Dirichlet lateral conditions
3556      CASE ( -1, 0, 1 )                ! all exept 2 (i.e. close case)
3557         iihom = nlci-nreci-jpri
3558         DO jl = 1, ipreci
3559            r2dew(:,jl,1) = pt2d(jpreci+jl,:)
3560            r2dwe(:,jl,1) = pt2d(iihom +jl,:)
3561         END DO
3562      END SELECT
3563      !
3564      !                           ! Migrations
3565      imigr = ipreci * ( jpj + 2*jprj)
3566      !
3567      SELECT CASE ( nbondi )
3568      CASE ( -1 )
3569         CALL mppsend( 2, r2dwe(1-jprj,1,1), imigr, noea, ml_req1 )
3570         CALL mpprecv( 1, r2dew(1-jprj,1,2), imigr, noea )
3571         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
3572      CASE ( 0 )
3573         CALL mppsend( 1, r2dew(1-jprj,1,1), imigr, nowe, ml_req1 )
3574         CALL mppsend( 2, r2dwe(1-jprj,1,1), imigr, noea, ml_req2 )
3575         CALL mpprecv( 1, r2dew(1-jprj,1,2), imigr, noea )
3576         CALL mpprecv( 2, r2dwe(1-jprj,1,2), imigr, nowe )
3577         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
3578         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
3579      CASE ( 1 )
3580         CALL mppsend( 1, r2dew(1-jprj,1,1), imigr, nowe, ml_req1 )
3581         CALL mpprecv( 2, r2dwe(1-jprj,1,2), imigr, nowe )
3582         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
3583      END SELECT
3584      !
3585      !                           ! Write Dirichlet lateral conditions
3586      iihom = nlci - jpreci
3587      !
3588      SELECT CASE ( nbondi )
3589      CASE ( -1 )
3590         DO jl = 1, ipreci
3591            pt2d(iihom+jl,:) = r2dew(:,jl,2)
3592         END DO
3593      CASE ( 0 )
3594         DO jl = 1, ipreci
3595            pt2d(jl-jpri,:) = r2dwe(:,jl,2)
3596            pt2d( iihom+jl,:) = r2dew(:,jl,2)
3597         END DO
3598      CASE ( 1 )
3599         DO jl = 1, ipreci
3600            pt2d(jl-jpri,:) = r2dwe(:,jl,2)
3601         END DO
3602      END SELECT
3603
3604
3605      ! 3. North and south directions
3606      ! -----------------------------
3607      ! always closed : we play only with the neigbours
3608      !
3609      IF( nbondj /= 2 ) THEN      ! Read Dirichlet lateral conditions
3610         ijhom = nlcj-nrecj-jprj
3611         DO jl = 1, iprecj
3612            r2dsn(:,jl,1) = pt2d(:,ijhom +jl)
3613            r2dns(:,jl,1) = pt2d(:,jprecj+jl)
3614         END DO
3615      ENDIF
3616      !
3617      !                           ! Migrations
3618      imigr = iprecj * ( jpi + 2*jpri )
3619      !
3620      SELECT CASE ( nbondj )
3621      CASE ( -1 )
3622         CALL mppsend( 4, r2dsn(1-jpri,1,1), imigr, nono, ml_req1 )
3623         CALL mpprecv( 3, r2dns(1-jpri,1,2), imigr, nono )
3624         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
3625      CASE ( 0 )
3626         CALL mppsend( 3, r2dns(1-jpri,1,1), imigr, noso, ml_req1 )
3627         CALL mppsend( 4, r2dsn(1-jpri,1,1), imigr, nono, ml_req2 )
3628         CALL mpprecv( 3, r2dns(1-jpri,1,2), imigr, nono )
3629         CALL mpprecv( 4, r2dsn(1-jpri,1,2), imigr, noso )
3630         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
3631         IF(l_isend) CALL mpi_wait(ml_req2,ml_stat,ml_err)
3632      CASE ( 1 )
3633         CALL mppsend( 3, r2dns(1-jpri,1,1), imigr, noso, ml_req1 )
3634         CALL mpprecv( 4, r2dsn(1-jpri,1,2), imigr, noso )
3635         IF(l_isend) CALL mpi_wait(ml_req1,ml_stat,ml_err)
3636      END SELECT
3637      !
3638      !                           ! Write Dirichlet lateral conditions
3639      ijhom = nlcj - jprecj
3640      !
3641      SELECT CASE ( nbondj )
3642      CASE ( -1 )
3643         DO jl = 1, iprecj
3644            pt2d(:,ijhom+jl) = r2dns(:,jl,2)
3645         END DO
3646      CASE ( 0 )
3647         DO jl = 1, iprecj
3648            pt2d(:,jl-jprj) = r2dsn(:,jl,2)
3649            pt2d(:,ijhom+jl ) = r2dns(:,jl,2)
3650         END DO
3651      CASE ( 1 )
3652         DO jl = 1, iprecj
3653            pt2d(:,jl-jprj) = r2dsn(:,jl,2)
3654         END DO
3655      END SELECT
3656
3657   END SUBROUTINE mpp_lnk_2d_icb
[13]3658#else
3659   !!----------------------------------------------------------------------
3660   !!   Default case:            Dummy module        share memory computing
3661   !!----------------------------------------------------------------------
[2715]3662   USE in_out_manager
[1976]3663
[13]3664   INTERFACE mpp_sum
[3294]3665      MODULE PROCEDURE mpp_sum_a2s, mpp_sum_as, mpp_sum_ai, mpp_sum_s, mpp_sum_i, mppsum_realdd, mppsum_a_realdd
[13]3666   END INTERFACE
3667   INTERFACE mpp_max
[681]3668      MODULE PROCEDURE mppmax_a_int, mppmax_int, mppmax_a_real, mppmax_real
[13]3669   END INTERFACE
3670   INTERFACE mpp_min
3671      MODULE PROCEDURE mppmin_a_int, mppmin_int, mppmin_a_real, mppmin_real
3672   END INTERFACE
[1344]3673   INTERFACE mpp_minloc
3674      MODULE PROCEDURE mpp_minloc2d ,mpp_minloc3d
3675   END INTERFACE
3676   INTERFACE mpp_maxloc
3677      MODULE PROCEDURE mpp_maxloc2d ,mpp_maxloc3d
3678   END INTERFACE
[3]3679
[13]3680   LOGICAL, PUBLIC, PARAMETER ::   lk_mpp = .FALSE.      !: mpp flag
[4147]3681   LOGICAL, PUBLIC            ::   ln_nnogather          !: namelist control of northfold comms (needed here in case "key_mpp_mpi" is not used)
[869]3682   INTEGER :: ncomm_ice
[5412]3683   INTEGER, PUBLIC            ::   mpi_comm_opa          ! opa local communicator
[2715]3684   !!----------------------------------------------------------------------
[13]3685CONTAINS
[3]3686
[2715]3687   INTEGER FUNCTION lib_mpp_alloc(kumout)          ! Dummy function
3688      INTEGER, INTENT(in) ::   kumout
3689      lib_mpp_alloc = 0
3690   END FUNCTION lib_mpp_alloc
3691
[5407]3692   FUNCTION mynode( ldtxt, ldname, kumnam_ref, knumnam_cfg,  kumond , kstop, localComm ) RESULT (function_value)
[1579]3693      INTEGER, OPTIONAL            , INTENT(in   ) ::   localComm
[3764]3694      CHARACTER(len=*),DIMENSION(:) ::   ldtxt
[5407]3695      CHARACTER(len=*) ::   ldname
[4314]3696      INTEGER ::   kumnam_ref, knumnam_cfg , kumond , kstop
[5412]3697      IF( PRESENT( localComm ) ) mpi_comm_opa = localComm
3698      function_value = 0
[1579]3699      IF( .FALSE. )   ldtxt(:) = 'never done'
[5407]3700      CALL ctl_opn( kumond, TRIM(ldname), 'UNKNOWN', 'FORMATTED', 'SEQUENTIAL', -1, 6, .FALSE. , 1 )
[13]3701   END FUNCTION mynode
[3]3702
[13]3703   SUBROUTINE mppsync                       ! Dummy routine
3704   END SUBROUTINE mppsync
[3]3705
[869]3706   SUBROUTINE mpp_sum_as( parr, kdim, kcom )      ! Dummy routine
[13]3707      REAL   , DIMENSION(:) :: parr
3708      INTEGER               :: kdim
[3764]3709      INTEGER, OPTIONAL     :: kcom
[869]3710      WRITE(*,*) 'mpp_sum_as: You should not have seen this print! error?', kdim, parr(1), kcom
[13]3711   END SUBROUTINE mpp_sum_as
[3]3712
[869]3713   SUBROUTINE mpp_sum_a2s( parr, kdim, kcom )      ! Dummy routine
[13]3714      REAL   , DIMENSION(:,:) :: parr
3715      INTEGER               :: kdim
[3764]3716      INTEGER, OPTIONAL     :: kcom
[869]3717      WRITE(*,*) 'mpp_sum_a2s: You should not have seen this print! error?', kdim, parr(1,1), kcom
[13]3718   END SUBROUTINE mpp_sum_a2s
[3]3719
[869]3720   SUBROUTINE mpp_sum_ai( karr, kdim, kcom )      ! Dummy routine
[13]3721      INTEGER, DIMENSION(:) :: karr
3722      INTEGER               :: kdim
[3764]3723      INTEGER, OPTIONAL     :: kcom
[869]3724      WRITE(*,*) 'mpp_sum_ai: You should not have seen this print! error?', kdim, karr(1), kcom
[13]3725   END SUBROUTINE mpp_sum_ai
[3]3726
[869]3727   SUBROUTINE mpp_sum_s( psca, kcom )            ! Dummy routine
[13]3728      REAL                  :: psca
[3764]3729      INTEGER, OPTIONAL     :: kcom
[869]3730      WRITE(*,*) 'mpp_sum_s: You should not have seen this print! error?', psca, kcom
[13]3731   END SUBROUTINE mpp_sum_s
[2480]3732
[869]3733   SUBROUTINE mpp_sum_i( kint, kcom )            ! Dummy routine
[13]3734      integer               :: kint
[3764]3735      INTEGER, OPTIONAL     :: kcom
[869]3736      WRITE(*,*) 'mpp_sum_i: You should not have seen this print! error?', kint, kcom
[13]3737   END SUBROUTINE mpp_sum_i
3738
[3294]3739   SUBROUTINE mppsum_realdd( ytab, kcom )
3740      COMPLEX(wp), INTENT(inout)         :: ytab    ! input scalar
3741      INTEGER , INTENT( in  ), OPTIONAL :: kcom
3742      WRITE(*,*) 'mppsum_realdd: You should not have seen this print! error?', ytab
3743   END SUBROUTINE mppsum_realdd
[3764]3744
[3294]3745   SUBROUTINE mppsum_a_realdd( ytab, kdim, kcom )
3746      INTEGER , INTENT( in )                        ::   kdim      ! size of ytab
3747      COMPLEX(wp), DIMENSION(kdim), INTENT( inout ) ::   ytab      ! input array
3748      INTEGER , INTENT( in  ), OPTIONAL :: kcom
3749      WRITE(*,*) 'mppsum_a_realdd: You should not have seen this print! error?', kdim, ytab(1), kcom
3750   END SUBROUTINE mppsum_a_realdd
3751
[869]3752   SUBROUTINE mppmax_a_real( parr, kdim, kcom )
[13]3753      REAL   , DIMENSION(:) :: parr
3754      INTEGER               :: kdim
[3764]3755      INTEGER, OPTIONAL     :: kcom
[869]3756      WRITE(*,*) 'mppmax_a_real: You should not have seen this print! error?', kdim, parr(1), kcom
[13]3757   END SUBROUTINE mppmax_a_real
3758
[869]3759   SUBROUTINE mppmax_real( psca, kcom )
[13]3760      REAL                  :: psca
[3764]3761      INTEGER, OPTIONAL     :: kcom
[869]3762      WRITE(*,*) 'mppmax_real: You should not have seen this print! error?', psca, kcom
[13]3763   END SUBROUTINE mppmax_real
3764
[869]3765   SUBROUTINE mppmin_a_real( parr, kdim, kcom )
[13]3766      REAL   , DIMENSION(:) :: parr
3767      INTEGER               :: kdim
[3764]3768      INTEGER, OPTIONAL     :: kcom
[869]3769      WRITE(*,*) 'mppmin_a_real: You should not have seen this print! error?', kdim, parr(1), kcom
[13]3770   END SUBROUTINE mppmin_a_real
3771
[869]3772   SUBROUTINE mppmin_real( psca, kcom )
[13]3773      REAL                  :: psca
[3764]3774      INTEGER, OPTIONAL     :: kcom
[869]3775      WRITE(*,*) 'mppmin_real: You should not have seen this print! error?', psca, kcom
[13]3776   END SUBROUTINE mppmin_real
3777
[869]3778   SUBROUTINE mppmax_a_int( karr, kdim ,kcom)
[681]3779      INTEGER, DIMENSION(:) :: karr
3780      INTEGER               :: kdim
[3764]3781      INTEGER, OPTIONAL     :: kcom
[888]3782      WRITE(*,*) 'mppmax_a_int: You should not have seen this print! error?', kdim, karr(1), kcom
[681]3783   END SUBROUTINE mppmax_a_int
3784
[869]3785   SUBROUTINE mppmax_int( kint, kcom)
[681]3786      INTEGER               :: kint
[3764]3787      INTEGER, OPTIONAL     :: kcom
[869]3788      WRITE(*,*) 'mppmax_int: You should not have seen this print! error?', kint, kcom
[681]3789   END SUBROUTINE mppmax_int
3790
[869]3791   SUBROUTINE mppmin_a_int( karr, kdim, kcom )
[13]3792      INTEGER, DIMENSION(:) :: karr
3793      INTEGER               :: kdim
[3764]3794      INTEGER, OPTIONAL     :: kcom
[869]3795      WRITE(*,*) 'mppmin_a_int: You should not have seen this print! error?', kdim, karr(1), kcom
[13]3796   END SUBROUTINE mppmin_a_int
3797
[869]3798   SUBROUTINE mppmin_int( kint, kcom )
[13]3799      INTEGER               :: kint
[3764]3800      INTEGER, OPTIONAL     :: kcom
[869]3801      WRITE(*,*) 'mppmin_int: You should not have seen this print! error?', kint, kcom
[13]3802   END SUBROUTINE mppmin_int
3803
[1344]3804   SUBROUTINE mpp_minloc2d( ptab, pmask, pmin, ki, kj )
[181]3805      REAL                   :: pmin
3806      REAL , DIMENSION (:,:) :: ptab, pmask
3807      INTEGER :: ki, kj
[1528]3808      WRITE(*,*) 'mpp_minloc2d: You should not have seen this print! error?', pmin, ki, kj, ptab(1,1), pmask(1,1)
[181]3809   END SUBROUTINE mpp_minloc2d
3810
[1344]3811   SUBROUTINE mpp_minloc3d( ptab, pmask, pmin, ki, kj, kk )
[181]3812      REAL                     :: pmin
3813      REAL , DIMENSION (:,:,:) :: ptab, pmask
3814      INTEGER :: ki, kj, kk
[1528]3815      WRITE(*,*) 'mpp_minloc3d: You should not have seen this print! error?', pmin, ki, kj, kk, ptab(1,1,1), pmask(1,1,1)
[181]3816   END SUBROUTINE mpp_minloc3d
3817
[1344]3818   SUBROUTINE mpp_maxloc2d( ptab, pmask, pmax, ki, kj )
[181]3819      REAL                   :: pmax
3820      REAL , DIMENSION (:,:) :: ptab, pmask
3821      INTEGER :: ki, kj
[1528]3822      WRITE(*,*) 'mpp_maxloc2d: You should not have seen this print! error?', pmax, ki, kj, ptab(1,1), pmask(1,1)
[181]3823   END SUBROUTINE mpp_maxloc2d
3824
[1344]3825   SUBROUTINE mpp_maxloc3d( ptab, pmask, pmax, ki, kj, kk )
[181]3826      REAL                     :: pmax
3827      REAL , DIMENSION (:,:,:) :: ptab, pmask
3828      INTEGER :: ki, kj, kk
[1528]3829      WRITE(*,*) 'mpp_maxloc3d: You should not have seen this print! error?', pmax, ki, kj, kk, ptab(1,1,1), pmask(1,1,1)
[181]3830   END SUBROUTINE mpp_maxloc3d
3831
[51]3832   SUBROUTINE mppstop
[3799]3833      STOP      ! non MPP case, just stop the run
[51]3834   END SUBROUTINE mppstop
3835
[2715]3836   SUBROUTINE mpp_ini_ice( kcom, knum )
3837      INTEGER :: kcom, knum
3838      WRITE(*,*) 'mpp_ini_ice: You should not have seen this print! error?', kcom, knum
[888]3839   END SUBROUTINE mpp_ini_ice
[869]3840
[2715]3841   SUBROUTINE mpp_ini_znl( knum )
3842      INTEGER :: knum
3843      WRITE(*,*) 'mpp_ini_znl: You should not have seen this print! error?', knum
[1345]3844   END SUBROUTINE mpp_ini_znl
3845
[1344]3846   SUBROUTINE mpp_comm_free( kcom )
[869]3847      INTEGER :: kcom
[1344]3848      WRITE(*,*) 'mpp_comm_free: You should not have seen this print! error?', kcom
[869]3849   END SUBROUTINE mpp_comm_free
[3]3850#endif
[2715]3851
[13]3852   !!----------------------------------------------------------------------
[4147]3853   !!   All cases:         ctl_stop, ctl_warn, get_unit, ctl_opn, ctl_nam   routines
[2715]3854   !!----------------------------------------------------------------------
3855
3856   SUBROUTINE ctl_stop( cd1, cd2, cd3, cd4, cd5 ,   &
3857      &                 cd6, cd7, cd8, cd9, cd10 )
3858      !!----------------------------------------------------------------------
3859      !!                  ***  ROUTINE  stop_opa  ***
3860      !!
[3764]3861      !! ** Purpose :   print in ocean.outpput file a error message and
[2715]3862      !!                increment the error number (nstop) by one.
3863      !!----------------------------------------------------------------------
3864      CHARACTER(len=*), INTENT(in), OPTIONAL ::  cd1, cd2, cd3, cd4, cd5
3865      CHARACTER(len=*), INTENT(in), OPTIONAL ::  cd6, cd7, cd8, cd9, cd10
3866      !!----------------------------------------------------------------------
3867      !
[3764]3868      nstop = nstop + 1
[2715]3869      IF(lwp) THEN
3870         WRITE(numout,cform_err)
3871         IF( PRESENT(cd1 ) )   WRITE(numout,*) cd1
3872         IF( PRESENT(cd2 ) )   WRITE(numout,*) cd2
3873         IF( PRESENT(cd3 ) )   WRITE(numout,*) cd3
3874         IF( PRESENT(cd4 ) )   WRITE(numout,*) cd4
3875         IF( PRESENT(cd5 ) )   WRITE(numout,*) cd5
3876         IF( PRESENT(cd6 ) )   WRITE(numout,*) cd6
3877         IF( PRESENT(cd7 ) )   WRITE(numout,*) cd7
3878         IF( PRESENT(cd8 ) )   WRITE(numout,*) cd8
3879         IF( PRESENT(cd9 ) )   WRITE(numout,*) cd9
3880         IF( PRESENT(cd10) )   WRITE(numout,*) cd10
3881      ENDIF
3882                               CALL FLUSH(numout    )
3883      IF( numstp     /= -1 )   CALL FLUSH(numstp    )
3884      IF( numsol     /= -1 )   CALL FLUSH(numsol    )
3885      IF( numevo_ice /= -1 )   CALL FLUSH(numevo_ice)
3886      !
3887      IF( cd1 == 'STOP' ) THEN
3888         IF(lwp) WRITE(numout,*)  'huge E-R-R-O-R : immediate stop'
3889         CALL mppstop()
3890      ENDIF
3891      !
3892   END SUBROUTINE ctl_stop
3893
3894
3895   SUBROUTINE ctl_warn( cd1, cd2, cd3, cd4, cd5,   &
3896      &                 cd6, cd7, cd8, cd9, cd10 )
3897      !!----------------------------------------------------------------------
3898      !!                  ***  ROUTINE  stop_warn  ***
3899      !!
[3764]3900      !! ** Purpose :   print in ocean.outpput file a error message and
[2715]3901      !!                increment the warning number (nwarn) by one.
3902      !!----------------------------------------------------------------------
3903      CHARACTER(len=*), INTENT(in), OPTIONAL ::  cd1, cd2, cd3, cd4, cd5
3904      CHARACTER(len=*), INTENT(in), OPTIONAL ::  cd6, cd7, cd8, cd9, cd10
3905      !!----------------------------------------------------------------------
[3764]3906      !
3907      nwarn = nwarn + 1
[2715]3908      IF(lwp) THEN
3909         WRITE(numout,cform_war)
3910         IF( PRESENT(cd1 ) ) WRITE(numout,*) cd1
3911         IF( PRESENT(cd2 ) ) WRITE(numout,*) cd2
3912         IF( PRESENT(cd3 ) ) WRITE(numout,*) cd3
3913         IF( PRESENT(cd4 ) ) WRITE(numout,*) cd4
3914         IF( PRESENT(cd5 ) ) WRITE(numout,*) cd5
3915         IF( PRESENT(cd6 ) ) WRITE(numout,*) cd6
3916         IF( PRESENT(cd7 ) ) WRITE(numout,*) cd7
3917         IF( PRESENT(cd8 ) ) WRITE(numout,*) cd8
3918         IF( PRESENT(cd9 ) ) WRITE(numout,*) cd9
3919         IF( PRESENT(cd10) ) WRITE(numout,*) cd10
3920      ENDIF
3921      CALL FLUSH(numout)
3922      !
3923   END SUBROUTINE ctl_warn
3924
3925
3926   SUBROUTINE ctl_opn( knum, cdfile, cdstat, cdform, cdacce, klengh, kout, ldwp, karea )
3927      !!----------------------------------------------------------------------
3928      !!                  ***  ROUTINE ctl_opn  ***
3929      !!
3930      !! ** Purpose :   Open file and check if required file is available.
3931      !!
3932      !! ** Method  :   Fortan open
3933      !!----------------------------------------------------------------------
3934      INTEGER          , INTENT(  out) ::   knum      ! logical unit to open
3935      CHARACTER(len=*) , INTENT(in   ) ::   cdfile    ! file name to open
3936      CHARACTER(len=*) , INTENT(in   ) ::   cdstat    ! disposition specifier
3937      CHARACTER(len=*) , INTENT(in   ) ::   cdform    ! formatting specifier
3938      CHARACTER(len=*) , INTENT(in   ) ::   cdacce    ! access specifier
3939      INTEGER          , INTENT(in   ) ::   klengh    ! record length
3940      INTEGER          , INTENT(in   ) ::   kout      ! number of logical units for write
3941      LOGICAL          , INTENT(in   ) ::   ldwp      ! boolean term for print
3942      INTEGER, OPTIONAL, INTENT(in   ) ::   karea     ! proc number
3943      !!
3944      CHARACTER(len=80) ::   clfile
3945      INTEGER           ::   iost
3946      !!----------------------------------------------------------------------
3947
3948      ! adapt filename
3949      ! ----------------
3950      clfile = TRIM(cdfile)
3951      IF( PRESENT( karea ) ) THEN
3952         IF( karea > 1 )   WRITE(clfile, "(a,'_',i4.4)") TRIM(clfile), karea-1
3953      ENDIF
3954#if defined key_agrif
3955      IF( .NOT. Agrif_Root() )   clfile = TRIM(Agrif_CFixed())//'_'//TRIM(clfile)
3956      knum=Agrif_Get_Unit()
3957#else
3958      knum=get_unit()
3959#endif
3960
3961      iost=0
3962      IF( cdacce(1:6) == 'DIRECT' )  THEN
3963         OPEN( UNIT=knum, FILE=clfile, FORM=cdform, ACCESS=cdacce, STATUS=cdstat, RECL=klengh, ERR=100, IOSTAT=iost )
3964      ELSE
3965         OPEN( UNIT=knum, FILE=clfile, FORM=cdform, ACCESS=cdacce, STATUS=cdstat             , ERR=100, IOSTAT=iost )
3966      ENDIF
3967      IF( iost == 0 ) THEN
3968         IF(ldwp) THEN
3969            WRITE(kout,*) '     file   : ', clfile,' open ok'
3970            WRITE(kout,*) '     unit   = ', knum
3971            WRITE(kout,*) '     status = ', cdstat
3972            WRITE(kout,*) '     form   = ', cdform
3973            WRITE(kout,*) '     access = ', cdacce
3974            WRITE(kout,*)
3975         ENDIF
3976      ENDIF
3977100   CONTINUE
3978      IF( iost /= 0 ) THEN
3979         IF(ldwp) THEN
3980            WRITE(kout,*)
3981            WRITE(kout,*) ' ===>>>> : bad opening file: ', clfile
3982            WRITE(kout,*) ' =======   ===  '
3983            WRITE(kout,*) '           unit   = ', knum
3984            WRITE(kout,*) '           status = ', cdstat
3985            WRITE(kout,*) '           form   = ', cdform
3986            WRITE(kout,*) '           access = ', cdacce
3987            WRITE(kout,*) '           iostat = ', iost
3988            WRITE(kout,*) '           we stop. verify the file '
3989            WRITE(kout,*)
3990         ENDIF
3991         STOP 'ctl_opn bad opening'
3992      ENDIF
[3764]3993
[2715]3994   END SUBROUTINE ctl_opn
3995
[4147]3996   SUBROUTINE ctl_nam ( kios, cdnam, ldwp )
3997      !!----------------------------------------------------------------------
3998      !!                  ***  ROUTINE ctl_nam  ***
3999      !!
4000      !! ** Purpose :   Informations when error while reading a namelist
4001      !!
4002      !! ** Method  :   Fortan open
4003      !!----------------------------------------------------------------------
4004      INTEGER          , INTENT(inout) ::   kios      ! IO status after reading the namelist
4005      CHARACTER(len=*) , INTENT(in   ) ::   cdnam     ! group name of namelist for which error occurs
[7531]4006      CHARACTER(len=5)                 ::   clios     ! string to convert iostat in character for print
[4147]4007      LOGICAL          , INTENT(in   ) ::   ldwp      ! boolean term for print
4008      !!----------------------------------------------------------------------
[2715]4009
[4147]4010      !
4011      ! ----------------
[7531]4012      WRITE (clios, '(I5.0)') kios
[4147]4013      IF( kios < 0 ) THEN         
4014         CALL ctl_warn( 'W A R N I N G:  end of record or file while reading namelist ' &
4015 &           // TRIM(cdnam) // ' iostat = ' // TRIM(clios) )
4016      ENDIF
4017
4018      IF( kios > 0 ) THEN
4019         CALL ctl_stop( 'E R R O R :   misspelled variable in namelist ' &
4020 &           // TRIM(cdnam) // ' iostat = ' // TRIM(clios) )
4021      ENDIF
4022      kios = 0
4023      RETURN
4024     
4025   END SUBROUTINE ctl_nam
4026
[2715]4027   INTEGER FUNCTION get_unit()
4028      !!----------------------------------------------------------------------
4029      !!                  ***  FUNCTION  get_unit  ***
4030      !!
4031      !! ** Purpose :   return the index of an unused logical unit
4032      !!----------------------------------------------------------------------
[3764]4033      LOGICAL :: llopn
[2715]4034      !!----------------------------------------------------------------------
4035      !
4036      get_unit = 15   ! choose a unit that is big enough then it is not already used in NEMO
4037      llopn = .TRUE.
4038      DO WHILE( (get_unit < 998) .AND. llopn )
4039         get_unit = get_unit + 1
4040         INQUIRE( unit = get_unit, opened = llopn )
4041      END DO
4042      IF( (get_unit == 999) .AND. llopn ) THEN
4043         CALL ctl_stop( 'get_unit: All logical units until 999 are used...' )
4044         get_unit = -1
4045      ENDIF
4046      !
4047   END FUNCTION get_unit
4048
4049   !!----------------------------------------------------------------------
[3]4050END MODULE lib_mpp
Note: See TracBrowser for help on using the repository browser.