source: branches/UKMO/dev_r5518_GO6_package/NEMOGCM/NEMO/TOP_SRC/TRP/trctrp.F90 @ 8280

Last change on this file since 8280 was 8280, checked in by timgraham, 3 years ago

331: Merge of MEDUSA stable branch and HadGEM3 coupling branches into GO6 package branch.

File size: 6.9 KB
Line 
1MODULE trctrp
2   !!======================================================================
3   !!                       ***  MODULE trctrp  ***
4   !! Ocean Physics    : manage the passive tracer transport
5   !!======================================================================
6   !! History :   1.0  !  2004-03 (C. Ethe) Original code
7   !!             3.3  !  2010-07 (C. Ethe) Merge TRA-TRC
8   !!----------------------------------------------------------------------
9#if defined key_top
10   !!----------------------------------------------------------------------
11   !!   'key_top'                                                TOP models
12   !!----------------------------------------------------------------------
13   !!   trc_trp        : passive tracer transport
14   !!----------------------------------------------------------------------
15   USE oce_trc         ! ocean dynamics and active tracers variables
16   USE trc             ! ocean passive tracers variables
17   USE trcnam_trp      ! passive tracers transport namelist variables
18   USE trabbl          ! bottom boundary layer               (trc_bbl routine)
19   USE trcbbl          ! bottom boundary layer               (trc_bbl routine)
20   USE zdfkpp          ! KPP non-local tracer fluxes         (trc_kpp routine)
21   USE trcdmp          ! internal damping                    (trc_dmp routine)
22   USE trcldf          ! lateral mixing                      (trc_ldf routine)
23   USE trcadv          ! advection                           (trc_adv routine)
24   USE trczdf          ! vertical diffusion                  (trc_zdf routine)
25   USE trcnxt          ! time-stepping                       (trc_nxt routine)
26   USE trcrad          ! positivity                          (trc_rad routine)
27   USE trcsbc          ! surface boundary condition          (trc_sbc routine)
28   USE zpshde          ! partial step: hor. derivative       (zps_hde routine)
29# if defined key_debug_medusa
30   USE trcrst
31# endif
32
33
34#if defined key_agrif
35   USE agrif_top_sponge ! tracers sponges
36   USE agrif_top_update ! tracers updates
37#endif
38
39   IMPLICIT NONE
40   PRIVATE
41
42   PUBLIC   trc_trp    ! called by trc_stp
43
44   !! * Substitutions
45#  include "top_substitute.h90"
46   !!----------------------------------------------------------------------
47   !! NEMO/TOP 3.3 , NEMO Consortium (2010)
48   !! $Id$
49   !! Software governed by the CeCILL licence (NEMOGCM/NEMO_CeCILL.txt)
50   !!----------------------------------------------------------------------
51
52CONTAINS
53
54   SUBROUTINE trc_trp( kstp )
55      !!----------------------------------------------------------------------
56      !!                     ***  ROUTINE trc_trp  ***
57      !!                     
58      !! ** Purpose :   Management of passive tracers transport
59      !!
60      !! ** Method  : - Compute the passive tracers trends
61      !!              - Update the passive tracers
62      !!----------------------------------------------------------------------
63      INTEGER, INTENT( in ) ::  kstp  ! ocean time-step index
64      !! ---------------------------------------------------------------------
65      !
66      IF( nn_timing == 1 )   CALL timing_start('trc_trp')
67      !
68      IF( .NOT. lk_c1d ) THEN
69         !
70                                CALL trc_sbc( kstp )            ! surface boundary condition
71# if defined key_debug_medusa
72         IF(lwp) WRITE(numout,*) ' MEDUSA trc_trp after trc_sbc at kt =', kstp
73         CALL trc_rst_tra_stat
74         CALL flush(numout)
75# endif
76         IF( lk_trabbl )        CALL trc_bbl( kstp )            ! advective (and/or diffusive) bottom boundary layer scheme
77         IF( ln_trcdmp )        CALL trc_dmp( kstp )            ! internal damping trends
78                                CALL trc_adv( kstp )            ! horizontal & vertical advection
79# if defined key_debug_medusa
80         IF(lwp) WRITE(numout,*) ' MEDUSA trc_trp after trc_adv at kt =', kstp
81         CALL trc_rst_tra_stat
82         CALL flush(numout)
83# endif
84                                CALL trc_ldf( kstp )            ! lateral mixing
85         IF( .NOT. lk_offline .AND. lk_zdfkpp )    &
86            &                   CALL trc_kpp( kstp )            ! KPP non-local tracer fluxes
87#if defined key_agrif
88         IF(.NOT. Agrif_Root()) CALL Agrif_Sponge_trc           ! tracers sponge
89#endif
90                                CALL trc_zdf( kstp )            ! vertical mixing and after tracer fields
91# if defined key_debug_medusa
92         IF(lwp) WRITE(numout,*) ' MEDUSA trc_trp after trc_zdf at kt =', kstp
93         CALL trc_rst_tra_stat
94         CALL flush(numout)
95# endif
96                                CALL trc_nxt( kstp )            ! tracer fields at next time step     
97# if defined key_debug_medusa
98         IF(lwp) WRITE(numout,*) ' MEDUSA trc_trp after trc_nxt at kt =', kstp
99         CALL trc_rst_tra_stat
100         CALL flush(numout)
101# endif
102         IF( ln_trcrad )        CALL trc_rad( kstp )            ! Correct artificial negative concentrations
103         IF( ln_trcdmp_clo )    CALL trc_dmp_clo( kstp )        ! internal damping trends on closed seas only
104
105#if defined key_agrif
106      IF( .NOT. Agrif_Root())   CALL Agrif_Update_Trc( kstp )   ! Update tracer at AGRIF zoom boundaries : children only
107#endif
108
109         IF( ln_zps  .AND. .NOT. ln_isfcav)        &
110            &            CALL zps_hde    ( kstp, jptra, trn, gtru, gtrv )   ! Partial steps: now horizontal gradient of passive
111         IF( ln_zps .AND.        ln_isfcav)        &
112            &            CALL zps_hde_isf( kstp, jptra, trn, pgtu=gtru, pgtv=gtrv, pgtui=gtrui, pgtvi=gtrvi )  ! Partial steps: now horizontal gradient of passive
113                                                                ! tracers at the bottom ocean level
114         !
115      ELSE                                               ! 1D vertical configuration
116                                CALL trc_sbc( kstp )            ! surface boundary condition
117         IF( .NOT. lk_offline .AND. lk_zdfkpp )    &
118            &                   CALL trc_kpp( kstp )            ! KPP non-local tracer fluxes
119                                CALL trc_zdf( kstp )            ! vertical mixing and after tracer fields
120                                CALL trc_nxt( kstp )            ! tracer fields at next time step     
121          IF( ln_trcrad )       CALL trc_rad( kstp )            ! Correct artificial negative concentrations
122         !
123      END IF
124      !
125      IF( nn_timing == 1 )   CALL timing_stop('trc_trp')
126      !
127   END SUBROUTINE trc_trp
128
129#else
130   !!----------------------------------------------------------------------
131   !!   Dummy module :                                        No TOP models
132   !!----------------------------------------------------------------------
133CONTAINS
134   SUBROUTINE trc_trp( kstp )              ! Empty routine
135      INTEGER, INTENT(in) ::   kstp
136      WRITE(*,*) 'trc_trp: You should not have seen this print! error?', kstp
137   END SUBROUTINE trc_trp
138#endif
139   
140   !!======================================================================
141END MODULE trctrp
Note: See TracBrowser for help on using the repository browser.