1 | MODULE trcbbl |
---|
2 | !!====================================================================== |
---|
3 | !! *** MODULE trcbbl *** |
---|
4 | !! Ocean passive tracers physics : advective and/or diffusive bottom boundary |
---|
5 | !! layer scheme |
---|
6 | !!====================================================================== |
---|
7 | !! History : OPA ! 1996-06 (L. Mortier) Original code |
---|
8 | !! 8.0 ! 1997-11 (G. Madec) Optimization |
---|
9 | !! NEMO 1.0 ! 2002-08 (G. Madec) free form + modules |
---|
10 | !! - ! 2004-01 (A. de Miranda, G. Madec, J.M. Molines ) add advective bbl |
---|
11 | !! 3.3 ! 2009-11 (G. Madec) merge trabbl and trabbl_adv + style + optimization |
---|
12 | !! - ! 2010-04 (G. Madec) Campin & Goosse advective bbl |
---|
13 | !! - ! 2010-06 (C. Ethe, G. Madec) merge TRA-TRC |
---|
14 | !! 4.0 ! 2017-04 (G. Madec) ln_trabbl namelist variable instead of a CPP key |
---|
15 | !!---------------------------------------------------------------------- |
---|
16 | #if defined key_top |
---|
17 | !!---------------------------------------------------------------------- |
---|
18 | !! 'key_top' TOP models |
---|
19 | !!---------------------------------------------------------------------- |
---|
20 | !! trc_bbl : update the tracer trends due to the bottom boundary layer (advective and/or diffusive) |
---|
21 | !!---------------------------------------------------------------------- |
---|
22 | USE oce_trc ! ocean dynamics and passive tracers variables |
---|
23 | USE trc ! ocean passive tracers variables |
---|
24 | USE trd_oce ! trends: ocean variables |
---|
25 | USE trdtra ! tracer trends |
---|
26 | USE trabbl ! bottom boundary layer |
---|
27 | USE prtctl_trc ! Print control for debbuging |
---|
28 | |
---|
29 | PUBLIC trc_bbl ! routine called by trctrp.F90 |
---|
30 | |
---|
31 | !!---------------------------------------------------------------------- |
---|
32 | !! NEMO/TOP 4.0 , NEMO Consortium (2018) |
---|
33 | !! $Id$ |
---|
34 | !! Software governed by the CeCILL license (see ./LICENSE) |
---|
35 | !!---------------------------------------------------------------------- |
---|
36 | CONTAINS |
---|
37 | |
---|
38 | SUBROUTINE trc_bbl( kt, Kbb, Kmm, ptr, Krhs ) |
---|
39 | !!---------------------------------------------------------------------- |
---|
40 | !! *** ROUTINE bbl *** |
---|
41 | !! |
---|
42 | !! ** Purpose : Compute the before tracer (t & s) trend associated |
---|
43 | !! with the bottom boundary layer and add it to the general trend |
---|
44 | !! of tracer equations. |
---|
45 | !! |
---|
46 | !!---------------------------------------------------------------------- |
---|
47 | INTEGER, INTENT( in ) :: kt ! ocean time-step |
---|
48 | INTEGER, INTENT( in ) :: Kbb, Kmm, Krhs ! time level indices |
---|
49 | REAL(wp), DIMENSION(jpi,jpj,jpk,jptra,jpt), INTENT(inout) :: ptr ! passive tracers and RHS of tracer equation |
---|
50 | INTEGER :: jn ! loop index |
---|
51 | CHARACTER (len=22) :: charout |
---|
52 | REAL(wp), ALLOCATABLE, DIMENSION(:,:,:,:) :: ztrtrd |
---|
53 | !!---------------------------------------------------------------------- |
---|
54 | ! |
---|
55 | IF( ln_timing ) CALL timing_start('trc_bbl') |
---|
56 | ! |
---|
57 | IF( .NOT. l_offline ) THEN |
---|
58 | CALL bbl( kt, nittrc000, 'TRC', Kbb, Kmm ) ! Online coupling with dynamics : Computation of bbl coef and bbl transport |
---|
59 | l_bbl = .FALSE. ! Offline coupling with dynamics : Read bbl coef and bbl transport from input files |
---|
60 | ENDIF |
---|
61 | |
---|
62 | IF( l_trdtrc ) THEN |
---|
63 | ALLOCATE( ztrtrd(jpi,jpj,jpk,jptra) ) ! temporary save of trends |
---|
64 | ztrtrd(:,:,:,:) = ptr(:,:,:,:,Krhs) |
---|
65 | ENDIF |
---|
66 | |
---|
67 | !* Diffusive bbl : |
---|
68 | IF( nn_bbl_ldf == 1 ) THEN |
---|
69 | ! |
---|
70 | CALL tra_bbl_dif( ptr(:,:,:,:,Kbb), ptr(:,:,:,:,Krhs), jptra, Kmm ) |
---|
71 | IF( sn_cfctl%l_prttrc ) THEN |
---|
72 | WRITE(charout, FMT="(' bbl_dif')") ; CALL prt_ctl_trc_info(charout) |
---|
73 | CALL prt_ctl_trc( tab4d=ptr(:,:,:,:,Krhs), mask=tmask, clinfo=ctrcnm, clinfo2='trd' ) |
---|
74 | ENDIF |
---|
75 | ! |
---|
76 | ENDIF |
---|
77 | |
---|
78 | !* Advective bbl : bbl upstream advective trends added to the tracer trends |
---|
79 | IF( nn_bbl_adv /= 0 ) THEN |
---|
80 | ! |
---|
81 | CALL tra_bbl_adv( ptr(:,:,:,:,Kbb), ptr(:,:,:,:,Krhs), jptra, Kmm ) |
---|
82 | IF( sn_cfctl%l_prttrc ) THEN |
---|
83 | WRITE(charout, FMT="(' bbl_adv')") ; CALL prt_ctl_trc_info(charout) |
---|
84 | CALL prt_ctl_trc( tab4d=ptr(:,:,:,:,Krhs), mask=tmask, clinfo=ctrcnm, clinfo2='trd' ) |
---|
85 | ENDIF |
---|
86 | ! |
---|
87 | ENDIF |
---|
88 | |
---|
89 | IF( l_trdtrc ) THEN ! save the horizontal diffusive trends for further diagnostics |
---|
90 | DO jn = 1, jptra |
---|
91 | ztrtrd(:,:,:,jn) = ptr(:,:,:,jn,Krhs) - ztrtrd(:,:,:,jn) |
---|
92 | CALL trd_tra( kt, Kmm, Krhs, 'TRC', jn, jptra_bbl, ztrtrd(:,:,:,jn) ) |
---|
93 | END DO |
---|
94 | DEALLOCATE( ztrtrd ) ! temporary save of trends |
---|
95 | ENDIF |
---|
96 | ! |
---|
97 | IF( ln_timing ) CALL timing_stop('trc_bbl') |
---|
98 | ! |
---|
99 | END SUBROUTINE trc_bbl |
---|
100 | |
---|
101 | #endif |
---|
102 | |
---|
103 | !!====================================================================== |
---|
104 | END MODULE trcbbl |
---|