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.
trcsbc.F90 in branches/DEV_r2006_merge_TRA_TRC/NEMO/TOP_SRC/TRP – NEMO

source: branches/DEV_r2006_merge_TRA_TRC/NEMO/TOP_SRC/TRP/trcsbc.F90 @ 2052

Last change on this file since 2052 was 2052, checked in by cetlod, 13 years ago

Improve the merge TRA-TRC, see ticket:701

  • Property svn:executable set to *
  • Property svn:keywords set to Id
File size: 6.0 KB
Line 
1MODULE trcsbc
2   !!==============================================================================
3   !!                       ***  MODULE  trcsbc  ***
4   !! Ocean passive tracers:  surface boundary condition
5   !!======================================================================
6   !! History :  8.2  !  1998-10  (G. Madec, G. Roullet, M. Imbard)  Original code
7   !!            8.2  !  2001-02  (D. Ludicone)  sea ice and free surface
8   !!            8.5  !  2002-06  (G. Madec)  F90: Free form and module
9   !!            9.0  !  2004-03  (C. Ethe)  adapted for passive tracers
10   !!                 !  2006-08  (C. Deltel) Diagnose ML trends for passive tracers
11   !!==============================================================================
12#if defined key_top
13   !!----------------------------------------------------------------------
14   !!   'key_top'                                                TOP models
15   !!----------------------------------------------------------------------
16   !!   trc_sbc      : update the tracer trend at ocean surface
17   !!----------------------------------------------------------------------
18   !! * Modules used
19   USE oce_trc             ! ocean dynamics and active tracers variables
20   USE trc                 ! ocean  passive tracers variables
21   USE prtctl_trc          ! Print control for debbuging
22   USE trdmod_oce
23   USE trdtra
24
25   IMPLICIT NONE
26   PRIVATE
27
28   !! * Routine accessibility
29   PUBLIC trc_sbc              ! routine called by step.F90
30
31   !! * Substitutions
32#  include "top_substitute.h90"
33   !!----------------------------------------------------------------------
34   !!   TOP 1.0 , LOCEAN-IPSL (2005)
35   !! $Id$
36   !! This software is governed by the CeCILL licence see modipsl/doc/NEMO_CeCILL.txt
37   !!----------------------------------------------------------------------
38
39CONTAINS
40
41   SUBROUTINE trc_sbc ( kt )
42      !!----------------------------------------------------------------------
43      !!                  ***  ROUTINE trc_sbc  ***
44      !!                   
45      !! ** Purpose :   Compute the tracer surface boundary condition trend of
46      !!      (concentration/dilution effect) and add it to the general
47      !!       trend of tracer equations.
48      !!
49      !! ** Method :
50      !!      * concentration/dilution effect:
51      !!            The surface freshwater flux modify the ocean volume
52      !!         and thus the concentration of a tracer as :
53      !!            tra = tra + emp * trn / e3t   for k=1
54      !!         where emp, the surface freshwater budget (evaporation minus
55      !!         precipitation minus runoff) given in kg/m2/s is divided
56      !!         by 1035 kg/m3 (density of ocean water) to obtain m/s.
57      !!
58      !! ** Action  : - Update the 1st level of tra with the trend associated
59      !!                with the tracer surface boundary condition
60      !!
61      !!----------------------------------------------------------------------
62      !! * Arguments
63      INTEGER, INTENT( in ) ::   kt          ! ocean time-step index
64
65      !! * Local declarations
66      INTEGER  ::   ji, jj, jn           ! dummy loop indices
67      REAL(wp) ::   ztra, zsrau, zse3t   ! temporary scalars
68      REAL(wp), DIMENSION(jpi,jpj) ::   zemps  ! surface freshwater flux
69      REAL(wp), DIMENSION(:,:,:), ALLOCATABLE ::   ztrtrd
70      CHARACTER (len=22) :: charout
71      !!----------------------------------------------------------------------
72
73      IF( kt == nittrc000 ) THEN
74         IF(lwp) WRITE(numout,*)
75         IF(lwp) WRITE(numout,*) 'trc_sbc : Passive tracers surface boundary condition'
76         IF(lwp) WRITE(numout,*) '~~~~~~~ '
77      ENDIF
78
79
80      IF( l_trdtrc ) ALLOCATE( ztrtrd(jpi,jpj,jpk) )
81
82#if ! defined key_offline
83      ! Concentration dilution effect on tracer due to evaporation, precipitation, and river runoff
84      IF( lk_vvl ) THEN   ;   zemps(:,:) = emps(:,:) - emp(:,:)   ! volume variable
85      ELSE                ;   zemps(:,:) = emps(:,:) - rnf(:,:)   ! linear free surface
86      ENDIF 
87#else
88      ! emps in dynamical files contains emps - rnf
89      IF( lk_vvl ) THEN   ;   zemps(:,:) = 0.         ! No concentration/dilution effect
90      ELSE                ;   zemps(:,:) = emps(:,:)  ! emps -rnf
91      ENDIF
92#endif
93      ! 0. initialization
94      zsrau = 1. / rau0
95#if defined key_zco
96      zse3t = 1. / e3t_0(1)
97#endif
98
99      DO jn = 1, jptra
100         !
101         IF( l_trdtrc ) ztrtrd(:,:,:) = tra(:,:,:,jn)  ! save trends
102
103         DO jj = 2, jpj
104            DO ji = fs_2, fs_jpim1   ! vector opt.
105#if ! defined key_zco
106               zse3t = 1. / fse3t(ji,jj,1)
107#endif
108               ! add the trend to the general tracer trend
109               ztra = zemps(ji,jj) *  zsrau * trn(ji,jj,1,jn) * zse3t
110               tra(ji,jj,1,jn) = tra(ji,jj,1,jn) + ztra
111            END DO
112         END DO
113         
114         IF( l_trdtrc ) THEN
115            ztrtrd(:,:,:) = tra(:,:,:,jn) - ztrtrd(:,:,:)
116            CALL trd_tra( kt, 'TRC', jn, jptra_trd_nsr, ztrtrd )
117         END IF
118         !                                                       ! ===========
119      END DO                                                     ! tracer loop
120      !                                                          ! ===========
121      IF( l_trdtrc ) DEALLOCATE( ztrtrd )
122
123      IF( ln_ctl )   THEN
124         WRITE(charout, FMT="('sbc ')") ;  CALL prt_ctl_trc_info(charout)
125                                           CALL prt_ctl_trc( tab4d=tra, mask=tmask, clinfo=ctrcnm, clinfo2='trd' )
126      ENDIF
127
128   END SUBROUTINE trc_sbc
129
130#else
131   !!----------------------------------------------------------------------
132   !!   Dummy module :                      NO passive tracer
133   !!----------------------------------------------------------------------
134CONTAINS
135   SUBROUTINE trc_sbc (kt)              ! Empty routine
136      INTEGER, INTENT(in) :: kt
137      WRITE(*,*) 'trc_sbc: You should not have seen this print! error?', kt
138   END SUBROUTINE trc_sbc
139#endif
140   
141   !!======================================================================
142END MODULE trcsbc
Note: See TracBrowser for help on using the repository browser.