--- MITgcm/pkg/mom_fluxform/mom_fluxform.F 2003/06/24 23:09:43 1.4.6.2 +++ MITgcm/pkg/mom_fluxform/mom_fluxform.F 2005/10/12 01:10:10 1.29 @@ -1,4 +1,4 @@ -C $Header: /home/ubuntu/mnt/e9_copy/MITgcm/pkg/mom_fluxform/mom_fluxform.F,v 1.4.6.2 2003/06/24 23:09:43 heimbach Exp $ +C $Header: /home/ubuntu/mnt/e9_copy/MITgcm/pkg/mom_fluxform/mom_fluxform.F,v 1.29 2005/10/12 01:10:10 jmc Exp $ C $Name: $ CBOI @@ -25,7 +25,7 @@ C stresses as well as internal viscous stresses. CEOI -#include "CPP_OPTIONS.h" +#include "MOM_FLUXFORM_OPTIONS.h" CBOP C !ROUTINE: MOM_FLUXFORM @@ -33,9 +33,10 @@ C !INTERFACE: ========================================================== SUBROUTINE MOM_FLUXFORM( I bi,bj,iMin,iMax,jMin,jMax,k,kUp,kDown, - I dPhihydX,dPhiHydY,KappaRU,KappaRV, + I KappaRU, KappaRV, U fVerU, fVerV, - I myTime,myIter,myThid) + O guDiss, gvDiss, + I myTime, myIter, myThid) C !DESCRIPTION: C Calculates all the horizontal accelerations except for the implicit surface @@ -58,22 +59,23 @@ C k :: vertical level C kUp :: =1 or 2 for consecutive k C kDown :: =2 or 1 for consecutive k -C dPhiHydX,Y :: Gradient (X & Y dir.) of Hydrostatic Potential C KappaRU :: vertical viscosity C KappaRV :: vertical viscosity C fVerU :: vertical flux of U, 2 1/2 dim for pipe-lining C fVerV :: vertical flux of V, 2 1/2 dim for pipe-lining +C guDiss :: dissipation tendency (all explicit terms), u component +C gvDiss :: dissipation tendency (all explicit terms), v component C myTime :: current time C myIter :: current time-step number C myThid :: thread number INTEGER bi,bj,iMin,iMax,jMin,jMax INTEGER k,kUp,kDown - _RL dPhiHydX(1-OLx:sNx+OLx,1-OLy:sNy+OLy) - _RL dPhiHydY(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL KappaRU(1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr) _RL KappaRV(1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr) _RL fVerU(1-OLx:sNx+OLx,1-OLy:sNy+OLy,2) _RL fVerV(1-OLx:sNx+OLx,1-OLy:sNy+OLy,2) + _RL guDiss(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL gvDiss(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL myTime INTEGER myIter INTEGER myThid @@ -83,26 +85,22 @@ C !LOCAL VARIABLES: ==================================================== C i,j :: loop indices -C aF :: advective flux C vF :: viscous flux C v4F :: bi-harmonic viscous flux -C vrF :: vertical viscous flux C cF :: Coriolis acceleration C mT :: Metric terms -C pF :: Pressure gradient C fZon :: zonal fluxes C fMer :: meridional fluxes +C fVrUp,fVrDw :: vertical viscous fluxes at interface k-1 & k INTEGER i,j - _RL aF(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL vF(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL v4F(1-OLx:sNx+OLx,1-OLy:sNy+OLy) - _RL vrF(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL cF(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL mT(1-OLx:sNx+OLx,1-OLy:sNy+OLy) - _RL pF(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL fZon(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL fMer(1-OLx:sNx+OLx,1-OLy:sNy+OLy) -C wMaskOverride - Land sea flag override for top layer. + _RL fVrUp(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL fVrDw(1-OLx:sNx+OLx,1-OLy:sNy+OLy) C afFacMom - Tracer parameters for turning terms C vfFacMom on and off. C pfFacMom afFacMom - Advective terms @@ -111,7 +109,7 @@ C cfFacMom - Coriolis terms C foFacMom - Forcing C mTFacMom - Metric term -C uDudxFac, AhDudxFac, etc ... individual term tracer parameters +C uDudxFac, AhDudxFac, etc ... individual term parameters for switching terms off _RS hFacZ(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RS r_hFacZ(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RS xA(1-OLx:sNx+OLx,1-OLy:sNy+OLy) @@ -122,63 +120,52 @@ _RL vFld(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL rTransU(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL rTransV(1-OLx:sNx+OLx,1-OLy:sNy+OLy) -C I,J,K - Loop counters -C rVelMaskOverride - Factor for imposing special surface boundary conditions -C ( set according to free-surface condition ). -C hFacROpen - Lopped cell factos used tohold fraction of open -C hFacRClosed and closed cell wall. - _RL rVelMaskOverride -C xxxFac - On-off tracer parameters used for switching terms off. + _RL KE(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL viscAh_D(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL viscAh_Z(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL viscA4_D(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL viscA4_Z(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL vort3(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL hDiv(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL strain(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL tension(1-OLx:sNx+OLx,1-OLy:sNy+OLy) _RL uDudxFac _RL AhDudxFac - _RL A4DuxxdxFac _RL vDudyFac _RL AhDudyFac - _RL A4DuyydyFac _RL rVelDudrFac _RL ArDudrFac _RL fuFac - _RL phxFac _RL mtFacU _RL uDvdxFac _RL AhDvdxFac - _RL A4DvxxdxFac _RL vDvdyFac _RL AhDvdyFac - _RL A4DvyydyFac _RL rVelDvdrFac _RL ArDvdrFac _RL fvFac - _RL phyFac - _RL vForcFac _RL mtFacV - INTEGER km1,kp1 - _RL wVelBottomOverride - LOGICAL bottomDragTerms - _RL KE(1-OLx:sNx+OLx,1-OLy:sNy+OLy) + _RL sideMaskFac + LOGICAL bottomDragTerms,harmonic,biharmonic,useVariableViscosity CEOP - km1=MAX(1,k-1) - kp1=MIN(Nr,k+1) - rVelMaskOverride=1. - IF ( k .EQ. 1 ) rVelMaskOverride=freeSurfFac - wVelBottomOverride=1. - IF (k.EQ.Nr) wVelBottomOverride=0. - C Initialise intermediate terms - DO J=1-OLy,sNy+OLy - DO I=1-OLx,sNx+OLx - aF(i,j) = 0. + DO j=1-OLy,sNy+OLy + DO i=1-OLx,sNx+OLx vF(i,j) = 0. v4F(i,j) = 0. - vrF(i,j) = 0. cF(i,j) = 0. mT(i,j) = 0. - pF(i,j) = 0. fZon(i,j) = 0. fMer(i,j) = 0. - rTransU(i,j) = 0. - rTransV(i,j) = 0. + fVrUp(i,j)= 0. + fVrDw(i,j)= 0. + rTransU(i,j)= 0. + rTransV(i,j)= 0. + strain(i,j) = 0. + tension(i,j)= 0. + guDiss(i,j) = 0. + gvDiss(i,j) = 0. ENDDO ENDDO @@ -186,28 +173,34 @@ C o U momentum equation uDudxFac = afFacMom*1. AhDudxFac = vfFacMom*1. - A4DuxxdxFac = vfFacMom*1. vDudyFac = afFacMom*1. AhDudyFac = vfFacMom*1. - A4DuyydyFac = vfFacMom*1. rVelDudrFac = afFacMom*1. ArDudrFac = vfFacMom*1. mTFacU = mtFacMom*1. fuFac = cfFacMom*1. - phxFac = pfFacMom*1. C o V momentum equation uDvdxFac = afFacMom*1. AhDvdxFac = vfFacMom*1. - A4DvxxdxFac = vfFacMom*1. vDvdyFac = afFacMom*1. AhDvdyFac = vfFacMom*1. - A4DvyydyFac = vfFacMom*1. rVelDvdrFac = afFacMom*1. ArDvdrFac = vfFacMom*1. mTFacV = mtFacMom*1. fvFac = cfFacMom*1. - phyFac = pfFacMom*1. - vForcFac = foFacMom*1. + + IF (implicitViscosity) THEN + ArDudrFac = 0. + ArDvdrFac = 0. + ENDIF + +C note: using standard stencil (no mask) results in under-estimating +C vorticity at a no-slip boundary by a factor of 2 = sideDragFactor + IF ( no_slip_sides ) THEN + sideMaskFac = sideDragFactor + ELSE + sideMaskFac = 0. _d 0 + ENDIF IF ( no_slip_bottom & .OR. bottomDragQuadratic.NE.0. @@ -217,12 +210,6 @@ bottomDragTerms=.FALSE. ENDIF -C-- with stagger time stepping, grad Phi_Hyp is directly incoporated in TIMESTEP - IF (staggerTimeStep) THEN - phxFac = 0. - phyFac = 0. - ENDIF - C-- Calculate open water fraction at vorticity points CALL MOM_CALC_HFACZ(bi,bj,k,hFacZ,r_hFacZ,myThid) @@ -253,30 +240,44 @@ ENDDO ENDDO - CALL MOM_CALC_KE(bi,bj,k,uFld,vFld,KE,myThid) + CALL MOM_CALC_KE(bi,bj,k,2,uFld,vFld,KE,myThid) + IF ( momViscosity) THEN + CALL MOM_CALC_HDIV(bi,bj,k,2,uFld,vFld,hDiv,myThid) + CALL MOM_CALC_RELVORT3(bi,bj,k,uFld,vFld,hFacZ,vort3,myThid) + CALL MOM_CALC_TENSION(bi,bj,k,uFld,vFld,tension,myThid) + CALL MOM_CALC_STRAIN(bi,bj,k,uFld,vFld,hFacZ,strain,myThid) + DO j=1-Oly,sNy+Oly + DO i=1-Olx,sNx+Olx + IF ( hFacZ(i,j).EQ.0. ) THEN + vort3(i,j) = sideMaskFac*vort3(i,j) + strain(i,j) = sideMaskFac*strain(i,j) + ENDIF + ENDDO + ENDDO +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) THEN + CALL DIAGNOSTICS_FILL(hDiv, 'momHDiv ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(vort3, 'momVort3',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(tension,'Tension ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(strain, 'Strain ',k,1,2,bi,bj,myThid) + ENDIF +#endif + ENDIF C--- First call (k=1): compute vertical adv. flux fVerU(kUp) & fVerV(kUp) IF (momAdvection.AND.k.EQ.1) THEN C- Calculate vertical transports above U & V points (West & South face): - CALL MOM_CALC_RTRANS( k, bi, bj, - O rTransU, rTransV, - I myTime, myIter, myThid) + CALL MOM_CALC_RTRANS( k, bi, bj, + O rTransU, rTransV, + I myTime, myIter, myThid) C- Free surface correction term (flux at k=1) - CALL MOM_U_ADV_WU(bi,bj,k,uVel,wVel,rTransU,af,myThid) - DO j=jMin,jMax - DO i=iMin,iMax - fVerU(i,j,kUp) = af(i,j) - ENDDO - ENDDO + CALL MOM_U_ADV_WU( bi,bj,k,uVel,wVel,rTransU, + O fVerU(1-OLx,1-OLy,kUp), myThid ) - CALL MOM_V_ADV_WV(bi,bj,k,vVel,wVel,rTransV,af,myThid) - DO j=jMin,jMax - DO i=iMin,iMax - fVerV(i,j,kUp) = af(i,j) - ENDDO - ENDDO + CALL MOM_V_ADV_WV( bi,bj,k,vVel,wVel,rTransV, + O fVerV(1-OLx,1-OLy,kUp), myThid ) C--- endif momAdvection & k=1 ENDIF @@ -284,129 +285,175 @@ C--- Calculate vertical transports (at k+1) below U & V points : IF (momAdvection) THEN - CALL MOM_CALC_RTRANS( k+1, bi, bj, - O rTransU, rTransV, - I myTime, myIter, myThid) + CALL MOM_CALC_RTRANS( k+1, bi, bj, + O rTransU, rTransV, + I myTime, myIter, myThid) ENDIF + IF (momViscosity) THEN + CALL MOM_CALC_VISC( + I bi,bj,k, + O viscAh_Z,viscAh_D,viscA4_Z,viscA4_D, + O harmonic,biharmonic,useVariableViscosity, + I hDiv,vort3,tension,strain,KE,hFacZ, + I myThid) + ENDIF -C---- Zonal momentum equation starts here +C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| -C Bi-harmonic term del^2 U -> v4F - IF (momViscosity .AND. viscA4.NE.0. ) - & CALL MOM_U_DEL2U(bi,bj,k,uFld,hFacZ,v4f,myThid) +C---- Zonal momentum equation starts here -C--- Calculate mean and eddy fluxes between cells for zonal flow. + IF (momAdvection) THEN +C--- Calculate mean fluxes (advection) between cells for zonal flow. C-- Zonal flux (fZon is at east face of "u" cell) - -C Mean flow component of zonal flux -> aF - IF (momAdvection) - & CALL MOM_U_ADV_UU(bi,bj,k,uTrans,uFld,aF,myThid) - -C Laplacian and bi-harmonic terms -> vF - IF (momViscosity) - & CALL MOM_U_XVISCFLUX(bi,bj,k,uFld,v4F,vF,myThid) - -C Combine fluxes -> fZon - DO j=jMin,jMax - DO i=iMin,iMax - fZon(i,j) = uDudxFac*aF(i,j) + AhDudxFac*vF(i,j) - ENDDO - ENDDO +C Mean flow component of zonal flux -> fZon + CALL MOM_U_ADV_UU(bi,bj,k,uTrans,uFld,fZon,myThid) C-- Meridional flux (fMer is at south face of "u" cell) - -C Mean flow component of meridional flux - IF (momAdvection) - & CALL MOM_U_ADV_VU(bi,bj,k,vTrans,uFld,aF,myThid) - -C Laplacian and bi-harmonic term - IF (momViscosity) - & CALL MOM_U_YVISCFLUX(bi,bj,k,uFld,v4F,hFacZ,vF,myThid) - -C Combine fluxes -> fMer - DO j=jMin,jMax+1 - DO i=iMin,iMax - fMer(i,j) = vDudyFac*aF(i,j) + AhDudyFac*vF(i,j) - ENDDO - ENDDO +C Mean flow component of meridional flux -> fMer + CALL MOM_U_ADV_VU(bi,bj,k,vTrans,uFld,fMer,myThid) C-- Vertical flux (fVer is at upper face of "u" cell) - -C Mean flow component of vertical flux (at k+1) -> aF - IF (momAdvection) - & CALL MOM_U_ADV_WU(bi,bj,k+1,uVel,wVel,rTransU,af,myThid) - -C Eddy component of vertical flux (interior component only) -> vrF - IF (momViscosity.AND..NOT.implicitViscosity) - & CALL MOM_U_RVISCFLUX(bi,bj,k,uVel,KappaRU,vrF,myThid) - -C Combine fluxes - DO j=jMin,jMax - DO i=iMin,iMax - fVerU(i,j,kDown) = rVelDudrFac*aF(i,j) + ArDudrFac*vrF(i,j) - ENDDO - ENDDO +C Mean flow component of vertical flux (at k+1) -> fVer + CALL MOM_U_ADV_WU( + I bi,bj,k+1,uVel,wVel,rTransU, + O fVerU(1-OLx,1-OLy,kDown), myThid ) C-- Tendency is minus divergence of the fluxes + coriolis + pressure term - DO j=jMin,jMax - DO i=iMin,iMax - gU(i,j,k,bi,bj) = + DO j=jMin,jMax + DO i=iMin,iMax + gU(i,j,k,bi,bj) = #ifdef OLD_UV_GEOM - & -_recip_hFacW(i,j,k,bi,bj)*recip_drF(k)/ - & ( 0.5 _d 0*(rA(i,j,bi,bj)+rA(i-1,j,bi,bj)) ) + & -_recip_hFacW(i,j,k,bi,bj)*recip_drF(k)/ + & ( 0.5 _d 0*(rA(i,j,bi,bj)+rA(i-1,j,bi,bj)) ) #else - & -_recip_hFacW(i,j,k,bi,bj)*recip_drF(k) - & *recip_rAw(i,j,bi,bj) + & -_recip_hFacW(i,j,k,bi,bj)*recip_drF(k) + & *recip_rAw(i,j,bi,bj) +#endif + & *( ( fZon(i,j ) - fZon(i-1,j) )*uDudxFac + & +( fMer(i,j+1) - fMer(i, j) )*vDudyFac + & +(fVerU(i,j,kDown) - fVerU(i,j,kUp))*rkSign*rVelDudrFac + & ) + ENDDO + ENDDO + +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) THEN + CALL DIAGNOSTICS_FILL(fZon,'ADVx_Um ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(fMer,'ADVy_Um ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(fVerU(1-Olx,1-Oly,kUp), + & 'ADVrE_Um',k,1,2,bi,bj,myThid) + ENDIF #endif - & *(fZon(i,j ) - fZon(i-1,j) - & +fMer(i,j+1) - fMer(i ,j) - & +fVerU(i,j,kUp)*rkFac - fVerU(i,j,kDown)*rkFac - & ) - & - phxFac*dPhiHydX(i,j) - ENDDO - ENDDO #ifdef NONLIN_FRSURF C-- account for 3.D divergence of the flow in rStar coordinate: - IF ( momAdvection .AND. select_rStar.GT.0 ) THEN - DO j=jMin,jMax - DO i=iMin,iMax - gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj) + IF ( select_rStar.GT.0 ) THEN + DO j=jMin,jMax + DO i=iMin,iMax + gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj) & - (rStarExpW(i,j,bi,bj) - 1. _d 0)/deltaTfreesurf & *uVel(i,j,k,bi,bj) - ENDDO - ENDDO - ENDIF - IF ( momAdvection .AND. select_rStar.LT.0 ) THEN - DO j=jMin,jMax - DO i=iMin,iMax - gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj) + ENDDO + ENDDO + ENDIF + IF ( select_rStar.LT.0 ) THEN + DO j=jMin,jMax + DO i=iMin,iMax + gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj) & - rStarDhWDt(i,j,bi,bj)*uVel(i,j,k,bi,bj) + ENDDO + ENDDO + ENDIF +#endif /* NONLIN_FRSURF */ + + ELSE +C- if momAdvection / else + DO j=1-OLy,sNy+OLy + DO i=1-OLx,sNx+OLx + gU(i,j,k,bi,bj) = 0. _d 0 + ENDDO ENDDO - ENDDO + +C- endif momAdvection. ENDIF -#endif /* NONLIN_FRSURF */ + + IF (momViscosity) THEN +C--- Calculate eddy fluxes (dissipation) between cells for zonal flow. + +C Bi-harmonic term del^2 U -> v4F + IF (biharmonic) + & CALL MOM_U_DEL2U(bi,bj,k,uFld,hFacZ,v4f,myThid) + +C Laplacian and bi-harmonic terms, Zonal Fluxes -> fZon + CALL MOM_U_XVISCFLUX(bi,bj,k,uFld,v4F,fZon, + I viscAh_D,viscA4_D,myThid) + +C Laplacian and bi-harmonic termis, Merid Fluxes -> fMer + CALL MOM_U_YVISCFLUX(bi,bj,k,uFld,v4F,hFacZ,fMer, + I viscAh_Z,viscA4_Z,myThid) + +C Eddy component of vertical flux (interior component only) -> fVrUp & fVrDw + IF (.NOT.implicitViscosity) THEN + CALL MOM_U_RVISCFLUX(bi,bj, k, uVel,KappaRU,fVrUp,myThid) + CALL MOM_U_RVISCFLUX(bi,bj,k+1,uVel,KappaRU,fVrDw,myThid) + ENDIF + +C-- Tendency is minus divergence of the fluxes + DO j=jMin,jMax + DO i=iMin,iMax + guDiss(i,j) = +#ifdef OLD_UV_GEOM + & -_recip_hFacW(i,j,k,bi,bj)*recip_drF(k)/ + & ( 0.5 _d 0*(rA(i,j,bi,bj)+rA(i-1,j,bi,bj)) ) +#else + & -_recip_hFacW(i,j,k,bi,bj)*recip_drF(k) + & *recip_rAw(i,j,bi,bj) +#endif + & *( ( fZon(i,j ) - fZon(i-1,j) )*AhDudxFac + & +( fMer(i,j+1) - fMer(i, j) )*AhDudyFac + & +( fVrDw(i,j) - fVrUp(i,j) )*rkSign*ArDudrFac + & ) + ENDDO + ENDDO + +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) THEN + CALL DIAGNOSTICS_FILL(fZon, 'VISCx_Um',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(fMer, 'VISCy_Um',k,1,2,bi,bj,myThid) + IF (.NOT.implicitViscosity) + & CALL DIAGNOSTICS_FILL(fVrUp,'VISrE_Um',k,1,2,bi,bj,myThid) + ENDIF +#endif C-- No-slip and drag BCs appear as body forces in cell abutting topography - IF (momViscosity.AND.no_slip_sides) THEN + IF (no_slip_sides) THEN C- No-slip BCs impose a drag at walls... - CALL MOM_U_SIDEDRAG(bi,bj,k,uFld,v4F,hFacZ,vF,myThid) - DO j=jMin,jMax - DO i=iMin,iMax - gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj)+vF(i,j) - ENDDO - ENDDO - ENDIF + CALL MOM_U_SIDEDRAG( + I bi,bj,k, + I uFld, v4f, hFacZ, + I viscAh_Z,viscA4_Z, + I harmonic,biharmonic,useVariableViscosity, + O vF, + I myThid) + DO j=jMin,jMax + DO i=iMin,iMax + gUdiss(i,j) = gUdiss(i,j) + vF(i,j) + ENDDO + ENDDO + ENDIF C- No-slip BCs impose a drag at bottom - IF (momViscosity.AND.bottomDragTerms) THEN - CALL MOM_U_BOTTOMDRAG(bi,bj,k,uFld,KE,KappaRU,vF,myThid) - DO j=jMin,jMax - DO i=iMin,iMax - gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj)+vF(i,j) - ENDDO - ENDDO + IF (bottomDragTerms) THEN + CALL MOM_U_BOTTOMDRAG(bi,bj,k,uFld,KE,KappaRU,vF,myThid) + DO j=jMin,jMax + DO i=iMin,iMax + gUdiss(i,j) = gUdiss(i,j) + vF(i,j) + ENDDO + ENDDO + ENDIF + +C- endif momViscosity ENDIF C-- Forcing term (moved to timestep.F) @@ -433,132 +480,167 @@ ENDDO ENDDO ENDIF - -C-- Set du/dt on boundaries to zero - DO j=jMin,jMax - DO i=iMin,iMax - gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj)*_maskW(i,j,k,bi,bj) + IF (usingCylindricalGrid) THEN + CALL MOM_U_METRIC_CYLINDER(bi,bj,k,uFld,vFld,mT,myThid) + DO j=jMin,jMax + DO i=iMin,iMax + gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj)+mTFacU*mT(i,j) + ENDDO ENDDO - ENDDO + ENDIF +C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| C---- Meridional momentum equation starts here -C Bi-harmonic term del^2 V -> v4F - IF (momViscosity .AND. viscA4.NE.0. ) - & CALL MOM_V_DEL2V(bi,bj,k,vFld,hFacZ,v4f,myThid) - -C--- Calculate mean and eddy fluxes between cells for meridional flow. - -C-- Zonal flux (fZon is at west face of "v" cell) - -C Mean flow component of zonal flux -> aF - IF (momAdvection) - & CALL MOM_V_ADV_UV(bi,bj,k,uTrans,vFld,af,myThid) - -C Laplacian and bi-harmonic terms -> vF - IF (momViscosity) - & CALL MOM_V_XVISCFLUX(bi,bj,k,vFld,v4f,hFacZ,vf,myThid) - -C Combine fluxes -> fZon - DO j=jMin,jMax - DO i=iMin,iMax+1 - fZon(i,j) = uDvdxFac*aF(i,j) + AhDvdxFac*vF(i,j) - ENDDO - ENDDO + IF (momAdvection) THEN +C--- Calculate mean fluxes (advection) between cells for meridional flow. +C Mean flow component of zonal flux -> fZon + CALL MOM_V_ADV_UV(bi,bj,k,uTrans,vFld,fZon,myThid) C-- Meridional flux (fMer is at north face of "v" cell) - -C Mean flow component of meridional flux - IF (momAdvection) - & CALL MOM_V_ADV_VV(bi,bj,k,vTrans,vFld,af,myThid) - -C Laplacian and bi-harmonic term - IF (momViscosity) - & CALL MOM_V_YVISCFLUX(bi,bj,k,vFld,v4f,vf,myThid) - -C Combine fluxes -> fMer - DO j=jMin,jMax - DO i=iMin,iMax - fMer(i,j) = vDvdyFac*aF(i,j) + AhDvdyFac*vF(i,j) - ENDDO - ENDDO +C Mean flow component of meridional flux -> fMer + CALL MOM_V_ADV_VV(bi,bj,k,vTrans,vFld,fMer,myThid) C-- Vertical flux (fVer is at upper face of "v" cell) - -C o Mean flow component of vertical flux - IF (momAdvection) - & CALL MOM_V_ADV_WV(bi,bj,k+1,vVel,wVel,rTransV,af,myThid) - -C Eddy component of vertical flux (interior component only) -> vrF - IF (momViscosity.AND..NOT.implicitViscosity) - & CALL MOM_V_RVISCFLUX(bi,bj,k,vVel,KappaRV,vrf,myThid) - -C Combine fluxes -> fVerV - DO j=jMin,jMax - DO i=iMin,iMax - fVerV(i,j,kDown) = rVelDvdrFac*aF(i,j) + ArDvdrFac*vrF(i,j) - ENDDO - ENDDO +C Mean flow component of vertical flux (at k+1) -> fVerV + CALL MOM_V_ADV_WV( + I bi,bj,k+1,vVel,wVel,rTransV, + O fVerV(1-OLx,1-OLy,kDown), myThid ) C-- Tendency is minus divergence of the fluxes + coriolis + pressure term - DO j=jMin,jMax - DO i=iMin,iMax - gV(i,j,k,bi,bj) = + DO j=jMin,jMax + DO i=iMin,iMax + gV(i,j,k,bi,bj) = #ifdef OLD_UV_GEOM - & -_recip_hFacS(i,j,k,bi,bj)*recip_drF(k)/ - & ( 0.5 _d 0*(_rA(i,j,bi,bj)+_rA(i,j-1,bi,bj)) ) + & -_recip_hFacS(i,j,k,bi,bj)*recip_drF(k)/ + & ( 0.5 _d 0*(_rA(i,j,bi,bj)+_rA(i,j-1,bi,bj)) ) #else - & -_recip_hFacS(i,j,k,bi,bj)*recip_drF(k) - & *recip_rAs(i,j,bi,bj) + & -_recip_hFacS(i,j,k,bi,bj)*recip_drF(k) + & *recip_rAs(i,j,bi,bj) +#endif + & *( ( fZon(i+1,j) - fZon(i,j ) )*uDvdxFac + & +( fMer(i, j) - fMer(i,j-1) )*vDvdyFac + & +(fVerV(i,j,kDown) - fVerV(i,j,kUp))*rkSign*rVelDvdrFac + & ) + ENDDO + ENDDO + +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) THEN + CALL DIAGNOSTICS_FILL(fZon,'ADVx_Vm ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(fMer,'ADVy_Vm ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(fVerV(1-Olx,1-Oly,kUp), + & 'ADVrE_Vm',k,1,2,bi,bj,myThid) + ENDIF #endif - & *(fZon(i+1,j) - fZon(i,j ) - & +fMer(i,j ) - fMer(i,j-1) - & +fVerV(i,j,kUp)*rkFac - fVerV(i,j,kDown)*rkFac - & ) - & - phyFac*dPhiHydY(i,j) - ENDDO - ENDDO #ifdef NONLIN_FRSURF C-- account for 3.D divergence of the flow in rStar coordinate: - IF ( momAdvection .AND. select_rStar.GT.0 ) THEN - DO j=jMin,jMax - DO i=iMin,iMax - gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj) + IF ( select_rStar.GT.0 ) THEN + DO j=jMin,jMax + DO i=iMin,iMax + gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj) & - (rStarExpS(i,j,bi,bj) - 1. _d 0)/deltaTfreesurf & *vVel(i,j,k,bi,bj) - ENDDO - ENDDO - ENDIF - IF ( momAdvection .AND. select_rStar.LT.0 ) THEN - DO j=jMin,jMax - DO i=iMin,iMax - gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj) + ENDDO + ENDDO + ENDIF + IF ( select_rStar.LT.0 ) THEN + DO j=jMin,jMax + DO i=iMin,iMax + gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj) & - rStarDhSDt(i,j,bi,bj)*vVel(i,j,k,bi,bj) + ENDDO + ENDDO + ENDIF +#endif /* NONLIN_FRSURF */ + + ELSE +C- if momAdvection / else + DO j=1-OLy,sNy+OLy + DO i=1-OLx,sNx+OLx + gV(i,j,k,bi,bj) = 0. _d 0 + ENDDO ENDDO - ENDDO + +C- endif momAdvection. ENDIF -#endif /* NONLIN_FRSURF */ + + IF (momViscosity) THEN +C--- Calculate eddy fluxes (dissipation) between cells for meridional flow. +C Bi-harmonic term del^2 V -> v4F + IF (biharmonic) + & CALL MOM_V_DEL2V(bi,bj,k,vFld,hFacZ,v4f,myThid) + +C Laplacian and bi-harmonic terms, Zonal Fluxes -> fZon + CALL MOM_V_XVISCFLUX(bi,bj,k,vFld,v4f,hFacZ,fZon, + I viscAh_Z,viscA4_Z,myThid) + +C Laplacian and bi-harmonic termis, Merid Fluxes -> fMer + CALL MOM_V_YVISCFLUX(bi,bj,k,vFld,v4f,fMer, + I viscAh_D,viscA4_D,myThid) + +C Eddy component of vertical flux (interior component only) -> fVrUp & fVrDw + IF (.NOT.implicitViscosity) THEN + CALL MOM_V_RVISCFLUX(bi,bj, k, vVel,KappaRV,fVrUp,myThid) + CALL MOM_V_RVISCFLUX(bi,bj,k+1,vVel,KappaRV,fVrDw,myThid) + ENDIF + +C-- Tendency is minus divergence of the fluxes + coriolis + pressure term + DO j=jMin,jMax + DO i=iMin,iMax + gvDiss(i,j) = +#ifdef OLD_UV_GEOM + & -_recip_hFacS(i,j,k,bi,bj)*recip_drF(k)/ + & ( 0.5 _d 0*(_rA(i,j,bi,bj)+_rA(i,j-1,bi,bj)) ) +#else + & -_recip_hFacS(i,j,k,bi,bj)*recip_drF(k) + & *recip_rAs(i,j,bi,bj) +#endif + & *( ( fZon(i+1,j) - fZon(i,j ) )*AhDvdxFac + & +( fMer(i, j) - fMer(i,j-1) )*AhDvdyFac + & +( fVrDw(i,j) - fVrUp(i,j) )*rkSign*ArDvdrFac + & ) + ENDDO + ENDDO + +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) THEN + CALL DIAGNOSTICS_FILL(fZon, 'VISCx_Vm',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(fMer, 'VISCy_Vm',k,1,2,bi,bj,myThid) + IF (.NOT.implicitViscosity) + & CALL DIAGNOSTICS_FILL(fVrUp,'VISrE_Vm',k,1,2,bi,bj,myThid) + ENDIF +#endif C-- No-slip and drag BCs appear as body forces in cell abutting topography - IF (momViscosity.AND.no_slip_sides) THEN + IF (no_slip_sides) THEN C- No-slip BCs impose a drag at walls... - CALL MOM_V_SIDEDRAG(bi,bj,k,vFld,v4F,hFacZ,vF,myThid) - DO j=jMin,jMax - DO i=iMin,iMax - gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj)+vF(i,j) - ENDDO - ENDDO - ENDIF + CALL MOM_V_SIDEDRAG( + I bi,bj,k, + I vFld, v4f, hFacZ, + I viscAh_Z,viscA4_Z, + I harmonic,biharmonic,useVariableViscosity, + O vF, + I myThid) + DO j=jMin,jMax + DO i=iMin,iMax + gvDiss(i,j) = gvDiss(i,j) + vF(i,j) + ENDDO + ENDDO + ENDIF C- No-slip BCs impose a drag at bottom - IF (momViscosity.AND.bottomDragTerms) THEN - CALL MOM_V_BOTTOMDRAG(bi,bj,k,vFld,KE,KappaRV,vF,myThid) - DO j=jMin,jMax - DO i=iMin,iMax - gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj)+vF(i,j) - ENDDO - ENDDO + IF (bottomDragTerms) THEN + CALL MOM_V_BOTTOMDRAG(bi,bj,k,vFld,KE,KappaRV,vF,myThid) + DO j=jMin,jMax + DO i=iMin,iMax + gvDiss(i,j) = gvDiss(i,j) + vF(i,j) + ENDDO + ENDDO + ENDIF + +C- endif momViscosity ENDIF C-- Forcing term (moved to timestep.F) @@ -585,13 +667,16 @@ ENDDO ENDDO ENDIF + IF (usingCylindricalGrid) THEN + CALL MOM_V_METRIC_CYLINDER(bi,bj,k,uFld,vFld,mT,myThid) + DO j=jMin,jMax + DO i=iMin,iMax + gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj)+mTFacV*mT(i,j) + ENDDO + ENDDO + ENDIF -C-- Set dv/dt on boundaries to zero - DO j=jMin,jMax - DO i=iMin,iMax - gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj)*_maskS(i,j,k,bi,bj) - ENDDO - ENDDO +C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| C-- Coriolis term C Note. As coded here, coriolis will not work with "thin walls" @@ -605,12 +690,20 @@ gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj)+fuFac*cf(i,j) ENDDO ENDDO +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) + & CALL DIAGNOSTICS_FILL(cf,'Um_Cori ',k,1,2,bi,bj,myThid) +#endif CALL MOM_V_CORIOLIS(bi,bj,k,uFld,cf,myThid) DO j=jMin,jMax DO i=iMin,iMax gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj)+fvFac*cf(i,j) ENDDO ENDDO +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) + & CALL DIAGNOSTICS_FILL(cf,'Vm_Cori ',k,1,2,bi,bj,myThid) +#endif ENDIF IF (nonHydrostatic.OR.quasiHydrostatic) THEN @@ -622,5 +715,29 @@ ENDDO ENDIF +C-- Set du/dt & dv/dt on boundaries to zero + DO j=jMin,jMax + DO i=iMin,iMax + gU(i,j,k,bi,bj) = gU(i,j,k,bi,bj)*_maskW(i,j,k,bi,bj) + guDiss(i,j) = guDiss(i,j) *_maskW(i,j,k,bi,bj) + gV(i,j,k,bi,bj) = gV(i,j,k,bi,bj)*_maskS(i,j,k,bi,bj) + gvDiss(i,j) = gvDiss(i,j) *_maskS(i,j,k,bi,bj) + ENDDO + ENDDO + +#ifdef ALLOW_DIAGNOSTICS + IF ( useDiagnostics ) THEN + CALL DIAGNOSTICS_FILL(KE, 'momKE ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(gU(1-Olx,1-Oly,k,bi,bj), + & 'Um_Advec',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(gV(1-Olx,1-Oly,k,bi,bj), + & 'Vm_Advec',k,1,2,bi,bj,myThid) + IF (momViscosity) THEN + CALL DIAGNOSTICS_FILL(guDiss,'Um_Diss ',k,1,2,bi,bj,myThid) + CALL DIAGNOSTICS_FILL(gvDiss,'Vm_Diss ',k,1,2,bi,bj,myThid) + ENDIF + ENDIF +#endif /* ALLOW_DIAGNOSTICS */ + RETURN END