MODULE dynzad !!====================================================================== !! *** MODULE dynzad *** !! Ocean dynamics : vertical advection trend !!====================================================================== !! History : OPA ! 1991-01 (G. Madec) Original code !! NEMO 0.5 ! 2002-07 (G. Madec) Free form, F90 !!---------------------------------------------------------------------- !!---------------------------------------------------------------------- !! dyn_zad : vertical advection momentum trend !!---------------------------------------------------------------------- USE oce ! ocean dynamics and tracers USE dom_oce ! ocean space and time domain USE sbc_oce ! surface boundary condition: ocean USE trd_oce ! trends: ocean variables USE trddyn ! trend manager: dynamics ! USE in_out_manager ! I/O manager USE lib_mpp ! MPP library USE prtctl ! Print control USE timing ! Timing IMPLICIT NONE PRIVATE PUBLIC dyn_zad ! routine called by dynadv.F90 !! * Substitutions # include "vectopt_loop_substitute.h90" !!---------------------------------------------------------------------- !! NEMO/OCE 4.0 , NEMO Consortium (2018) !! $Id$ !! Software governed by the CeCILL license (see ./LICENSE) !!---------------------------------------------------------------------- CONTAINS SUBROUTINE dyn_zad ( kt, ktlev, pu_rhs, pv_rhs ) !!---------------------------------------------------------------------- !! *** ROUTINE dynzad *** !! !! ** Purpose : Compute the now vertical momentum advection trend and !! add it to the general trend of momentum equation. !! !! ** Method : The now vertical advection of momentum is given by: !! w dz(u) = pu_rhs + 1/(e1e2u*e3u) mk+1[ mi(e1e2t*ww) dk(uu(:,:,:,ktlev)) ] !! w dz(v) = pv_rhs + 1/(e1e2v*e3v) mk+1[ mj(e1e2t*ww) dk(vv(:,:,:,ktlev)) ] !! Add this trend to the general trend (pu_rhs,pv_rhs): !! (pu_rhs,pv_rhs) = (pu_rhs,pv_rhs) + w dz(u,v) !! !! ** Action : - Update (pu_rhs,pv_rhs) with the vert. momentum adv. trends !! - Send the trends to trddyn for diagnostics (l_trddyn=T) !!---------------------------------------------------------------------- INTEGER, INTENT(in) :: kt ! ocean time-step index INTEGER, INTENT(in) :: ktlev ! time level index for source terms REAL(wp), INTENT(inout), DIMENSION(jpi,jpj,jpk) :: pu_rhs, pv_rhs ! momentum trends ! INTEGER :: ji, jj, jk ! dummy loop indices REAL(wp) :: zua, zva ! local scalars REAL(wp), DIMENSION(jpi,jpj) :: zww REAL(wp), DIMENSION(jpi,jpj,jpk) :: zwuw, zwvw REAL(wp), DIMENSION(:,:,:), ALLOCATABLE :: ztrdu, ztrdv !!---------------------------------------------------------------------- ! IF( ln_timing ) CALL timing_start('dyn_zad') ! IF( kt == nit000 ) THEN IF(lwp) WRITE(numout,*) IF(lwp) WRITE(numout,*) 'dyn_zad : 2nd order vertical advection scheme' ENDIF IF( l_trddyn ) THEN ! Save pu_rhs and pv_rhs trends ALLOCATE( ztrdu(jpi,jpj,jpk) , ztrdv(jpi,jpj,jpk) ) ztrdu(:,:,:) = pu_rhs(:,:,:) ztrdv(:,:,:) = pv_rhs(:,:,:) ENDIF DO jk = 2, jpkm1 ! Vertical momentum advection at level w and u- and v- vertical DO jj = 2, jpj ! vertical fluxes DO ji = fs_2, jpi ! vector opt. zww(ji,jj) = 0.25_wp * e1e2t(ji,jj) * ww(ji,jj,jk) END DO END DO DO jj = 2, jpjm1 ! vertical momentum advection at w-point DO ji = fs_2, fs_jpim1 ! vector opt. zwuw(ji,jj,jk) = ( zww(ji+1,jj ) + zww(ji,jj) ) * ( uu(ji,jj,jk-1,ktlev) - uu(ji,jj,jk,ktlev) ) zwvw(ji,jj,jk) = ( zww(ji ,jj+1) + zww(ji,jj) ) * ( vv(ji,jj,jk-1,ktlev) - vv(ji,jj,jk,ktlev) ) END DO END DO END DO ! ! Surface and bottom advective fluxes set to zero DO jj = 2, jpjm1 DO ji = fs_2, fs_jpim1 ! vector opt. zwuw(ji,jj, 1 ) = 0._wp zwvw(ji,jj, 1 ) = 0._wp zwuw(ji,jj,jpk) = 0._wp zwvw(ji,jj,jpk) = 0._wp END DO END DO ! DO jk = 1, jpkm1 ! Vertical momentum advection at u- and v-points DO jj = 2, jpjm1 DO ji = fs_2, fs_jpim1 ! vector opt. pu_rhs(ji,jj,jk) = pu_rhs(ji,jj,jk) - ( zwuw(ji,jj,jk) + zwuw(ji,jj,jk+1) ) * r1_e1e2u(ji,jj) / e3u(ji,jj,jk,ktlev) pv_rhs(ji,jj,jk) = pv_rhs(ji,jj,jk) - ( zwvw(ji,jj,jk) + zwvw(ji,jj,jk+1) ) * r1_e1e2v(ji,jj) / e3v(ji,jj,jk,ktlev) END DO END DO END DO IF( l_trddyn ) THEN ! save the vertical advection trends for diagnostic ztrdu(:,:,:) = pu_rhs(:,:,:) - ztrdu(:,:,:) ztrdv(:,:,:) = pv_rhs(:,:,:) - ztrdv(:,:,:) CALL trd_dyn( ztrdu, ztrdv, jpdyn_zad, kt ) DEALLOCATE( ztrdu, ztrdv ) ENDIF ! ! Control print IF(ln_ctl) CALL prt_ctl( tab3d_1=ua, clinfo1=' zad - Ua: ', mask1=umask, & & tab3d_2=va, clinfo2= ' Va: ', mask2=vmask, clinfo3='dyn' ) ! IF( ln_timing ) CALL timing_stop('dyn_zad') ! END SUBROUTINE dyn_zad !!====================================================================== END MODULE dynzad