/[MITgcm]/MITgcm/model/src/dynamics.F
ViewVC logotype

Diff of /MITgcm/model/src/dynamics.F

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

revision 1.81 by adcroft, Wed Sep 19 02:43:27 2001 UTC revision 1.88 by heimbach, Sat Jul 13 04:59:42 2002 UTC
# Line 3  C $Name$ Line 3  C $Name$
3    
4  #include "CPP_OPTIONS.h"  #include "CPP_OPTIONS.h"
5    
6    CBOP
7    C     !ROUTINE: DYNAMICS
8    C     !INTERFACE:
9        SUBROUTINE DYNAMICS(myTime, myIter, myThid)        SUBROUTINE DYNAMICS(myTime, myIter, myThid)
10  C     /==========================================================\  C     !DESCRIPTION: \bv
11  C     | SUBROUTINE DYNAMICS                                      |  C     *==========================================================*
12  C     | o Controlling routine for the explicit part of the model |  C     | SUBROUTINE DYNAMICS                                      
13  C     |   dynamics.                                              |  C     | o Controlling routine for the explicit part of the model  
14  C     |==========================================================|  C     |   dynamics.                                              
15  C     | This routine evaluates the "dynamics" terms for each     |  C     *==========================================================*
16  C     | block of ocean in turn. Because the blocks of ocean have |  C     | This routine evaluates the "dynamics" terms for each      
17  C     | overlap regions they are independent of one another.     |  C     | block of ocean in turn. Because the blocks of ocean have  
18  C     | If terms involving lateral integrals are needed in this  |  C     | overlap regions they are independent of one another.      
19  C     | routine care will be needed. Similarly finite-difference |  C     | If terms involving lateral integrals are needed in this  
20  C     | operations with stencils wider than the overlap region   |  C     | routine care will be needed. Similarly finite-difference  
21  C     | require special consideration.                           |  C     | operations with stencils wider than the overlap region    
22  C     | Notes                                                    |  C     | require special consideration.                            
23  C     | =====                                                    |  C     | The algorithm...
24  C     | C*P* comments indicating place holders for which code is |  C     |
25  C     |      presently being developed.                          |  C     | "Correction Step"
26  C     \==========================================================/  C     | =================
27    C     | Here we update the horizontal velocities with the surface
28    C     | pressure such that the resulting flow is either consistent
29    C     | with the free-surface evolution or the rigid-lid:
30    C     |   U[n] = U* + dt x d/dx P
31    C     |   V[n] = V* + dt x d/dy P
32    C     |
33    C     | "Calculation of Gs"
34    C     | ===================
35    C     | This is where all the accelerations and tendencies (ie.
36    C     | physics, parameterizations etc...) are calculated
37    C     |   rho = rho ( theta[n], salt[n] )
38    C     |   b   = b(rho, theta)
39    C     |   K31 = K31 ( rho )
40    C     |   Gu[n] = Gu( u[n], v[n], wVel, b, ... )
41    C     |   Gv[n] = Gv( u[n], v[n], wVel, b, ... )
42    C     |   Gt[n] = Gt( theta[n], u[n], v[n], wVel, K31, ... )
43    C     |   Gs[n] = Gs( salt[n], u[n], v[n], wVel, K31, ... )
44    C     |
45    C     | "Time-stepping" or "Prediction"
46    C     | ================================
47    C     | The models variables are stepped forward with the appropriate
48    C     | time-stepping scheme (currently we use Adams-Bashforth II)
49    C     | - For momentum, the result is always *only* a "prediction"
50    C     | in that the flow may be divergent and will be "corrected"
51    C     | later with a surface pressure gradient.
52    C     | - Normally for tracers the result is the new field at time
53    C     | level [n+1} *BUT* in the case of implicit diffusion the result
54    C     | is also *only* a prediction.
55    C     | - We denote "predictors" with an asterisk (*).
56    C     |   U* = U[n] + dt x ( 3/2 Gu[n] - 1/2 Gu[n-1] )
57    C     |   V* = V[n] + dt x ( 3/2 Gv[n] - 1/2 Gv[n-1] )
58    C     |   theta[n+1] = theta[n] + dt x ( 3/2 Gt[n] - 1/2 atG[n-1] )
59    C     |   salt[n+1] = salt[n] + dt x ( 3/2 Gt[n] - 1/2 atG[n-1] )
60    C     | With implicit diffusion:
61    C     |   theta* = theta[n] + dt x ( 3/2 Gt[n] - 1/2 atG[n-1] )
62    C     |   salt* = salt[n] + dt x ( 3/2 Gt[n] - 1/2 atG[n-1] )
63    C     |   (1 + dt * K * d_zz) theta[n] = theta*
64    C     |   (1 + dt * K * d_zz) salt[n] = salt*
65    C     |
66    C     *==========================================================*
67    C     \ev
68    C     !USES:
69        IMPLICIT NONE        IMPLICIT NONE
   
70  C     == Global variables ===  C     == Global variables ===
71  #include "SIZE.h"  #include "SIZE.h"
72  #include "EEPARAMS.h"  #include "EEPARAMS.h"
# Line 32  C     == Global variables === Line 76  C     == Global variables ===
76  #ifdef ALLOW_PASSIVE_TRACER  #ifdef ALLOW_PASSIVE_TRACER
77  #include "TR1.h"  #include "TR1.h"
78  #endif  #endif
   
79  #ifdef ALLOW_AUTODIFF_TAMC  #ifdef ALLOW_AUTODIFF_TAMC
80  # include "tamc.h"  # include "tamc.h"
81  # include "tamc_keys.h"  # include "tamc_keys.h"
# Line 40  C     == Global variables === Line 83  C     == Global variables ===
83  # ifdef ALLOW_KPP  # ifdef ALLOW_KPP
84  #  include "KPP.h"  #  include "KPP.h"
85  # endif  # endif
 # ifdef ALLOW_GMREDI  
 #  include "GMREDI.h"  
 # endif  
86  #endif /* ALLOW_AUTODIFF_TAMC */  #endif /* ALLOW_AUTODIFF_TAMC */
   
87  #ifdef ALLOW_TIMEAVE  #ifdef ALLOW_TIMEAVE
88  #include "TIMEAVE_STATV.h"  #include "TIMEAVE_STATV.h"
89  #endif  #endif
90    
91    C     !CALLING SEQUENCE:
92    C     DYNAMICS()
93    C      |
94    C      |-- CALC_GRAD_PHI_SURF
95    C      |
96    C      |-- CALC_VISCOSITY
97    C      |
98    C      |-- CALC_PHI_HYD  
99    C      |
100    C      |-- MOM_FLUXFORM  
101    C      |
102    C      |-- MOM_VECINV    
103    C      |
104    C      |-- TIMESTEP      
105    C      |
106    C      |-- OBCS_APPLY_UV
107    C      |
108    C      |-- IMPLDIFF      
109    C      |
110    C      |-- OBCS_APPLY_UV
111    C      |
112    C      |-- CALL TIMEAVE_CUMUL_1T
113    C      |-- CALL DEBUG_STATS_RL
114    
115    C     !INPUT/OUTPUT PARAMETERS:
116  C     == Routine arguments ==  C     == Routine arguments ==
117  C     myTime - Current time in simulation  C     myTime - Current time in simulation
118  C     myIter - Current iteration number in simulation  C     myIter - Current iteration number in simulation
# Line 57  C     myThid - Thread number for this in Line 121  C     myThid - Thread number for this in
121        INTEGER myIter        INTEGER myIter
122        INTEGER myThid        INTEGER myThid
123    
124    C     !LOCAL VARIABLES:
125  C     == Local variables  C     == Local variables
126  C     fVer[STUV]               o fVer: Vertical flux term - note fVer  C     fVer[STUV]               o fVer: Vertical flux term - note fVer
127  C                                      is "pipelined" in the vertical  C                                      is "pipelined" in the vertical
# Line 85  C                      index into fVerTe Line 150  C                      index into fVerTe
150        _RL phiSurfY(1-OLx:sNx+OLx,1-OLy:sNy+OLy)        _RL phiSurfY(1-OLx:sNx+OLx,1-OLy:sNy+OLy)
151        _RL KappaRU (1-Olx:sNx+Olx,1-Oly:sNy+Oly,Nr)        _RL KappaRU (1-Olx:sNx+Olx,1-Oly:sNy+Oly,Nr)
152        _RL KappaRV (1-Olx:sNx+Olx,1-Oly:sNy+Oly,Nr)        _RL KappaRV (1-Olx:sNx+Olx,1-Oly:sNy+Oly,Nr)
       _RL sigmaX  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr)  
       _RL sigmaY  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr)  
       _RL sigmaR  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr)  
   
 C This is currently used by IVDC and Diagnostics  
       _RL ConvectCount (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr)  
153    
154        INTEGER iMin, iMax        INTEGER iMin, iMax
155        INTEGER jMin, jMax        INTEGER jMin, jMax
# Line 147  C         salt* = salt[n] + dt x ( 3/2 G Line 206  C         salt* = salt[n] + dt x ( 3/2 G
206  C         (1 + dt * K * d_zz) theta[n] = theta*  C         (1 + dt * K * d_zz) theta[n] = theta*
207  C         (1 + dt * K * d_zz) salt[n] = salt*  C         (1 + dt * K * d_zz) salt[n] = salt*
208  C---  C---
209    CEOP
210    
211  C--   Set up work arrays with valid (i.e. not NaN) values  C--   Set up work arrays with valid (i.e. not NaN) values
212  C     These inital values do not alter the numerical results. They  C     These inital values do not alter the numerical results. They
# Line 155  C     point numbers. This prevents spuri Line 215  C     point numbers. This prevents spuri
215  C     uninitialised but inert locations.  C     uninitialised but inert locations.
216        DO j=1-OLy,sNy+OLy        DO j=1-OLy,sNy+OLy
217         DO i=1-OLx,sNx+OLx         DO i=1-OLx,sNx+OLx
         DO k=1,Nr  
          phiHyd(i,j,k)  = 0. _d 0  
          KappaRU(i,j,k) = 0. _d 0  
          KappaRV(i,j,k) = 0. _d 0  
          sigmaX(i,j,k) = 0. _d 0  
          sigmaY(i,j,k) = 0. _d 0  
          sigmaR(i,j,k) = 0. _d 0  
         ENDDO  
218          rhoKM1 (i,j) = 0. _d 0          rhoKM1 (i,j) = 0. _d 0
219          rhok   (i,j) = 0. _d 0          rhok   (i,j) = 0. _d 0
220          phiSurfX(i,j) = 0. _d 0          phiSurfX(i,j) = 0. _d 0
# Line 170  C     uninitialised but inert locations. Line 222  C     uninitialised but inert locations.
222         ENDDO         ENDDO
223        ENDDO        ENDDO
224    
225    C-- Call to routine for calculation of
226    C   Eliassen-Palm-flux-forced U-tendency,
227    C   if desired:
228    #ifdef INCLUDE_EP_FORCING_CODE
229          CALL CALC_EP_FORCING(myThid)
230    #endif
231    
232  #ifdef ALLOW_AUTODIFF_TAMC  #ifdef ALLOW_AUTODIFF_TAMC
233  C--   HPF directive to help TAMC  C--   HPF directive to help TAMC
234  CHPF$ INDEPENDENT  CHPF$ INDEPENDENT
# Line 190  CHPF$&                  ) Line 249  CHPF$&                  )
249  #ifdef ALLOW_AUTODIFF_TAMC  #ifdef ALLOW_AUTODIFF_TAMC
250            act1 = bi - myBxLo(myThid)            act1 = bi - myBxLo(myThid)
251            max1 = myBxHi(myThid) - myBxLo(myThid) + 1            max1 = myBxHi(myThid) - myBxLo(myThid) + 1
   
252            act2 = bj - myByLo(myThid)            act2 = bj - myByLo(myThid)
253            max2 = myByHi(myThid) - myByLo(myThid) + 1            max2 = myByHi(myThid) - myByLo(myThid) + 1
   
254            act3 = myThid - 1            act3 = myThid - 1
255            max3 = nTx*nTy            max3 = nTx*nTy
   
256            act4 = ikey_dynamics - 1            act4 = ikey_dynamics - 1
   
257            ikey = (act1 + 1) + act2*max1            ikey = (act1 + 1) + act2*max1
258       &                      + act3*max1*max2       &                      + act3*max1*max2
259       &                      + act4*max1*max2*max3       &                      + act4*max1*max2*max3
# Line 207  CHPF$&                  ) Line 262  CHPF$&                  )
262  C--     Set up work arrays that need valid initial values  C--     Set up work arrays that need valid initial values
263          DO j=1-OLy,sNy+OLy          DO j=1-OLy,sNy+OLy
264           DO i=1-OLx,sNx+OLx           DO i=1-OLx,sNx+OLx
265              DO k=1,Nr
266               phiHyd(i,j,k)  = 0. _d 0
267               KappaRU(i,j,k) = 0. _d 0
268               KappaRV(i,j,k) = 0. _d 0
269              ENDDO
270            fVerU  (i,j,1) = 0. _d 0            fVerU  (i,j,1) = 0. _d 0
271            fVerU  (i,j,2) = 0. _d 0            fVerU  (i,j,2) = 0. _d 0
272            fVerV  (i,j,1) = 0. _d 0            fVerV  (i,j,1) = 0. _d 0
# Line 221  C--     Start computation of dynamics Line 281  C--     Start computation of dynamics
281          jMax = sNy+OLy-1          jMax = sNy+OLy-1
282    
283  #ifdef ALLOW_AUTODIFF_TAMC  #ifdef ALLOW_AUTODIFF_TAMC
 CADJ STORE uvel (:,:,:,bi,bj) = comlev1_bibj, key = ikey, byte = isbyte  
 CADJ STORE vvel (:,:,:,bi,bj) = comlev1_bibj, key = ikey, byte = isbyte  
284  CADJ STORE wvel (:,:,:,bi,bj) = comlev1_bibj, key = ikey, byte = isbyte  CADJ STORE wvel (:,:,:,bi,bj) = comlev1_bibj, key = ikey, byte = isbyte
285  #endif /* ALLOW_AUTODIFF_TAMC */  #endif /* ALLOW_AUTODIFF_TAMC */
286    
# Line 236  C       (note: this loop will be replace Line 294  C       (note: this loop will be replace
294       I         myThid )                               I         myThid )                        
295          ENDIF          ENDIF
296    
297    #ifdef ALLOW_AUTODIFF_TAMC
298    CADJ STORE uvel (:,:,:,bi,bj) = comlev1_bibj, key=ikey, byte=isbyte
299    CADJ STORE vvel (:,:,:,bi,bj) = comlev1_bibj, key=ikey, byte=isbyte
300    #ifdef ALLOW_KPP
301    CADJ STORE KPPviscAz (:,:,:,bi,bj)
302    CADJ &                 = comlev1_bibj, key=ikey, byte=isbyte
303    #endif /* ALLOW_KPP */
304    #endif /* ALLOW_AUTODIFF_TAMC */
305    
306  #ifdef  INCLUDE_CALC_DIFFUSIVITY_CALL  #ifdef  INCLUDE_CALC_DIFFUSIVITY_CALL
307  C--      Calculate the total vertical diffusivity  C--      Calculate the total vertical diffusivity
308          DO k=1,Nr          DO k=1,Nr
# Line 325  C--      Apply open boundary conditions Line 392  C--      Apply open boundary conditions
392  C--     end of dynamics k loop (1:Nr)  C--     end of dynamics k loop (1:Nr)
393          ENDDO          ENDDO
394    
   
   
395  C--     Implicit viscosity  C--     Implicit viscosity
396          IF (implicitViscosity.AND.momStepping) THEN          IF (implicitViscosity.AND.momStepping) THEN
397  #ifdef    ALLOW_AUTODIFF_TAMC  #ifdef    ALLOW_AUTODIFF_TAMC
           idkey = iikey + 3  
398  CADJ STORE gUNm1(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte  CADJ STORE gUNm1(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte
399  #endif    /* ALLOW_AUTODIFF_TAMC */  #endif    /* ALLOW_AUTODIFF_TAMC */
400            CALL IMPLDIFF(            CALL IMPLDIFF(
# Line 339  CADJ STORE gUNm1(:,:,:,bi,bj) = comlev1_ Line 403  CADJ STORE gUNm1(:,:,:,bi,bj) = comlev1_
403       U         gUNm1,       U         gUNm1,
404       I         myThid )       I         myThid )
405  #ifdef    ALLOW_AUTODIFF_TAMC  #ifdef    ALLOW_AUTODIFF_TAMC
           idkey = iikey + 4  
406  CADJ STORE gVNm1(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte  CADJ STORE gVNm1(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte
407  #endif    /* ALLOW_AUTODIFF_TAMC */  #endif    /* ALLOW_AUTODIFF_TAMC */
408            CALL IMPLDIFF(            CALL IMPLDIFF(
# Line 359  C--      Apply open boundary conditions Line 422  C--      Apply open boundary conditions
422    
423  #ifdef    INCLUDE_CD_CODE  #ifdef    INCLUDE_CD_CODE
424  #ifdef    ALLOW_AUTODIFF_TAMC  #ifdef    ALLOW_AUTODIFF_TAMC
           idkey = iikey + 5  
425  CADJ STORE vVelD(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte  CADJ STORE vVelD(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte
426  #endif    /* ALLOW_AUTODIFF_TAMC */  #endif    /* ALLOW_AUTODIFF_TAMC */
427            CALL IMPLDIFF(            CALL IMPLDIFF(
# Line 368  CADJ STORE vVelD(:,:,:,bi,bj) = comlev1_ Line 430  CADJ STORE vVelD(:,:,:,bi,bj) = comlev1_
430       U         vVelD,       U         vVelD,
431       I         myThid )       I         myThid )
432  #ifdef    ALLOW_AUTODIFF_TAMC  #ifdef    ALLOW_AUTODIFF_TAMC
           idkey = iikey + 6  
433  CADJ STORE uVelD(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte  CADJ STORE uVelD(:,:,:,bi,bj) = comlev1_bibj , key=ikey, byte=isbyte
434  #endif    /* ALLOW_AUTODIFF_TAMC */  #endif    /* ALLOW_AUTODIFF_TAMC */
435            CALL IMPLDIFF(            CALL IMPLDIFF(
# Line 392  Cjmc(end) Line 453  Cjmc(end)
453          IF (taveFreq.GT.0.) THEN          IF (taveFreq.GT.0.) THEN
454            CALL TIMEAVE_CUMUL_1T(phiHydtave, phiHyd, Nr,            CALL TIMEAVE_CUMUL_1T(phiHydtave, phiHyd, Nr,
455       I                              deltaTclock, bi, bj, myThid)       I                              deltaTclock, bi, bj, myThid)
           IF (ivdc_kappa.NE.0.) THEN  
             CALL TIMEAVE_CUMULATE(ConvectCountTave, ConvectCount, Nr,  
      I                              deltaTclock, bi, bj, myThid)  
           ENDIF  
456          ENDIF          ENDIF
457  #endif /* ALLOW_TIMEAVE */  #endif /* ALLOW_TIMEAVE */
458    
Legend:
Removed from v.1.81  
changed lines
  Added in v.1.88
  ViewVC Help
Powered by ViewVC 1.1.22