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.
trasbc.F90 in branches/UKMO/r6232_CO6_CO5_zenv_pomsdwl/NEMOGCM/NEMO/OPA_SRC/TRA – NEMO

source: branches/UKMO/r6232_CO6_CO5_zenv_pomsdwl/NEMOGCM/NEMO/OPA_SRC/TRA/trasbc.F90 @ 7452

Last change on this file since 7452 was 7452, checked in by jcastill, 7 years ago

Changes as in UKMO/2015_V36_STABLE_CO6_CO5_zenv_pomsdwl@5793
File size: 16.0 KB
Line 
1MODULE trasbc
2   !!==============================================================================
3   !!                       ***  MODULE  trasbc  ***
4   !! Ocean active tracers:  surface boundary condition
5   !!==============================================================================
6   !! History :  OPA  !  1998-10  (G. Madec, G. Roullet, M. Imbard)  Original code
7   !!            8.2  !  2001-02  (D. Ludicone)  sea ice and free surface
8   !!  NEMO      1.0  !  2002-06  (G. Madec)  F90: Free form and module
9   !!            3.3  !  2010-04  (M. Leclair, G. Madec)  Forcing averaged over 2 time steps
10   !!             -   !  2010-09  (C. Ethe, G. Madec) Merge TRA-TRC
11   !!            3.6  !  2014-11  (P. Mathiot) isf melting forcing
12   !!----------------------------------------------------------------------
13
14   !!----------------------------------------------------------------------
15   !!   tra_sbc      : update the tracer trend at ocean surface
16   !!----------------------------------------------------------------------
17   USE oce             ! ocean dynamics and active tracers
18   USE sbc_oce         ! surface boundary condition: ocean
19   USE dom_oce         ! ocean space domain variables
20   USE phycst          ! physical constant
21   USE sbcmod          ! ln_rnf 
22   USE sbcrnf          ! River runoff 
23   USE sbcisf          ! Ice shelf   
24   USE traqsr          ! solar radiation penetration
25   USE trd_oce         ! trends: ocean variables
26   USE trdtra          ! trends manager: tracers
27   USE tradwl          ! solar radiation penetration (downwell method)
28   !
29   USE in_out_manager  ! I/O manager
30   USE prtctl          ! Print control
31   USE iom
32   USE lbclnk          ! ocean lateral boundary conditions (or mpp link)
33   USE wrk_nemo        ! Memory Allocation
34   USE timing          ! Timing
35   USE eosbn2
36
37   IMPLICIT NONE
38   PRIVATE
39
40   PUBLIC   tra_sbc    ! routine called by step.F90
41
42   !! * Substitutions
43#  include "domzgr_substitute.h90"
44#  include "vectopt_loop_substitute.h90"
45   !!----------------------------------------------------------------------
46   !! NEMO/OPA 3.7 , NEMO Consortium (2014)
47   !! $Id$
48   !! Software governed by the CeCILL licence     (NEMOGCM/NEMO_CeCILL.txt)
49   !!----------------------------------------------------------------------
50CONTAINS
51
52   SUBROUTINE tra_sbc ( kt )
53      !!----------------------------------------------------------------------
54      !!                  ***  ROUTINE tra_sbc  ***
55      !!                   
56      !! ** Purpose :   Compute the tracer surface boundary condition trend of
57      !!      (flux through the interface, concentration/dilution effect)
58      !!      and add it to the general trend of tracer equations.
59      !!
60      !! ** Method :
61      !!      Following Roullet and Madec (2000), the air-sea flux can be divided
62      !!      into three effects: (1) Fext, external forcing;
63      !!      (2) Fwi, concentration/dilution effect due to water exchanged
64      !!         at the surface by evaporation, precipitations and runoff (E-P-R);
65      !!      (3) Fwe, tracer carried with the water that is exchanged.
66      !!            - salinity    : salt flux only due to freezing/melting
67      !!            sa = sa +  sfx / rau0 / e3t  for k=1
68      !!
69      !!      Fext, flux through the air-sea interface for temperature and salt:
70      !!            - temperature : heat flux q (w/m2). If penetrative solar
71      !!         radiation q is only the non solar part of the heat flux, the
72      !!         solar part is added in traqsr.F routine.
73      !!            ta = ta + q /(rau0 rcp e3t)  for k=1
74      !!            - salinity    : no salt flux
75      !!
76      !!      The formulation for Fwb and Fwi vary according to the free
77      !!      surface formulation (linear or variable volume).
78      !!      * Linear free surface
79      !!            The surface freshwater flux modifies the ocean volume
80      !!         and thus the concentration of a tracer and the temperature.
81      !!         First order of the effect of surface freshwater exchange
82      !!         for salinity, it can be neglected on temperature (especially
83      !!         as the temperature of precipitations and runoffs is usually
84      !!         unknown).
85      !!            - temperature : we assume that the temperature of both
86      !!         precipitations and runoffs is equal to the SST, thus there
87      !!         is no additional flux since in this case, the concentration
88      !!         dilution effect is balanced by the net heat flux associated
89      !!         to the freshwater exchange (Fwe+Fwi=0):
90      !!            (Tp P - Te E) + SST (P-E) = 0 when Tp=Te=SST
91      !!            - salinity    : evaporation, precipitation and runoff
92      !!         water has a zero salinity  but there is a salt flux due to
93      !!         freezing/melting, thus:
94      !!            sa = sa + emp * sn / rau0 / e3t   for k=1
95      !!                    + sfx    / rau0 / e3t
96      !!         where emp, the surface freshwater budget (evaporation minus
97      !!         precipitation minus runoff) given in kg/m2/s is divided
98      !!         by rau0 (density of sea water) to obtain m/s.   
99      !!         Note: even though Fwe does not appear explicitly for
100      !!         temperature in this routine, the heat carried by the water
101      !!         exchanged through the surface is part of the total heat flux
102      !!         forcing and must be taken into account in the global heat
103      !!         balance).
104      !!      * nonlinear free surface (variable volume, lk_vvl)
105      !!         contrary to the linear free surface case, Fwi is properly
106      !!         taken into account by using the true layer thicknesses to       
107      !!         calculate tracer content and advection. There is no need to
108      !!         deal with it in this routine.
109      !!           - temperature: Fwe=SST (P-E+R) is added to Fext.
110      !!           - salinity:  Fwe = 0, there is no surface flux of salt.
111      !!
112      !! ** Action  : - Update the 1st level of (ta,sa) with the trend associated
113      !!                with the tracer surface boundary condition
114      !!              - send trends to trdtra module (l_trdtra=T)
115      !!----------------------------------------------------------------------
116      INTEGER, INTENT(in) ::   kt   ! ocean time-step index
117      !!
118      INTEGER  ::   ji, jj, jk, jn           ! dummy loop indices 
119      INTEGER  ::   ikt, ikb 
120      INTEGER  ::   nk_isf
121      REAL(wp) ::   zfact, z1_e3t, zdep
122      REAL(wp) ::   zalpha, zhk
123      REAL(wp), POINTER, DIMENSION(:,:,:) ::  ztrdt, ztrds
124      !!----------------------------------------------------------------------
125      !
126      IF( nn_timing == 1 )  CALL timing_start('tra_sbc')
127      !
128      IF( kt == nit000 ) THEN
129         IF(lwp) WRITE(numout,*)
130         IF(lwp) WRITE(numout,*) 'tra_sbc : TRAcer Surface Boundary Condition'
131         IF(lwp) WRITE(numout,*) '~~~~~~~ '
132      ENDIF
133
134      IF( l_trdtra ) THEN                    !* Save ta and sa trends
135         CALL wrk_alloc( jpi, jpj, jpk, ztrdt, ztrds ) 
136         ztrdt(:,:,:) = tsa(:,:,:,jp_tem)
137         ztrds(:,:,:) = tsa(:,:,:,jp_sal)
138      ENDIF
139
140!!gm      IF( .NOT.ln_traqsr )   qsr(:,:) = 0.e0   ! no solar radiation penetration
141      IF( .NOT.ln_traqsr .and. .NOT.ln_tradwl ) THEN     ! no solar radiation penetration
142         qns(:,:) = qns(:,:) + qsr(:,:)      ! total heat flux in qns
143         qsr(:,:) = 0.e0                     ! qsr set to zero
144      ENDIF
145
146      !----------------------------------------
147      !        EMP, SFX and QNS effects
148      !----------------------------------------
149      !                                          Set before sbc tracer content fields
150      !                                          ************************************
151      IF( kt == nit000 ) THEN                      ! Set the forcing field at nit000 - 1
152         !                                         ! -----------------------------------
153         IF( ln_rstart .AND.    &                     ! Restart: read in restart file
154              & iom_varid( numror, 'sbc_hc_b', ldstop = .FALSE. ) > 0 ) THEN
155            IF(lwp) WRITE(numout,*) '          nit000-1 surface tracer content forcing fields red in the restart file'
156            zfact = 0.5_wp
157            CALL iom_get( numror, jpdom_autoglo, 'sbc_hc_b', sbc_tsc_b(:,:,jp_tem) )   ! before heat content sbc trend
158            CALL iom_get( numror, jpdom_autoglo, 'sbc_sc_b', sbc_tsc_b(:,:,jp_sal) )   ! before salt content sbc trend
159         ELSE                                         ! No restart or restart not found: Euler forward time stepping
160            zfact = 1._wp
161            sbc_tsc_b(:,:,:) = 0._wp
162         ENDIF
163      ELSE                                         ! Swap of forcing fields
164         !                                         ! ----------------------
165         zfact = 0.5_wp
166         sbc_tsc_b(:,:,:) = sbc_tsc(:,:,:)
167      ENDIF
168      !                                          Compute now sbc tracer content fields
169      !                                          *************************************
170
171                                                   ! Concentration dilution effect on (t,s) due to 
172                                                   ! evaporation, precipitation and qns, but not river runoff
173                                               
174      IF( lk_vvl ) THEN                            ! Variable Volume case  ==>> heat content of mass flux is in qns
175         DO jj = 1, jpj
176            DO ji = 1, jpi 
177               sbc_tsc(ji,jj,jp_tem) = r1_rau0_rcp * qns(ji,jj)                              ! non solar heat flux
178               sbc_tsc(ji,jj,jp_sal) = r1_rau0     * sfx(ji,jj)                              ! salt flux due to freezing/melting
179            END DO
180         END DO
181      ELSE                                         ! Constant Volume case ==>> Concentration dilution effect
182         DO jj = 2, jpj
183            DO ji = fs_2, fs_jpim1   ! vector opt.
184               ! temperature : heat flux
185               sbc_tsc(ji,jj,jp_tem) = r1_rau0_rcp * qns(ji,jj)                          &   ! non solar heat flux
186                  &                  + r1_rau0     * emp(ji,jj)  * tsn(ji,jj,1,jp_tem)       ! concent./dilut. effect
187               ! salinity    : salt flux + concent./dilut. effect (both in sfx)
188               sbc_tsc(ji,jj,jp_sal) = r1_rau0  * (  sfx(ji,jj)                          &   ! salt flux (freezing/melting)
189                  &                                + emp(ji,jj) * tsn(ji,jj,1,jp_sal) )      ! concent./dilut. effect
190            END DO
191         END DO
192         IF( iom_use('emp_x_sst') )   CALL iom_put( "emp_x_sst", emp (:,:) * tsn(:,:,1,jp_tem) )   ! c/d term on sst
193         IF( iom_use('emp_x_sss') )   CALL iom_put( "emp_x_sss", emp (:,:) * tsn(:,:,1,jp_sal) )   ! c/d term on sss
194      ENDIF
195      ! Concentration dilution effect on (t,s) due to evapouration, precipitation and qns, but not river runoff 
196      DO jn = 1, jpts
197         DO jj = 2, jpj
198            DO ji = fs_2, fs_jpim1   ! vector opt.
199               z1_e3t = zfact / fse3t(ji,jj,1)
200               tsa(ji,jj,1,jn) = tsa(ji,jj,1,jn) + ( sbc_tsc_b(ji,jj,jn) + sbc_tsc(ji,jj,jn) ) * z1_e3t
201            END DO
202         END DO
203      END DO
204      !                                          Write in the ocean restart file
205      !                                          *******************************
206      IF( lrst_oce ) THEN
207         IF(lwp) WRITE(numout,*)
208         IF(lwp) WRITE(numout,*) 'sbc : ocean surface tracer content forcing fields written in ocean restart file ',   &
209            &                    'at it= ', kt,' date= ', ndastp
210         IF(lwp) WRITE(numout,*) '~~~~'
211         CALL iom_rstput( kt, nitrst, numrow, 'sbc_hc_b', sbc_tsc(:,:,jp_tem) )
212         CALL iom_rstput( kt, nitrst, numrow, 'sbc_sc_b', sbc_tsc(:,:,jp_sal) )
213      ENDIF
214      !
215      !
216      !----------------------------------------
217      !       Ice Shelf effects (ISF)
218      !     tbl treated as in Losh (2008) JGR
219      !----------------------------------------
220      !
221      IF( nn_isf > 0 ) THEN
222         zfact = 0.5e0
223         DO jj = 2, jpj
224            DO ji = fs_2, fs_jpim1
225         
226               ikt = misfkt(ji,jj)
227               ikb = misfkb(ji,jj)
228   
229               ! level fully include in the ice shelf boundary layer
230               ! if isfdiv, we have to remove heat flux due to inflow at 0oC (as in rnf when you add rnf at sst)
231               ! sign - because fwf sign of evapo (rnf sign of precip)
232               DO jk = ikt, ikb - 1
233               ! compute tfreez for the temperature correction (we add water at freezing temperature)
234               ! compute trend
235                  tsa(ji,jj,jk,jp_tem) = tsa(ji,jj,jk,jp_tem)                                          &
236                     &           + zfact * (risf_tsc_b(ji,jj,jp_tem) + risf_tsc(ji,jj,jp_tem)) * r1_hisf_tbl(ji,jj)
237                  tsa(ji,jj,jk,jp_sal) = tsa(ji,jj,jk,jp_sal)                                          &
238                     &           + zfact * (risf_tsc_b(ji,jj,jp_sal) + risf_tsc(ji,jj,jp_sal)) * r1_hisf_tbl(ji,jj)
239               END DO
240   
241               ! level partially include in ice shelf boundary layer
242               ! compute tfreez for the temperature correction (we add water at freezing temperature)
243               ! compute trend
244               tsa(ji,jj,ikb,jp_tem) = tsa(ji,jj,ikb,jp_tem)                                           &
245                  &              + zfact * (risf_tsc_b(ji,jj,jp_tem) + risf_tsc(ji,jj,jp_tem)) * r1_hisf_tbl(ji,jj) * ralpha(ji,jj)
246               tsa(ji,jj,ikb,jp_sal) = tsa(ji,jj,ikb,jp_sal)                                           &
247                  &              + zfact * (risf_tsc_b(ji,jj,jp_sal) + risf_tsc(ji,jj,jp_sal)) * r1_hisf_tbl(ji,jj) * ralpha(ji,jj) 
248            END DO
249         END DO
250         IF( lrst_oce ) THEN
251            IF(lwp) WRITE(numout,*)
252            IF(lwp) WRITE(numout,*) 'sbc : isf surface tracer content forcing fields written in ocean restart file ',   &
253               &                    'at it= ', kt,' date= ', ndastp
254            IF(lwp) WRITE(numout,*) '~~~~'
255            CALL iom_rstput( kt, nitrst, numrow, 'fwf_isf_b', fwfisf(:,:)          )
256            CALL iom_rstput( kt, nitrst, numrow, 'isf_hc_b' , risf_tsc(:,:,jp_tem) )
257            CALL iom_rstput( kt, nitrst, numrow, 'isf_sc_b' , risf_tsc(:,:,jp_sal) )
258         ENDIF
259      END IF
260      !
261      !----------------------------------------
262      !        River Runoff effects
263      !----------------------------------------
264      !
265      IF( ln_rnf ) THEN         ! input of heat and salt due to river runoff
266         zfact = 0.5_wp
267         DO jj = 2, jpj 
268            DO ji = fs_2, fs_jpim1
269               IF( rnf(ji,jj) /= 0._wp ) THEN
270                  zdep = zfact / h_rnf(ji,jj)
271                  DO jk = 1, nk_rnf(ji,jj)
272                                        tsa(ji,jj,jk,jp_tem) = tsa(ji,jj,jk,jp_tem)   &
273                                          &               +  ( rnf_tsc_b(ji,jj,jp_tem) + rnf_tsc(ji,jj,jp_tem) ) * zdep
274                     IF( ln_rnf_sal )   tsa(ji,jj,jk,jp_sal) = tsa(ji,jj,jk,jp_sal)   &
275                                          &               +  ( rnf_tsc_b(ji,jj,jp_sal) + rnf_tsc(ji,jj,jp_sal) ) * zdep 
276                  END DO
277               ENDIF
278            END DO 
279         END DO 
280      ENDIF
281 
282      IF( l_trdtra )   THEN                      ! send trends for further diagnostics
283         ztrdt(:,:,:) = tsa(:,:,:,jp_tem) - ztrdt(:,:,:)
284         ztrds(:,:,:) = tsa(:,:,:,jp_sal) - ztrds(:,:,:)
285         CALL trd_tra( kt, 'TRA', jp_tem, jptra_nsr, ztrdt )
286         CALL trd_tra( kt, 'TRA', jp_sal, jptra_nsr, ztrds )
287         CALL wrk_dealloc( jpi, jpj, jpk, ztrdt, ztrds ) 
288      ENDIF
289      !
290      IF(ln_ctl)   CALL prt_ctl( tab3d_1=tsa(:,:,:,jp_tem), clinfo1=' sbc  - Ta: ', mask1=tmask,   &
291         &                       tab3d_2=tsa(:,:,:,jp_sal), clinfo2=       ' Sa: ', mask2=tmask, clinfo3='tra' )
292      !
293      IF( nn_timing == 1 )  CALL timing_stop('tra_sbc')
294      !
295   END SUBROUTINE tra_sbc
296
297   !!======================================================================
298END MODULE trasbc
Note: See TracBrowser for help on using the repository browser.