eesupp/src/exch_3d_rx.template

C $Header: /u/gcmpack/MITgcm/eesupp/src/exch_xyz_rx.template,v 1.5 2004/11/18 15:05:38 jmc Exp $
C $Name:  $

#include "PACKAGES_CONFIG.h"
#include "CPP_EEOPTIONS.h"

CBOP
C     !ROUTINE: EXCH_3D_RX

C     !INTERFACE:
      SUBROUTINE EXCH_3D_RX(
     U                       phi,
     I                       myNz, myThid )

C     !DESCRIPTION:
C     *==========================================================*
C     | SUBROUTINE EXCH_3D_RX
C     | o Handle exchanges for _RX, three-dim scalar arrays.
C     *==========================================================*
C     | Invoke appropriate exchange routine depending on type
C     | of grid (cube or globally indexed) to be operated on.
C     *==========================================================*

C     !USES:
      IMPLICIT NONE
C     === Global data ===
#include "SIZE.h"
#include "EEPARAMS.h"
#include "EESUPPORT.h"
#include "EXCH.h"

C     !INPUT/OUTPUT PARAMETERS:
C     === Routine arguments ===
C     phi    :: Array with overlap regions are to be exchanged
C     myNz   :: 3rd dimension of array to exchange
C     myThid :: My thread id.
      INTEGER myNz
      _RX phi(1-OLx:sNx+OLx,1-OLy:sNy+OLy,1:myNz,nSx,nSy)
      INTEGER myThid

C     !LOCAL VARIABLES:
C     == Local variables ==
C     OL[wens]       :: Overlap extents in west, east, north, south.
C     exchWidth[XY]  :: Extent of regions that will be exchanged.
      INTEGER OLw, OLe, OLn, OLs, exchWidthX, exchWidthY

CEOP

#ifdef ALLOW_EXCH2
      CALL EXCH2_3D_RX( phi, myNz, myThid )
      RETURN
#endif

      OLw        = OLx
      OLe        = OLx
      OLn        = OLy
      OLs        = OLy
      exchWidthX = OLx
      exchWidthY = OLy
C     ** NOTE ** The exchange routine we use here does not
C                require the preceeding and following barriers.
C                However, the slow, simple exchange interface
C                that is calling it here is meant to ensure
C                that threads are synchronised before exchanges
C                begine.
      IF (useCubedSphereExchange) THEN
       CALL EXCH_RX_CUBE( phi,
     I            OLw, OLe, OLs, OLn, myNz,
     I            exchWidthX, exchWidthY,
     I            FORWARD_SIMULATION, EXCH_UPDATE_CORNERS, myThid )
      ELSE
       CALL EXCH_RX( phi,
     I            OLw, OLe, OLs, OLn, myNz,
     I            exchWidthX, exchWidthY,
     I            FORWARD_SIMULATION, EXCH_UPDATE_CORNERS, myThid )
      ENDIF

      RETURN
      END
1	C $Header: /u/gcmpack/MITgcm/eesupp/src/exch_xyz_rx.template,v 1.5 2004/11/18 15:05:38 jmc Exp $
2	C $Name: $
3
4	#include "PACKAGES_CONFIG.h"
5	#include "CPP_EEOPTIONS.h"
6
7	CBOP
8	C !ROUTINE: EXCH_3D_RX
9
10	C !INTERFACE:
11	SUBROUTINE EXCH_3D_RX(
12	U phi,
13	I myNz, myThid )
14
15	C !DESCRIPTION:
16	C ==========================================================
17	C \| SUBROUTINE EXCH_3D_RX
18	C \| o Handle exchanges for _RX, three-dim scalar arrays.
19	C ==========================================================
20	C \| Invoke appropriate exchange routine depending on type
21	C \| of grid (cube or globally indexed) to be operated on.
22	C ==========================================================
23
24	C !USES:
25	IMPLICIT NONE
26	C === Global data ===
27	#include "SIZE.h"
28	#include "EEPARAMS.h"
29	#include "EESUPPORT.h"
30	#include "EXCH.h"
31
32	C !INPUT/OUTPUT PARAMETERS:
33	C === Routine arguments ===
34	C phi :: Array with overlap regions are to be exchanged
35	C myNz :: 3rd dimension of array to exchange
36	C myThid :: My thread id.
37	INTEGER myNz
38	_RX phi(1-OLx:sNx+OLx,1-OLy:sNy+OLy,1:myNz,nSx,nSy)
39	INTEGER myThid
40
41	C !LOCAL VARIABLES:
42	C == Local variables ==
43	C OL[wens] :: Overlap extents in west, east, north, south.
44	C exchWidth[XY] :: Extent of regions that will be exchanged.
45	INTEGER OLw, OLe, OLn, OLs, exchWidthX, exchWidthY
46
47	CEOP
48
49	#ifdef ALLOW_EXCH2
50	CALL EXCH2_3D_RX( phi, myNz, myThid )
51	RETURN
52	#endif
53
54	OLw = OLx
55	OLe = OLx
56	OLn = OLy
57	OLs = OLy
58	exchWidthX = OLx
59	exchWidthY = OLy
60	C NOTE The exchange routine we use here does not
61	C require the preceeding and following barriers.
62	C However, the slow, simple exchange interface
63	C that is calling it here is meant to ensure
64	C that threads are synchronised before exchanges
65	C begine.
66	IF (useCubedSphereExchange) THEN
67	CALL EXCH_RX_CUBE( phi,
68	I OLw, OLe, OLs, OLn, myNz,
69	I exchWidthX, exchWidthY,
70	I FORWARD_SIMULATION, EXCH_UPDATE_CORNERS, myThid )
71	ELSE
72	CALL EXCH_RX( phi,
73	I OLw, OLe, OLs, OLn, myNz,
74	I exchWidthX, exchWidthY,
75	I FORWARD_SIMULATION, EXCH_UPDATE_CORNERS, myThid )
76	ENDIF
77
78	RETURN
79	END