1 |
C $Header: /u/gcmpack/models/MITgcmUV/model/src/dynamics.F,v 1.5 1998/05/04 16:32:10 adcroft Exp $ |
2 |
|
3 |
#include "CPP_EEOPTIONS.h" |
4 |
|
5 |
SUBROUTINE DYNAMICS(myThid) |
6 |
C /==========================================================\ |
7 |
C | SUBROUTINE DYNAMICS | |
8 |
C | o Controlling routine for the explicit part of the model | |
9 |
C | dynamics. | |
10 |
C |==========================================================| |
11 |
C | This routine evaluates the "dynamics" terms for each | |
12 |
C | block of ocean in turn. Because the blocks of ocean have | |
13 |
C | overlap regions they are independent of one another. | |
14 |
C | If terms involving lateral integrals are needed in this | |
15 |
C | routine care will be needed. Similarly finite-difference | |
16 |
C | operations with stencils wider than the overlap region | |
17 |
C | require special consideration. | |
18 |
C | Notes | |
19 |
C | ===== | |
20 |
C | C*P* comments indicating place holders for which code is | |
21 |
C | presently being developed. | |
22 |
C \==========================================================/ |
23 |
|
24 |
C == Global variables === |
25 |
#include "SIZE.h" |
26 |
#include "EEPARAMS.h" |
27 |
#include "CG2D.h" |
28 |
#include "PARAMS.h" |
29 |
#include "DYNVARS.h" |
30 |
|
31 |
C == Routine arguments == |
32 |
C myThid - Thread number for this instance of the routine. |
33 |
INTEGER myThid |
34 |
|
35 |
C == Local variables |
36 |
C xA, yA - Per block temporaries holding face areas |
37 |
C uTrans, vTrans, wTrans - Per block temporaries holding flow transport |
38 |
C o uTrans: Zonal transport |
39 |
C o vTrans: Meridional transport |
40 |
C o wTrans: Vertical transport |
41 |
C maskC,maskUp o maskC: land/water mask for tracer cells |
42 |
C o maskUp: land/water mask for W points |
43 |
C aTerm, xTerm, cTerm - Work arrays for holding separate terms in |
44 |
C mTerm, pTerm, tendency equations. |
45 |
C fZon, fMer, fVer[STUV] o aTerm: Advection term |
46 |
C o xTerm: Mixing term |
47 |
C o cTerm: Coriolis term |
48 |
C o mTerm: Metric term |
49 |
C o pTerm: Pressure term |
50 |
C o fZon: Zonal flux term |
51 |
C o fMer: Meridional flux term |
52 |
C o fVer: Vertical flux term - note fVer |
53 |
C is "pipelined" in the vertical |
54 |
C so we need an fVer for each |
55 |
C variable. |
56 |
C iMin, iMax - Ranges and sub-block indices on which calculations |
57 |
C jMin, jMax are applied. |
58 |
C bi, bj |
59 |
C k, kUp, kDown, kM1 - Index for layer above and below. kUp and kDown |
60 |
C are switched with layer to be the appropriate index |
61 |
C into fVerTerm |
62 |
_RS xA (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
63 |
_RS yA (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
64 |
_RL uTrans(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
65 |
_RL vTrans(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
66 |
_RL wTrans(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
67 |
_RS maskC (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
68 |
_RS maskUp(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
69 |
_RL aTerm (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
70 |
_RL xTerm (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
71 |
_RL cTerm (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
72 |
_RL mTerm (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
73 |
_RL pTerm (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
74 |
_RL fZon (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
75 |
_RL fMer (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
76 |
_RL fVerT (1-OLx:sNx+OLx,1-OLy:sNy+OLy,2) |
77 |
_RL fVerS (1-OLx:sNx+OLx,1-OLy:sNy+OLy,2) |
78 |
_RL fVerU (1-OLx:sNx+OLx,1-OLy:sNy+OLy,2) |
79 |
_RL fVerV (1-OLx:sNx+OLx,1-OLy:sNy+OLy,2) |
80 |
_RL pH (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nz) |
81 |
_RL rhokm1(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
82 |
_RL rhokp1(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
83 |
_RL pSurfX(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
84 |
_RL pSurfY(1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
85 |
_RL K13 (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nz) |
86 |
_RL K23 (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nz) |
87 |
_RL K33 (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nz) |
88 |
_RL KapGM (1-OLx:sNx+OLx,1-OLy:sNy+OLy) |
89 |
INTEGER iMin, iMax |
90 |
INTEGER jMin, jMax |
91 |
INTEGER bi, bj |
92 |
INTEGER i, j |
93 |
INTEGER k, kM1, kUp, kDown |
94 |
|
95 |
C-- Set up work arrays with valid (i.e. not NaN) values |
96 |
C These inital values do not alter the numerical results. They |
97 |
C just ensure that all memory references are to valid floating |
98 |
C point numbers. This prevents spurious hardware signals due to |
99 |
C uninitialised but inert locations. |
100 |
DO j=1-OLy,sNy+OLy |
101 |
DO i=1-OLx,sNx+OLx |
102 |
xA(i,j) = 0. _d 0 |
103 |
yA(i,j) = 0. _d 0 |
104 |
uTrans(i,j) = 0. _d 0 |
105 |
vTrans(i,j) = 0. _d 0 |
106 |
aTerm(i,j) = 0. _d 0 |
107 |
xTerm(i,j) = 0. _d 0 |
108 |
cTerm(i,j) = 0. _d 0 |
109 |
mTerm(i,j) = 0. _d 0 |
110 |
pTerm(i,j) = 0. _d 0 |
111 |
fZon(i,j) = 0. _d 0 |
112 |
fMer(i,j) = 0. _d 0 |
113 |
DO K=1,nZ |
114 |
pH (i,j,k) = 0. _d 0 |
115 |
K13(i,j,k) = 0. _d 0 |
116 |
K23(i,j,k) = 0. _d 0 |
117 |
K33(i,j,k) = 0. _d 0 |
118 |
ENDDO |
119 |
rhokm1(i,j) = 0. _d 0 |
120 |
rhokp1(i,j) = 0. _d 0 |
121 |
ENDDO |
122 |
ENDDO |
123 |
C-- Set up work arrays that need valid initial values |
124 |
DO j=1-OLy,sNy+OLy |
125 |
DO i=1-OLx,sNx+OLx |
126 |
wTrans(i,j) = 0. _d 0 |
127 |
fVerT(i,j,1) = 0. _d 0 |
128 |
fVerT(i,j,2) = 0. _d 0 |
129 |
fVerS(i,j,1) = 0. _d 0 |
130 |
fVerS(i,j,2) = 0. _d 0 |
131 |
fVerU(i,j,1) = 0. _d 0 |
132 |
fVerU(i,j,2) = 0. _d 0 |
133 |
fVerV(i,j,1) = 0. _d 0 |
134 |
fVerV(i,j,2) = 0. _d 0 |
135 |
ENDDO |
136 |
ENDDO |
137 |
|
138 |
DO bj=myByLo(myThid),myByHi(myThid) |
139 |
DO bi=myBxLo(myThid),myBxHi(myThid) |
140 |
|
141 |
C-- Boundary condition on hydrostatic pressure is pH(z=0)=0 |
142 |
DO j=1-OLy,sNy+OLy |
143 |
DO i=1-OLx,sNx+OLx |
144 |
pH(i,j,1) = 0. _d 0 |
145 |
K13(i,j,1) = 0. _d 0 |
146 |
K23(i,j,1) = 0. _d 0 |
147 |
K33(i,j,1) = 0. _d 0 |
148 |
KapGM(i,j) = 0. _d 0 |
149 |
ENDDO |
150 |
ENDDO |
151 |
|
152 |
iMin = 1-OLx+1 |
153 |
iMax = sNx+OLx |
154 |
jMin = 1-OLy+1 |
155 |
jMax = sNy+OLy |
156 |
|
157 |
C-- Calculate gradient of surface pressure |
158 |
CALL GRAD_PSURF( |
159 |
I bi,bj,iMin,iMax,jMin,jMax, |
160 |
O pSurfX,pSurfY, |
161 |
I myThid) |
162 |
|
163 |
C-- Update fields in top level according to tendency terms |
164 |
CALL TIMESTEP( |
165 |
I bi,bj,iMin,iMax,jMin,jMax,1,pSurfX,pSurfY,myThid) |
166 |
|
167 |
C Density of 1st level (below W(1)) reference to level 1 |
168 |
CALL FIND_RHO( |
169 |
I bi, bj, iMin, iMax, jMin, jMax, 1, 1, 'LINEAR', |
170 |
O rhoKm1, |
171 |
I myThid ) |
172 |
C-- Integrate hydrostatic balance for pH with BC of pH(z=0)=0 |
173 |
CALL CALC_PH( |
174 |
I bi,bj,iMin,iMax,jMin,jMax,1,rhoKm1,rhoKm1, |
175 |
U pH, |
176 |
I myThid ) |
177 |
|
178 |
DO K=2,Nz |
179 |
C-- Update fields in Kth level according to tendency terms |
180 |
CALL TIMESTEP( |
181 |
I bi,bj,iMin,iMax,jMin,jMax,K,pSurfX,pSurfY,myThid) |
182 |
C Density of K-1 level (above W(K)) reference to K level |
183 |
CALL FIND_RHO( |
184 |
I bi, bj, iMin, iMax, jMin, jMax, K-1, K, 'LINEAR', |
185 |
O rhoKm1, |
186 |
I myThid ) |
187 |
C Density of K level (below W(K)) reference to K level |
188 |
CALL FIND_RHO( |
189 |
I bi, bj, iMin, iMax, jMin, jMax, K, K, 'LINEAR', |
190 |
O rhoKp1, |
191 |
I myThid ) |
192 |
C-- Calculate iso-neutral slopes for the GM/Redi parameterisation |
193 |
CALL CALC_ISOSLOPES( |
194 |
I bi, bj, iMin, iMax, jMin, jMax, K, |
195 |
I rhoKm1, rhoKp1, |
196 |
O K13, K23, K33, KapGM, |
197 |
I myThid ) |
198 |
C-- Calculate static stability and mix where convectively unstable |
199 |
CALL CONVECT( |
200 |
I bi,bj,iMin,iMax,jMin,jMax,K,rhoKm1,rhoKp1,myThid) |
201 |
C Density of K-1 level (above W(K)) reference to K-1 level |
202 |
CALL FIND_RHO( |
203 |
I bi, bj, iMin, iMax, jMin, jMax, K-1, K-1, 'LINEAR', |
204 |
O rhoKm1, |
205 |
I myThid ) |
206 |
C Density of K level (below W(K)) referenced to K level |
207 |
CALL FIND_RHO( |
208 |
I bi, bj, iMin, iMax, jMin, jMax, K, K, 'LINEAR', |
209 |
O rhoKp1, |
210 |
I myThid ) |
211 |
C-- Integrate hydrostatic balance for pH with BC of pH(z=0)=0 |
212 |
CALL CALC_PH( |
213 |
I bi,bj,iMin,iMax,jMin,jMax,K,rhoKm1,rhoKp1, |
214 |
U pH, |
215 |
I myThid ) |
216 |
|
217 |
ENDDO ! K |
218 |
|
219 |
DO K = Nz, 1, -1 |
220 |
kM1 =max(1,k-1) ! Points to level above k (=k-1) |
221 |
kUp =1+MOD(k+1,2) ! Cycles through 1,2 to point to layer above |
222 |
kDown=1+MOD(k,2) ! Cycles through 2,1 to point to current layer |
223 |
iMin = 1-OLx+2 |
224 |
iMax = sNx+OLx-1 |
225 |
jMin = 1-OLy+2 |
226 |
jMax = sNy+OLy-1 |
227 |
|
228 |
C-- Get temporary terms used by tendency routines |
229 |
CALL CALC_COMMON_FACTORS ( |
230 |
I bi,bj,iMin,iMax,jMin,jMax,k,kM1,kUp,kDown, |
231 |
O xA,yA,uTrans,vTrans,wTrans,maskC,maskUp, |
232 |
I myThid) |
233 |
|
234 |
C-- Calculate accelerations in the momentum equations |
235 |
CALL CALC_MOM_RHS( |
236 |
I bi,bj,iMin,iMax,jMin,jMax,k,kM1,kUp,kDown, |
237 |
I xA,yA,uTrans,vTrans,wTrans,maskC, |
238 |
I pH, |
239 |
U aTerm,xTerm,cTerm,mTerm,pTerm, |
240 |
U fZon, fMer, fVerU, fVerV, |
241 |
I myThid) |
242 |
|
243 |
C-- Calculate active tracer tendencies |
244 |
CALL CALC_GT( |
245 |
I bi,bj,iMin,iMax,jMin,jMax, k,kM1,kUp,kDown, |
246 |
I xA,yA,uTrans,vTrans,wTrans,maskUp, |
247 |
I K13,K23,K33,KapGM, |
248 |
U aTerm,xTerm,fZon,fMer,fVerT, |
249 |
I myThid) |
250 |
Cdbg CALL CALC_GS( |
251 |
Cdbg I bi,bj,iMin,iMax,jMin,jMax, k,kM1,kUp,kDown, |
252 |
Cdbg I xA,yA,uTrans,vTrans,wTrans,maskUp, |
253 |
Cdbg I K13,K23,K33,KapGM, |
254 |
Cdbg U aTerm,xTerm,fZon,fMer,fVerS, |
255 |
Cdbg I myThid) |
256 |
|
257 |
ENDDO ! K |
258 |
|
259 |
ENDDO |
260 |
ENDDO |
261 |
|
262 |
!dbg write(0,*) 'dynamics: pS',minval(cg2d_x),maxval(cg2d_x) |
263 |
!dbg write(0,*) 'dynamics: U',minval(uVel(1:sNx,1:sNy,:,:,:)), |
264 |
!dbg & maxval(uVel(1:sNx,1:sNy,:,:,:)) |
265 |
!dbg write(0,*) 'dynamics: V',minval(vVel(1:sNx,1:sNy,:,:,:)), |
266 |
!dbg & maxval(vVel(1:sNx,1:sNy,:,:,:)) |
267 |
!dbg write(0,*) 'dynamics: gT',minval(gT(1:sNx,1:sNy,:,:,:)), |
268 |
!dbg & maxval(gT(1:sNx,1:sNy,:,:,:)) |
269 |
!dbg write(0,*) 'dynamics: T',minval(Theta(1:sNx,1:sNy,:,:,:)), |
270 |
!dbg & maxval(Theta(1:sNx,1:sNy,:,:,:)) |
271 |
!dbg write(0,*) 'dynamics: pH',minval(pH/(Gravity*Rhonil)), |
272 |
!dbg & maxval(pH/(Gravity*Rhonil)) |
273 |
|
274 |
RETURN |
275 |
END |