New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
trdpen.F90 in branches/UKMO/dev_merge_2017_restart_datestamp_GO6_mixing/NEMOGCM/NEMO/OPA_SRC/TRD – NEMO

source: branches/UKMO/dev_merge_2017_restart_datestamp_GO6_mixing/NEMOGCM/NEMO/OPA_SRC/TRD/trdpen.F90 @ 9496

Last change on this file since 9496 was 9496, checked in by davestorkey, 6 years ago

UKMO/branches/dev_merge_2017_restart_datestamp_GO6_mixing : clear SVN keywords.

File size: 7.9 KB
Line 
1MODULE trdpen
2   !!======================================================================
3   !!                       ***  MODULE  trdpen  ***
4   !! Ocean diagnostics:  Potential Energy trends
5   !!=====================================================================
6   !! History :  3.5  !  2012-02  (G. Madec) original code
7   !!----------------------------------------------------------------------
8
9   !!----------------------------------------------------------------------
10   !!   trd_pen       : compute and output Potential Energy trends from T & S trends
11   !!   trd_pen_init  : initialisation of PE trends
12   !!----------------------------------------------------------------------
13   USE oce            ! ocean dynamics and tracers variables
14   USE dom_oce        ! ocean domain
15   USE sbc_oce        ! surface boundary condition: ocean
16   USE zdf_oce        ! ocean vertical physics
17   USE trd_oce        ! trends: ocean variables
18   USE eosbn2         ! equation of state and related derivatives
19   USE ldftra         ! lateral diffusion: eddy diffusivity & EIV coeff.
20   USE zdfddm         ! vertical physics: double diffusion
21   USE phycst         ! physical constants
22   !
23   USE in_out_manager ! I/O manager
24   USE iom            ! I/O manager library
25   USE lib_mpp        ! MPP library
26
27   IMPLICIT NONE
28   PRIVATE
29
30   PUBLIC   trd_pen        ! called by all trdtra module
31   PUBLIC   trd_pen_init   ! called by all nemogcm module
32
33   INTEGER ::   nkstp   ! current time step
34
35   REAL(wp), ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) ::   rab_pe   ! partial derivatives of PE anomaly with respect to T and S
36
37   !! * Substitutions
38#  include "vectopt_loop_substitute.h90"
39   !!----------------------------------------------------------------------
40   !! NEMO/OPA 3.3 , NEMO Consortium (2010)
41   !! $Id$
42   !! Software governed by the CeCILL licence     (NEMOGCM/NEMO_CeCILL.txt)
43   !!----------------------------------------------------------------------
44CONTAINS
45
46   INTEGER FUNCTION trd_pen_alloc()
47      !!---------------------------------------------------------------------
48      !!                  ***  FUNCTION trd_tra_alloc  ***
49      !!---------------------------------------------------------------------
50      ALLOCATE( rab_pe(jpi,jpj,jpk,jpts) , STAT= trd_pen_alloc )
51      !
52      IF( lk_mpp             )   CALL mpp_sum ( trd_pen_alloc )
53      IF( trd_pen_alloc /= 0 )   CALL ctl_warn( 'trd_pen_alloc: failed to allocate arrays' )
54   END FUNCTION trd_pen_alloc
55
56
57   SUBROUTINE trd_pen( ptrdx, ptrdy, ktrd, kt, pdt )
58      !!---------------------------------------------------------------------
59      !!                  ***  ROUTINE trd_tra_mng  ***
60      !!
61      !! ** Purpose :   Dispatch all trends computation, e.g. 3D output, integral
62      !!                constraints, barotropic vorticity, kinetic enrgy,
63      !!                potential energy, and/or mixed layer budget.
64      !!----------------------------------------------------------------------
65      REAL(wp), DIMENSION(:,:,:), INTENT(in) ::   ptrdx, ptrdy   ! Temperature & Salinity trends
66      INTEGER                   , INTENT(in) ::   ktrd           ! tracer trend index
67      INTEGER                   , INTENT(in) ::   kt             ! time step index
68      REAL(wp)                  , INTENT(in) ::   pdt            ! time step [s]
69      !
70      INTEGER ::   jk                                            ! dummy loop indices
71      REAL(wp), ALLOCATABLE, DIMENSION(:,:)      ::   z2d            ! 2D workspace
72      REAL(wp), DIMENSION(jpi,jpj,jpk)           ::   zpe            ! 3D workspace
73      !!----------------------------------------------------------------------
74      !
75      zpe(:,:,:) = 0._wp
76      !
77      IF( kt /= nkstp ) THEN     ! full eos: set partial derivatives at the 1st call of kt time step
78         nkstp = kt
79         CALL eos_pen( tsn, rab_PE, zpe )
80         CALL iom_put( "alphaPE", rab_pe(:,:,:,jp_tem) )
81         CALL iom_put( "betaPE" , rab_pe(:,:,:,jp_sal) )
82         CALL iom_put( "PEanom" , zpe )
83      ENDIF
84      !
85      zpe(:,:,jpk) = 0._wp
86      DO jk = 1, jpkm1
87         zpe(:,:,jk) = ( - ( rab_n(:,:,jk,jp_tem) + rab_pe(:,:,jk,jp_tem) ) * ptrdx(:,:,jk)   &
88            &            + ( rab_n(:,:,jk,jp_sal) + rab_pe(:,:,jk,jp_sal) ) * ptrdy(:,:,jk)  )
89      END DO
90
91      SELECT CASE ( ktrd )
92      CASE ( jptra_xad  )   ;   CALL iom_put( "petrd_xad", zpe )   ! zonal    advection
93      CASE ( jptra_yad  )   ;   CALL iom_put( "petrd_yad", zpe )   ! merid.   advection
94      CASE ( jptra_zad  )   ;   CALL iom_put( "petrd_zad", zpe )   ! vertical advection
95                                IF( ln_linssh ) THEN                   ! cst volume : adv flux through z=0 surface
96                                   ALLOCATE( z2d(jpi,jpj) )
97                                   z2d(:,:) = wn(:,:,1) * ( &
98                                     &   - ( rab_n(:,:,1,jp_tem) + rab_pe(:,:,1,jp_tem) ) * tsn(:,:,1,jp_tem)    &
99                                     &   + ( rab_n(:,:,1,jp_sal) + rab_pe(:,:,1,jp_sal) ) * tsn(:,:,1,jp_sal)    &
100                                     & ) / e3t_n(:,:,1)
101                                   CALL iom_put( "petrd_sad" , z2d )
102                                   DEALLOCATE( z2d )
103                                ENDIF
104      CASE ( jptra_ldf  )   ;   CALL iom_put( "petrd_ldf" , zpe )   ! lateral  diffusion
105      CASE ( jptra_zdf  )   ;   CALL iom_put( "petrd_zdf" , zpe )   ! lateral  diffusion (K_z)
106      CASE ( jptra_zdfp )   ;   CALL iom_put( "petrd_zdfp", zpe )   ! vertical diffusion (K_z)
107      CASE ( jptra_dmp  )   ;   CALL iom_put( "petrd_dmp" , zpe )   ! internal 3D restoring (tradmp)
108      CASE ( jptra_bbl  )   ;   CALL iom_put( "petrd_bbl" , zpe )   ! bottom boundary layer
109      CASE ( jptra_npc  )   ;   CALL iom_put( "petrd_npc" , zpe )   ! non penetr convect adjustment
110      CASE ( jptra_nsr  )   ;   CALL iom_put( "petrd_nsr" , zpe )   ! surface forcing + runoff (ln_rnf=T)
111      CASE ( jptra_qsr  )   ;   CALL iom_put( "petrd_qsr" , zpe )   ! air-sea : penetrative sol radiat
112      CASE ( jptra_bbc  )   ;   CALL iom_put( "petrd_bbc" , zpe )   ! bottom bound cond (geoth flux)
113      CASE ( jptra_atf  )   ;   CALL iom_put( "petrd_atf" , zpe )   ! asselin time filter (last trend)
114                                !IF( ln_linssh ) THEN                   ! cst volume : ssh term (otherwise include in e3t variation)
115                                !   ALLOCATE( z2d(jpi,jpj) )
116                                !   z2d(:,:) = ( ssha(:,:) - sshb(:,:) )                 &
117                                !      &     * (   dPE_dt(:,:,1) * tsn(:,:,1,jp_tem)    &
118                                !      &         + dPE_ds(:,:,1) * tsn(:,:,1,jp_sal)  ) / ( e3t_n(:,:,1) * pdt )
119                                !   CALL iom_put( "petrd_sad" , z2d )
120                                !   DEALLOCATE( z2d )
121                                !ENDIF
122         !
123      END SELECT
124      !
125      !
126   END SUBROUTINE trd_pen
127
128
129   SUBROUTINE trd_pen_init
130      !!---------------------------------------------------------------------
131      !!                  ***  ROUTINE trd_pen_init  ***
132      !!
133      !! ** Purpose :   initialisation of 3D Kinetic Energy trend diagnostic
134      !!----------------------------------------------------------------------
135      INTEGER  ::   ji, jj, jk   ! dummy loop indices
136      !!----------------------------------------------------------------------
137      !
138      IF(lwp) THEN
139         WRITE(numout,*)
140         WRITE(numout,*) 'trd_pen_init : 3D Potential ENergy trends'
141         WRITE(numout,*) '~~~~~~~~~~~~~'
142      ENDIF
143      !                           ! allocate box volume arrays
144      IF ( trd_pen_alloc() /= 0 )   CALL ctl_stop('trd_pen_alloc: failed to allocate arrays')
145      !
146      rab_pe(:,:,:,:) = 0._wp
147      !
148      IF( .NOT.ln_linssh )   CALL ctl_stop('trd_pen_init : PE trends not coded for variable volume')
149      !
150      nkstp     = nit000 - 1
151      !
152   END SUBROUTINE trd_pen_init
153
154   !!======================================================================
155END MODULE trdpen
Note: See TracBrowser for help on using the repository browser.