/[MITgcm]/MITgcm/pkg/ptracers/ptracers_integrate.F
ViewVC logotype

Diff of /MITgcm/pkg/ptracers/ptracers_integrate.F

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.3 by jmc, Sat Jun 15 03:37:44 2002 UTC revision 1.42 by heimbach, Tue Jan 18 22:58:20 2011 UTC
# Line 4  C $Name$ Line 4  C $Name$
4  #include "PTRACERS_OPTIONS.h"  #include "PTRACERS_OPTIONS.h"
5    
6  CBOP  CBOP
7  C !ROUTINE: PTRACERS_INTEGERATE  C !ROUTINE: PTRACERS_INTEGRATE
8    
9  C !INTERFACE: ==========================================================  C !INTERFACE: ==========================================================
10        SUBROUTINE PTRACERS_INTEGERATE(        SUBROUTINE PTRACERS_INTEGRATE(
11       I                               bi,bj,k,       I                    bi,bj,k,
12       I                               xA,yA,uTrans,vTrans,rTrans,maskUp,       I                    xA, yA, maskUp, uFld, vFld, wFld,
13       X                               KappaRtr,       I                    uTrans, vTrans, rTrans, rTransKp1,
14       I                               myIter,myTime,myThid )       I                    KappaRtr,
15         U                    rFlx,
16         I                    myTime,myIter,myThid )
17    
18  C !DESCRIPTION:  C !DESCRIPTION:
19  C     Calculates tendancy for passive tracers and integrates forward  C     Calculates tendency for passive tracers and integrates forward
20  C     in time.  C     in time.
21    
22  C !USES: ===============================================================  C !USES: ===============================================================
23        IMPLICIT NONE        IMPLICIT NONE
24  #include "SIZE.h"  #include "SIZE.h"
25  #include "EEPARAMS.h"  #include "EEPARAMS.h"
26  #include "PTRACERS.h"  #include "PARAMS.h"
27    #include "DYNVARS.h"
28    #ifdef ALLOW_LONGSTEP
29    #include "LONGSTEP_PARAMS.h"
30    #endif
31    #include "PTRACERS_SIZE.h"
32    #include "PTRACERS_PARAMS.h"
33    #include "PTRACERS_RESTART.h"
34    #include "PTRACERS_FIELDS.h"
35  #include "GAD.h"  #include "GAD.h"
36    #ifdef ALLOW_AUTODIFF_TAMC
37    # include "tamc.h"
38    # include "tamc_keys.h"
39    #endif
40    
41  C !INPUT PARAMETERS: ===================================================  C !INPUT PARAMETERS: ===================================================
42  C  bi,bj                :: tile indices  C  bi,bj                :: tile indices
43  C  k                    :: vertical level number  C  k                    :: vertical level number
44  C  xA                   :: face area at U points in level k  C  xA                   :: face area at U points in level k
45  C  yA                   :: face area at V points in level k  C  yA                   :: face area at V points in level k
46    C  maskUp               :: mask for vertical transport
47    C  uFld,vFld,wFld       :: Local copy of velocity field (3 components)
48  C  uTrans               :: zonal transport in level k  C  uTrans               :: zonal transport in level k
49  C  vTrans               :: meridional transport in level k  C  vTrans               :: meridional transport in level k
50  C  rTrans               :: vertical transport across level k  C  rTrans               :: vertical volume transport at interface k
51  C  maskUp               :: mask for vertical transport  C  rTransKp1            :: vertical volume transport at interface k+1
52  C  KappaRtr             :: vertical diffusion of passive tracers  C  KappaRtr             :: vertical diffusion of passive tracers, interf k
53  C            NOTE!         This is infact KappaRS from thermodynamics()  C  rFlx                 :: vertical flux
 C                          and is being used only temporarily  
 C                          until we removed the need to store  
 C                          a "3D" diffusivity  
 C  myIter               :: time-step number  
54  C  myTime               :: model time  C  myTime               :: model time
55    C  myIter               :: time-step number
56  C  myThid               :: thread number  C  myThid               :: thread number
57        INTEGER bi,bj,k        INTEGER bi,bj,k
58        _RS xA      (1-OLx:sNx+OLx,1-OLy:sNy+OLy)        _RS xA      (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
59        _RS yA      (1-OLx:sNx+OLx,1-OLy:sNy+OLy)        _RS yA      (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
60          _RS maskUp  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
61          _RL uFld    (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
62          _RL vFld    (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
63          _RL wFld    (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
64        _RL uTrans  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)        _RL uTrans  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
65        _RL vTrans  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)        _RL vTrans  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
66        _RL rTrans  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)        _RL rTrans  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)
67        _RS maskUp  (1-OLx:sNx+OLx,1-OLy:sNy+OLy)        _RL rTransKp1(1-OLx:sNx+OLx,1-OLy:sNy+OLy)
68        _RL KappaRtr(1-Olx:sNx+Olx,1-Oly:sNy+Oly,Nr)        _RL KappaRtr(1-Olx:sNx+Olx,1-Oly:sNy+Oly,PTRACERS_num)
69        INTEGER myIter        _RL rFlx    (1-OLx:sNx+OLx,1-OLy:sNy+OLy,2,PTRACERS_num)
70        _RL myTime        _RL myTime
71          INTEGER myIter
72        INTEGER myThid        INTEGER myThid
73    
74  C !OUTPUT PARAMETERS: ==================================================  C !OUTPUT PARAMETERS: ==================================================
# Line 59  C  none Line 77  C  none
77  #ifdef ALLOW_PTRACERS  #ifdef ALLOW_PTRACERS
78    
79  C !LOCAL VARIABLES: ====================================================  C !LOCAL VARIABLES: ====================================================
80  C  i,j,k,bi,bj,iTracer  :: loop indices  C  iTracer              :: tracer index
81  C  iMin,iMax,jMin,jMax  :: loop ranges  C  iMin,iMax,jMin,jMax  :: loop ranges
82  C  kUp,kDown            :: toggle indices for even/odd level fluxes  C  kUp,kDown            :: toggle indices for even/odd level fluxes
83  C  km1                  :: =min(1,k-1)  C  km1                  :: =min(1,k-1)
84  C  rFlx                 :: vertical flux  C  GAD_TR               :: passive tracer id (GAD_TR1+iTracer-1)
85        INTEGER i,j,iTracer        INTEGER iTracer
86        INTEGER iMin,iMax,jMin,jMax        INTEGER iMin,iMax,jMin,jMax
87        INTEGER kUp,kDown,km1        INTEGER kUp,kDown,km1
88        _RL rFlx(1-OLx:sNx+OLx,1-OLy:sNy+OLy,2,PTRACERS_num)        INTEGER GAD_TR
89        LOGICAL calcAdvection        LOGICAL calcAdvection
90          INTEGER iterNb
91  CEOP  CEOP
92    
93    C Loop ranges for daughter routines
94          iMin = 1-OLx+2
95          iMax = sNx+OLx-1
96          jMin = 1-OLy+2
97          jMax = sNy+OLy-1
98    
99          km1  = MAX(1,k-1)
100          kUp  = 1+MOD(k+1,2)
101          kDown= 1+MOD(k,2)
102    
103  C Loop over tracers  C Loop over tracers
104        DO iTracer=1,PTRACERS_numInUse        DO iTracer=1,PTRACERS_numInUse
105    
106  C Initialize vertical flux to zero and set no-flux across k=Nr+1  #ifdef ALLOW_AUTODIFF_TAMC
107         IF (k.EQ.Nr) THEN            act0 = iTracer - 1
108          DO j=1-Oly,sNy+Oly            max0 = PTRACERS_num
109           DO i=1-Olx,sNx+Olx            act1 = bi - myBxLo(myThid)
110            rFlx(i,j,1,iTracer)=0.            max1 = myBxHi(myThid) - myBxLo(myThid) + 1
111            rFlx(i,j,2,iTracer)=0.            act2 = bj - myByLo(myThid)
112           ENDDO            max2 = myByHi(myThid) - myByLo(myThid) + 1
113          ENDDO            act3 = myThid - 1
114         ENDIF            max3 = nTx*nTy
115              act4 = ikey_dynamics - 1
116  C Loop ranges for daughter routines            iptrkey = (act0 + 1)
117         iMin = 1-OLx+2       &                      + act1*max0
118         iMax = sNx+OLx-1       &                      + act2*max0*max1
119         jMin = 1-OLy+2       &                      + act3*max0*max1*max2
120         jMax = sNy+OLy-1       &                      + act4*max0*max1*max2*max3
121              kkey = (iptrkey-1)*Nr + k
122         km1  = MAX(1,k-1)  #endif /* ALLOW_AUTODIFF_TAMC */
123         kUp  = 1+MOD(k+1,2)  
124         kDown= 1+MOD(k,2)  #ifdef ALLOW_AUTODIFF_TAMC
125          rFlx(1,1,kDown,iTracer) = rFlx(1,1,kDown,iTracer)
126    c
127    CADJ STORE pTracer(:,:,k,bi,bj,iTracer)
128    CADJ &      = comlev1_bibj_k_ptracers, key=kkey, byte=isbyte
129    CADJ STORE gpTrNm1(:,:,k,bi,bj,iTracer)
130    CADJ &      = comlev1_bibj_k_ptracers, key=kkey, byte=isbyte
131    # ifdef NONLIN_FRSURF
132    CADJ STORE gpTr(:,:,k,bi,bj,iTracer)
133    CADJ &      = comlev1_bibj_k_ptracers, key=kkey, byte=isbyte
134    CADJ STORE rFlx(:,:,:,iTracer)
135    CADJ &      = comlev1_bibj_k_ptracers, key=kkey, byte=isbyte
136    # endif
137    #endif /* ALLOW_AUTODIFF_TAMC */
138    
139  C Calculate active tracer tendencies (gPtr) due to internal processes  C Calculate active tracer tendencies (gPtr) due to internal processes
140  C (advection, [explicit] diffusion, parameterizations,...)  C (advection, [explicit] diffusion, parameterizations,...)
141         calcAdvection = .NOT.multiDimAdvection         calcAdvection = .NOT.PTRACERS_MultiDimAdv(iTracer)
142       &      .OR. PTRACERS_advScheme(iTracer).EQ.ENUM_CENTERED_2ND         GAD_TR = GAD_TR1 + iTracer - 1
143       &      .OR. PTRACERS_advScheme(iTracer).EQ.ENUM_UPWIND_3RD         CALL GAD_CALC_RHS(
144       &      .OR. PTRACERS_advScheme(iTracer).EQ.ENUM_CENTERED_4TH       I                   bi,bj,iMin,iMax,jMin,jMax,k,km1,kUp,kDown,
145           CALL GAD_CALC_RHS(       I                   xA, yA, maskUp, uFld, vFld, wFld,
146       I                     bi,bj,iMin,iMax,jMin,jMax,k,kM1,kUp,kDown,       I                   uTrans, vTrans, rTrans, rTransKp1,
147       I                     xA,yA,uTrans,vTrans,rTrans,maskUp,       I                   PTRACERS_diffKh(iTracer),
148       I                     PTRACERS_diffKh(iTracer),       I                   PTRACERS_diffK4(iTracer),
149       I                     PTRACERS_diffK4(iTracer),       I                   KappaRtr(1-Olx,1-Oly,iTracer),
150       I                     KappaRtr,       I                   gpTrNm1(1-Olx,1-Oly,1,1,1,iTracer),
151       I                     pTracer(1-Olx,1-Oly,1,1,1,iTracer),       I                   pTracer(1-Olx,1-Oly,1,1,1,iTracer),
152       I                     GAD_TR1,       I                   PTRACERS_dTLev, GAD_TR,
153       I                     PTRACERS_advScheme(iTracer),calcAdvection,       I                   PTRACERS_advScheme(iTracer),
154       U                     rFlx(1-Olx,1-Oly,1,iTracer),       I                   PTRACERS_advScheme(iTracer),
155       U                     gPtr(1-Olx,1-Oly,1,1,1,iTracer),       I                   calcAdvection, PTRACERS_ImplVertAdv(iTracer),
156       I                     myThid )       I                   .FALSE.,
157         I                   PTRACERS_useGMRedi(iTracer),
158         I                   PTRACERS_useKPP(iTracer),
159         U                   rFlx(1-Olx,1-Oly,1,iTracer),
160         U                   gPtr(1-Olx,1-Oly,1,1,1,iTracer),
161         I                   myTime, myIter, myThid )
162    
163  C External forcing term(s)  C External forcing term(s)
164         IF ( forcing_In_AB )         IF ( tracForcingOutAB.NE.1 )
165       &   CALL PTRACERS_FORCING(       &   CALL PTRACERS_FORCING(
166       I                        bi,bj,k,iTracer,       I                      bi,bj,iMin,iMax,jMin,jMax,k,iTracer,
167       U                        gPtr(1-Olx,1-Oly,1,1,1,iTracer),       U                      gPtr(1-Olx,1-Oly,1,1,1,iTracer),
168       I                        myIter,myTime,myThid)       I                      surfaceForcingPTr(1-Olx,1-Oly,1,1,iTracer),
169         I                      myIter,myTime,myThid)
170  C If using Adams-Bashforth II, then extrapolate tendancies  
171        IF ( PTRACERS_advScheme(iTracer).EQ.ENUM_CENTERED_2ND  C If using Adams-Bashforth II, then extrapolate tendencies
172       & .OR.PTRACERS_advScheme(iTracer).EQ.ENUM_UPWIND_3RD  C gPtr is now the tracer tendency for explicit advection/diffusion
173       & .OR.PTRACERS_advScheme(iTracer).EQ.ENUM_CENTERED_4TH ) THEN        IF ( PTRACERS_AdamsBashGtr(iTracer) ) THEN
174    #ifdef ALLOW_MATRIX
175    C  If matrix is being computed, block call to S/R ADAMS_BASHFORTH2 to
176    C  prevent gPtr from being replaced by the average of gPtr and gpTrNm1.
177            IF (.NOT.useMATRIX) THEN
178    #endif
179    C       compute iter at beginning of ptracer time step
180    #ifdef ALLOW_LONGSTEP
181            iterNb = myIter - LS_nIter + 1
182            IF (LS_whenToSample.GE.2) iterNb = myIter - LS_nIter
183    #else
184            iterNb = myIter
185            IF (staggerTimeStep) iterNb = myIter - 1
186    #endif
187          CALL ADAMS_BASHFORTH2(          CALL ADAMS_BASHFORTH2(
188       I                        bi,bj,K,       I                      bi,bj,K,
189       U                        gPtr(1-Olx,1-Oly,1,1,1,iTracer),       U                      gPtr(1-Olx,1-Oly,1,1,1,iTracer),
190       U                        gPtrNm1(1-Olx,1-Oly,1,1,1,iTracer),       U                      gpTrNm1(1-Olx,1-Oly,1,1,1,iTracer),
191       I                        myIter,myThid )       I                      PTRACERS_startAB(iTracer), iterNb, myThid )
192    #ifdef ALLOW_MATRIX
193            ENDIF
194    #endif
195        ENDIF        ENDIF
196    
197  C External forcing term(s)  C External forcing term(s)
198         IF ( .NOT.forcing_In_AB )         IF ( tracForcingOutAB.EQ.1 )
199       &   CALL PTRACERS_FORCING(       &   CALL PTRACERS_FORCING(
200       I                        bi,bj,k,iTracer,       I                      bi,bj,iMin,iMax,jMin,jMax,k,iTracer,
201       U                        gPtr(1-Olx,1-Oly,1,1,1,iTracer),       U                      gPtr(1-Olx,1-Oly,1,1,1,iTracer),
202       I                        myIter,myTime,myThid)       I                      surfaceForcingPTr(1-Olx,1-Oly,1,1,iTracer),
203         I                      myIter,myTime,myThid)
204    
205  #ifdef NONLIN_FRSURF  #ifdef NONLIN_FRSURF
206  C Account for change in level thickness  C Account for change in level thickness
# Line 145  C Account for change in level thickness Line 209  C Account for change in level thickness
209       I                          bi,bj,K,       I                          bi,bj,K,
210       U                          gPtr(1-Olx,1-Oly,1,1,1,iTracer),       U                          gPtr(1-Olx,1-Oly,1,1,1,iTracer),
211       I                          myThid )       I                          myThid )
212            IF ( PTRACERS_AdamsBashGtr(iTracer) )
213         &  CALL FREESURF_RESCALE_G(
214         I                          bi,bj,K,
215         U                          gpTrNm1(1-Olx,1-Oly,1,1,1,iTracer),
216         I                          myThid )
217        ENDIF        ENDIF
218  #endif /* NONLIN_FRSURF */  #endif /* NONLIN_FRSURF */
219    
# Line 152  C Integrate forward in time, storing in Line 221  C Integrate forward in time, storing in
221           CALL TIMESTEP_TRACER(           CALL TIMESTEP_TRACER(
222       I                        bi,bj,iMin,iMax,jMin,jMax,k,       I                        bi,bj,iMin,iMax,jMin,jMax,k,
223       I                        PTRACERS_advScheme(iTracer),       I                        PTRACERS_advScheme(iTracer),
224         I                        PTRACERS_dTLev(k),
225       I                        pTracer(1-Olx,1-Oly,1,1,1,iTracer),       I                        pTracer(1-Olx,1-Oly,1,1,1,iTracer),
226       I                        gPtr(1-Olx,1-Oly,1,1,1,iTracer),       I                        gPtr(1-Olx,1-Oly,1,1,1,iTracer),
227       I                        myIter,myThid )       I                        myIter,myThid )
Legend:
Removed from v.1.3  
changed lines
  Added in v.1.42
  ViewVC Help
Powered by ViewVC 1.1.22