1 | MODULE 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 | !!---------------------------------------------------------------------- |
---|
8 | #if defined key_top |
---|
9 | !!---------------------------------------------------------------------- |
---|
10 | !! 'key_top' TOP models |
---|
11 | !!---------------------------------------------------------------------- |
---|
12 | !! trc_trp : passive tracer transport |
---|
13 | !!---------------------------------------------------------------------- |
---|
14 | USE oce_trc ! ocean dynamics and active tracers variables |
---|
15 | USE trp_trc ! ocean passive tracers variables |
---|
16 | USE trctrp_lec ! passive tracers transport parameters |
---|
17 | USE prtctl_trc ! Print control for debbuging |
---|
18 | |
---|
19 | USE trcbbl ! bottom boundary layer (trc_bbl routine) |
---|
20 | USE trcdmp ! internal damping (trc_dmp routine) |
---|
21 | |
---|
22 | USE trcldf_bilapg ! lateral mixing (trc_ldf_bilapg routine) |
---|
23 | USE trcldf_bilap ! lateral mixing (trc_ldf_bilap routine) |
---|
24 | USE trcldf_iso ! lateral mixing (trc_ldf_iso routine) |
---|
25 | USE trcldf_iso_zps ! lateral mixing (trc_ldf_iso_zps routine) |
---|
26 | USE trcldf_lap ! lateral mixing (trc_ldf_lap routine) |
---|
27 | |
---|
28 | USE trcnxt ! time-stepping (trc_nxt routine) |
---|
29 | USE trcrad ! positivity (trc_rad routine) |
---|
30 | |
---|
31 | USE trcadv_cen2 ! 2nd order centered advection (trc_adv_cen2 routine) |
---|
32 | USE trcadv_muscl ! MUSCL advection (trc_adv_muscl routine) |
---|
33 | USE trcadv_muscl2 ! MUSCL2 advection (trc_adv_muscl2 routine) |
---|
34 | USE trcadv_tvd ! TVD advection (trc_adv_tvd routine) |
---|
35 | USE trcadv_smolar ! SMOLAR advection (trc_adv_smolar routine) |
---|
36 | |
---|
37 | USE trczdf_exp ! vertical diffusion (trc_zdf_exp routine) |
---|
38 | USE trczdf_imp ! vertical diffusion (trc_zdf_exp routine) |
---|
39 | USE trczdf_iso ! vertical diffusion (trc_zdf_exp routine) |
---|
40 | USE trczdf_iso_vopt ! vertical diffusion (trc_zdf_exp routine) |
---|
41 | USE trcsbc ! surface boundary condition (trc_sbc routine) |
---|
42 | |
---|
43 | USE zpshde_trc ! partial step: hor. derivative (zps_hde_trc routine) |
---|
44 | |
---|
45 | #if defined key_agrif |
---|
46 | USE agrif_top_sponge ! Momemtum and tracers sponges |
---|
47 | #endif |
---|
48 | |
---|
49 | IMPLICIT NONE |
---|
50 | PRIVATE |
---|
51 | |
---|
52 | PUBLIC trc_trp ! called by trc_stp |
---|
53 | |
---|
54 | !! * Substitutions |
---|
55 | # include "top_substitute.h90" |
---|
56 | !!---------------------------------------------------------------------- |
---|
57 | !! NEMO/TOP 1.0 , LOCEAN-IPSL (2005) |
---|
58 | !! $Id$ |
---|
59 | !! Software governed by the CeCILL licence (modipsl/doc/NEMO_CeCILL.txt) |
---|
60 | !!---------------------------------------------------------------------- |
---|
61 | |
---|
62 | CONTAINS |
---|
63 | |
---|
64 | SUBROUTINE trc_trp( kt ) |
---|
65 | !!---------------------------------------------------------------------- |
---|
66 | !! *** ROUTINE trc_trp *** |
---|
67 | !! |
---|
68 | !! ** Purpose : Management of passive tracers transport |
---|
69 | !! |
---|
70 | !! ** Method : - Compute the passive tracers trends |
---|
71 | !! - Update the passive tracers |
---|
72 | !!---------------------------------------------------------------------- |
---|
73 | INTEGER, INTENT( in ) :: kt ! ocean time-step index |
---|
74 | !! |
---|
75 | CHARACTER (len=25) :: charout |
---|
76 | !! --------------------------------------------------------------------- |
---|
77 | |
---|
78 | CALL trc_sbc( kt ) ! surface boundary condition |
---|
79 | # if defined key_trcbbc |
---|
80 | !!gm bug : this should be control during the initialisation phase, not here! |
---|
81 | CALL ctl_stop( ' Bottom heat flux not yet implemented with passive tracer ' & |
---|
82 | & ' Check in trc_trp routine ' ) |
---|
83 | # endif |
---|
84 | ! ! bottom boundary condition |
---|
85 | IF( lk_trcbbl_dif ) CALL trc_bbl_dif( kt ) ! diffusive bottom boundary layer scheme |
---|
86 | IF( lk_trcbbl_adv ) CALL trc_bbl_adv( kt ) ! advective (and/or diffusive) bottom boundary layer scheme |
---|
87 | |
---|
88 | IF( lk_trcdmp ) CALL trc_dmp( kt ) ! internal damping trends |
---|
89 | |
---|
90 | ! ! horizontal & vertical advection |
---|
91 | IF( ln_trcadv_cen2 ) CALL trc_adv_cen2 ( kt ) ! 2nd order centered scheme |
---|
92 | IF( ln_trcadv_muscl ) CALL trc_adv_muscl ( kt ) ! MUSCL scheme |
---|
93 | IF( ln_trcadv_muscl2 ) CALL trc_adv_muscl2( kt ) ! MUSCL2 scheme |
---|
94 | IF( ln_trcadv_tvd ) CALL trc_adv_tvd ( kt ) ! TVD scheme |
---|
95 | IF( ln_trcadv_smolar ) CALL trc_adv_smolar( kt ) ! SMOLARKIEWICZ scheme |
---|
96 | |
---|
97 | |
---|
98 | IF( n_cla == 1 ) THEN |
---|
99 | !!gm bug : this should be control during the initialisation phase, not here! |
---|
100 | WRITE(ctmp1,*) ' Cross Land Advection not yet implemented with passive tracer n_cla = ',n_cla |
---|
101 | CALL ctl_stop( ctmp1 ) |
---|
102 | ENDIF |
---|
103 | |
---|
104 | ! ! lateral mixing |
---|
105 | IF( l_trcldf_bilapg ) CALL trc_ldf_bilapg ( kt ) ! s-coord. horizontal bilaplacian |
---|
106 | IF( l_trcldf_bilap ) CALL trc_ldf_bilap ( kt ) ! iso-level bilaplacian |
---|
107 | IF( l_trcldf_iso ) CALL trc_ldf_iso ( kt ) ! iso-neutral laplacian |
---|
108 | IF( l_trcldf_iso_zps ) CALL trc_ldf_iso_zps( kt ) ! partial step iso-neutral laplacian |
---|
109 | IF( l_trcldf_lap ) CALL trc_ldf_lap ( kt ) ! iso-level laplacian |
---|
110 | |
---|
111 | #if defined key_agrif |
---|
112 | IF(.NOT. Agrif_Root()) CALL Agrif_Sponge_trc ! tracers sponge |
---|
113 | #endif |
---|
114 | |
---|
115 | ! ! vertical diffusion |
---|
116 | IF( l_trczdf_exp ) CALL trc_zdf_exp ( kt ) ! explicit time stepping (time splitting scheme) |
---|
117 | IF( l_trczdf_imp ) CALL trc_zdf_imp ( kt ) ! implicit time stepping (euler backward) |
---|
118 | IF( l_trczdf_iso ) CALL trc_zdf_iso ( kt ) ! isopycnal |
---|
119 | IF( l_trczdf_iso_vo ) CALL trc_zdf_iso_vopt( kt ) ! vector opt. isopycnal |
---|
120 | |
---|
121 | CALL trc_nxt( kt ) ! tracer fields at next time step |
---|
122 | |
---|
123 | IF( ln_trcrad ) CALL trc_rad( kt ) ! Correct artificial negative concentrations |
---|
124 | ! ! especially useful when isopycnal mixing is used |
---|
125 | ! |
---|
126 | |
---|
127 | IF( ln_zps .AND. .NOT. lk_trc_c1d ) & ! Partial steps: now horizontal gradient of passive |
---|
128 | & CALL zps_hde_trc( kt, trb, gtru, gtrv ) ! tracers at the bottom ocean level |
---|
129 | ! |
---|
130 | END SUBROUTINE trc_trp |
---|
131 | |
---|
132 | #else |
---|
133 | !!---------------------------------------------------------------------- |
---|
134 | !! Dummy module : No TOP models |
---|
135 | !!---------------------------------------------------------------------- |
---|
136 | CONTAINS |
---|
137 | SUBROUTINE trc_trp( kt ) ! Empty routine |
---|
138 | INTEGER, INTENT(in) :: kt |
---|
139 | WRITE(*,*) 'trc_trp: You should not have seen this print! error?', kt |
---|
140 | END SUBROUTINE trc_trp |
---|
141 | #endif |
---|
142 | |
---|
143 | !!====================================================================== |
---|
144 | END MODULE trctrp |
---|