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.
traqsr.F90 in NEMO/branches/2019/dev_r11351_fldread_with_XIOS/src/OCE/TRA – NEMO

source: NEMO/branches/2019/dev_r11351_fldread_with_XIOS/src/OCE/TRA/traqsr.F90 @ 13463

Last change on this file since 13463 was 13463, checked in by andmirek, 4 years ago

Ticket #2195:update to trunk 13461

  • Property svn:keywords set to Id
File size: 23.0 KB
Line 
1MODULE traqsr
2   !!======================================================================
3   !!                       ***  MODULE  traqsr  ***
4   !! Ocean physics:   solar radiation penetration in the top ocean levels
5   !!======================================================================
6   !! History :  OPA  !  1990-10  (B. Blanke)  Original code
7   !!            7.0  !  1991-11  (G. Madec)
8   !!                 !  1996-01  (G. Madec)  s-coordinates
9   !!   NEMO     1.0  !  2002-06  (G. Madec)  F90: Free form and module
10   !!             -   !  2005-11  (G. Madec) zco, zps, sco coordinate
11   !!            3.2  !  2009-04  (G. Madec & NEMO team)
12   !!            3.6  !  2012-05  (C. Rousset) store attenuation coef for use in ice model
13   !!            3.6  !  2015-12  (O. Aumont, J. Jouanno, C. Ethe) use vertical profile of chlorophyll
14   !!            3.7  !  2015-11  (G. Madec, A. Coward)  remove optimisation for fix volume
15   !!----------------------------------------------------------------------
16
17   !!----------------------------------------------------------------------
18   !!   tra_qsr       : temperature trend due to the penetration of solar radiation
19   !!   tra_qsr_init  : initialization of the qsr penetration
20   !!----------------------------------------------------------------------
21   USE oce            ! ocean dynamics and active tracers
22   USE phycst         ! physical constants
23   USE dom_oce        ! ocean space and time domain
24   USE sbc_oce        ! surface boundary condition: ocean
25   USE trc_oce        ! share SMS/Ocean variables
26   USE trd_oce        ! trends: ocean variables
27   USE trdtra         ! trends manager: tracers
28   !
29   USE in_out_manager ! I/O manager
30   USE prtctl         ! Print control
31   USE iom            ! I/O library
32   USE fldread        ! read input fields
33   USE restart        ! ocean restart
34   USE lib_mpp        ! MPP library
35   USE lbclnk         ! ocean lateral boundary conditions (or mpp link)
36   USE timing         ! Timing
37
38   IMPLICIT NONE
39   PRIVATE
40
41   PUBLIC   tra_qsr       ! routine called by step.F90 (ln_traqsr=T)
42   PUBLIC   tra_qsr_init  ! routine called by nemogcm.F90
43
44   !                                 !!* Namelist namtra_qsr: penetrative solar radiation
45   LOGICAL , PUBLIC ::   ln_traqsr    !: light absorption (qsr) flag
46   LOGICAL , PUBLIC ::   ln_qsr_rgb   !: Red-Green-Blue light absorption flag 
47   LOGICAL , PUBLIC ::   ln_qsr_2bd   !: 2 band         light absorption flag
48   LOGICAL , PUBLIC ::   ln_qsr_bio   !: bio-model      light absorption flag
49   INTEGER , PUBLIC ::   nn_chldta    !: use Chlorophyll data (=1) or not (=0)
50   REAL(wp), PUBLIC ::   rn_abs       !: fraction absorbed in the very near surface (RGB & 2 bands)
51   REAL(wp), PUBLIC ::   rn_si0       !: very near surface depth of extinction      (RGB & 2 bands)
52   REAL(wp), PUBLIC ::   rn_si1       !: deepest depth of extinction (water type I)       (2 bands)
53   !
54   INTEGER , PUBLIC ::   nksr         !: levels below which the light cannot penetrate (depth larger than 391 m)
55 
56   INTEGER, PARAMETER ::   np_RGB  = 1   ! R-G-B     light penetration with constant Chlorophyll
57   INTEGER, PARAMETER ::   np_RGBc = 2   ! R-G-B     light penetration with Chlorophyll data
58   INTEGER, PARAMETER ::   np_2BD  = 3   ! 2 bands   light penetration
59   INTEGER, PARAMETER ::   np_BIO  = 4   ! bio-model light penetration
60   !
61   INTEGER  ::   nqsr    ! user choice of the type of light penetration
62   REAL(wp) ::   xsi0r   ! inverse of rn_si0
63   REAL(wp) ::   xsi1r   ! inverse of rn_si1
64   !
65   REAL(wp) , PUBLIC, DIMENSION(3,61)   ::   rkrgb    ! tabulated attenuation coefficients for RGB absorption
66   TYPE(FLD), ALLOCATABLE, DIMENSION(:) ::   sf_chl   ! structure of input Chl (file informations, fields read)
67
68   !! * Substitutions
69#  include "do_loop_substitute.h90"
70#  include "domzgr_substitute.h90"
71   !!----------------------------------------------------------------------
72   !! NEMO/OCE 4.0 , NEMO Consortium (2018)
73   !! $Id$
74   !! Software governed by the CeCILL license (see ./LICENSE)
75   !!----------------------------------------------------------------------
76CONTAINS
77
78   SUBROUTINE tra_qsr( kt, Kmm, pts, Krhs )
79      !!----------------------------------------------------------------------
80      !!                  ***  ROUTINE tra_qsr  ***
81      !!
82      !! ** Purpose :   Compute the temperature trend due to the solar radiation
83      !!              penetration and add it to the general temperature trend.
84      !!
85      !! ** Method  : The profile of the solar radiation within the ocean is defined
86      !!      through 2 wavebands (rn_si0,rn_si1) or 3 wavebands (RGB) and a ratio rn_abs
87      !!      Considering the 2 wavebands case:
88      !!         I(k) = Qsr*( rn_abs*EXP(z(k)/rn_si0) + (1.-rn_abs)*EXP(z(k)/rn_si1) )
89      !!         The temperature trend associated with the solar radiation penetration
90      !!         is given by : zta = 1/e3t dk[ I ] / (rho0*Cp)
91      !!         At the bottom, boudary condition for the radiation is no flux :
92      !!      all heat which has not been absorbed in the above levels is put
93      !!      in the last ocean level.
94      !!         The computation is only done down to the level where
95      !!      I(k) < 1.e-15 W/m2 (i.e. over the top nksr levels) .
96      !!
97      !! ** Action  : - update ta with the penetrative solar radiation trend
98      !!              - send  trend for further diagnostics (l_trdtra=T)
99      !!
100      !! Reference  : Jerlov, N. G., 1968 Optical Oceanography, Elsevier, 194pp.
101      !!              Lengaigne et al. 2007, Clim. Dyn., V28, 5, 503-516.
102      !!              Morel, A. et Berthon, JF, 1989, Limnol Oceanogr 34(8), 1545-1562
103      !!----------------------------------------------------------------------
104      INTEGER,                                   INTENT(in   ) :: kt            ! ocean time-step
105      INTEGER,                                   INTENT(in   ) :: Kmm, Krhs     ! time level indices
106      REAL(wp), DIMENSION(jpi,jpj,jpk,jpts,jpt), INTENT(inout) :: pts           ! active tracers and RHS of tracer equation
107      !
108      INTEGER  ::   ji, jj, jk               ! dummy loop indices
109      INTEGER  ::   irgb                     ! local integers
110      REAL(wp) ::   zchl, zcoef, z1_2        ! local scalars
111      REAL(wp) ::   zc0 , zc1 , zc2 , zc3    !    -         -
112      REAL(wp) ::   zzc0, zzc1, zzc2, zzc3   !    -         -
113      REAL(wp) ::   zz0 , zz1 , ze3t, zlui   !    -         -
114      REAL(wp) ::   zCb, zCmax, zpsi, zpsimax, zrdpsi, zCze
115      REAL(wp) ::   zlogc, zlogze, zlogCtot, zlogCze
116      REAL(wp), ALLOCATABLE, DIMENSION(:,:)   :: ze0, ze1, ze2, ze3
117      REAL(wp), ALLOCATABLE, DIMENSION(:,:,:) :: ztrdt, zetot, ztmp3d
118      !!----------------------------------------------------------------------
119      !
120      IF( ln_timing )   CALL timing_start('tra_qsr')
121      !
122      IF( kt == nit000 ) THEN
123         IF(lwp) WRITE(numout,*)
124         IF(lwp) WRITE(numout,*) 'tra_qsr : penetration of the surface solar radiation'
125         IF(lwp) WRITE(numout,*) '~~~~~~~'
126      ENDIF
127      !
128      IF( l_trdtra ) THEN      ! trends diagnostic: save the input temperature trend
129         ALLOCATE( ztrdt(jpi,jpj,jpk) ) 
130         ztrdt(:,:,:) = pts(:,:,:,jp_tem,Krhs)
131      ENDIF
132      !
133      !                         !-----------------------------------!
134      !                         !  before qsr induced heat content  !
135      !                         !-----------------------------------!
136      IF( kt == nit000 ) THEN          !==  1st time step  ==!
137         IF( ln_rstart .AND. iom_varid( numror, 'qsr_hc_b', ldstop = .FALSE. ) > 0  .AND. .NOT.l_1st_euler ) THEN    ! read in restart
138            IF(lwp) WRITE(numout,*) '          nit000-1 qsr tracer content forcing field read in the restart file'
139            z1_2 = 0.5_wp
140            IF(lrxios) CALL iom_swap( TRIM(crxios_context) )
141            CALL iom_get( numror, jpdom_auto, 'qsr_hc_b', qsr_hc_b, ldxios = lrxios )   ! before heat content trend due to Qsr flux
142            IF(lrxios) CALL iom_swap( TRIM(cxios_context) )
143         ELSE                                           ! No restart or restart not found: Euler forward time stepping
144            z1_2 = 1._wp
145            qsr_hc_b(:,:,:) = 0._wp
146         ENDIF
147      ELSE                             !==  Swap of qsr heat content  ==!
148         z1_2 = 0.5_wp
149         qsr_hc_b(:,:,:) = qsr_hc(:,:,:)
150      ENDIF
151      !
152      !                         !--------------------------------!
153      SELECT CASE( nqsr )       !  now qsr induced heat content  !
154      !                         !--------------------------------!
155      !
156      CASE( np_BIO )                   !==  bio-model fluxes  ==!
157         !
158         DO jk = 1, nksr
159            qsr_hc(:,:,jk) = r1_rho0_rcp * ( etot3(:,:,jk) - etot3(:,:,jk+1) )
160         END DO
161         !
162      CASE( np_RGB , np_RGBc )         !==  R-G-B fluxes  ==!
163         !
164         ALLOCATE( ze0 (jpi,jpj)           , ze1 (jpi,jpj) ,   &
165            &      ze2 (jpi,jpj)           , ze3 (jpi,jpj) ,   &
166            &      ztmp3d(jpi,jpj,nksr + 1)                     )
167         !
168         IF( nqsr == np_RGBc ) THEN          !*  Variable Chlorophyll
169            CALL fld_read( kt, 1, sf_chl )         ! Read Chl data and provides it at the current time step
170            !
171            ! Separation in R-G-B depending on the surface Chl
172            ! perform and store as many of the 2D calculations as possible
173            ! before the 3D loop (use the temporary 2D arrays to replace the
174            ! most expensive calculations)
175            !
176            DO_2D( 0, 0, 0, 0 )
177                       ! zlogc = log(zchl)
178               zlogc = LOG ( MIN( 10. , MAX( 0.03, sf_chl(1)%fnow(ji,jj,1) ) ) )     
179                       ! zc1 : log(zCze)  = log (1.12  * zchl**0.803)
180               zc1   = 0.113328685307 + 0.803 * zlogc                         
181                       ! zc2 : log(zCtot) = log(40.6  * zchl**0.459)
182               zc2   = 3.703768066608 + 0.459 * zlogc                           
183                       ! zc3 : log(zze)   = log(568.2 * zCtot**(-0.746))
184               zc3   = 6.34247346942  - 0.746 * zc2                           
185                       ! IF( log(zze) > log(102.) ) log(zze) = log(200.0 * zCtot**(-0.293))
186               IF( zc3 > 4.62497281328 ) zc3 = 5.298317366548 - 0.293 * zc2       
187               !   
188               ze0(ji,jj) = zlogc                                                 ! ze0 = log(zchl)
189               ze1(ji,jj) = EXP( zc1 )                                            ! ze1 = zCze
190               ze2(ji,jj) = 1._wp / ( 0.710 + zlogc * ( 0.159 + zlogc * 0.021 ) ) ! ze2 = 1/zdelpsi
191               ze3(ji,jj) = EXP( - zc3 )                                          ! ze3 = 1/zze
192            END_2D
193           
194!
195            DO_3D( 0, 0, 0, 0, 1, nksr + 1 )
196               ! zchl    = ALOG( ze0(ji,jj) )
197               zlogc = ze0(ji,jj)
198               !
199               zCb       = 0.768 + zlogc * ( 0.087 - zlogc * ( 0.179 + zlogc * 0.025 ) )
200               zCmax     = 0.299 - zlogc * ( 0.289 - zlogc * 0.579 )
201               zpsimax   = 0.6   - zlogc * ( 0.640 - zlogc * ( 0.021 + zlogc * 0.115 ) )
202               ! zdelpsi = 0.710 + zlogc * ( 0.159 + zlogc * 0.021 )
203               !
204               zCze   = ze1(ji,jj)
205               zrdpsi = ze2(ji,jj)                                                 ! 1/zdelpsi
206               zpsi   = ze3(ji,jj) * gdepw(ji,jj,jk,Kmm)                           ! gdepw/zze
207               !
208               ! NB. make sure zchl value is such that: zchl = MIN( 10. , MAX( 0.03, zchl ) )
209               zchl = MIN( 10. , MAX( 0.03, zCze * ( zCb + zCmax * EXP( -( (zpsi - zpsimax) * zrdpsi )**2 ) ) ) )
210               ! Convert chlorophyll value to attenuation coefficient look-up table index
211               ztmp3d(ji,jj,jk) = 41 + 20.*LOG10(zchl) + 1.e-15
212            END_3D
213         ELSE                                !* constant chlorophyll
214            zchl = 0.05
215            ! NB. make sure constant value is such that:
216            zchl = MIN( 10. , MAX( 0.03, zchl ) )
217            ! Convert chlorophyll value to attenuation coefficient look-up table index
218            zlui = 41 + 20.*LOG10(zchl) + 1.e-15
219            DO jk = 1, nksr + 1
220               ztmp3d(:,:,jk) = zlui 
221            END DO
222         ENDIF
223         !
224         zcoef  = ( 1. - rn_abs ) / 3._wp    !* surface equi-partition in R-G-B
225         DO_2D( 0, 0, 0, 0 )
226            ze0(ji,jj) = rn_abs * qsr(ji,jj)
227            ze1(ji,jj) = zcoef  * qsr(ji,jj)
228            ze2(ji,jj) = zcoef  * qsr(ji,jj)
229            ze3(ji,jj) = zcoef  * qsr(ji,jj)
230            ! store the surface SW radiation; re-use the surface ztmp3d array
231            ! since the surface attenuation coefficient is not used
232            ztmp3d(ji,jj,1) =       qsr(ji,jj)
233         END_2D
234         !
235         !* interior equi-partition in R-G-B depending on vertical profile of Chl
236         DO_3D( 0, 0, 0, 0, 2, nksr + 1 )
237            ze3t = e3t(ji,jj,jk-1,Kmm)
238            irgb = NINT( ztmp3d(ji,jj,jk) )
239            zc0 = ze0(ji,jj) * EXP( - ze3t * xsi0r )
240            zc1 = ze1(ji,jj) * EXP( - ze3t * rkrgb(1,irgb) )
241            zc2 = ze2(ji,jj) * EXP( - ze3t * rkrgb(2,irgb) )
242            zc3 = ze3(ji,jj) * EXP( - ze3t * rkrgb(3,irgb) )
243            ze0(ji,jj) = zc0
244            ze1(ji,jj) = zc1
245            ze2(ji,jj) = zc2
246            ze3(ji,jj) = zc3
247            ztmp3d(ji,jj,jk) = ( zc0 + zc1 + zc2 + zc3 ) * wmask(ji,jj,jk)
248         END_3D
249         !
250         DO_3D( 0, 0, 0, 0, 1, nksr )
251            qsr_hc(ji,jj,jk) = r1_rho0_rcp * ( ztmp3d(ji,jj,jk) - ztmp3d(ji,jj,jk+1) )
252         END_3D
253         !
254         DEALLOCATE( ze0 , ze1 , ze2 , ze3 , ztmp3d ) 
255         !
256      CASE( np_2BD  )            !==  2-bands fluxes  ==!
257         !
258         zz0 =        rn_abs   * r1_rho0_rcp      ! surface equi-partition in 2-bands
259         zz1 = ( 1. - rn_abs ) * r1_rho0_rcp
260         DO_3D( 0, 0, 0, 0, 1, nksr )
261            zc0 = zz0 * EXP( -gdepw(ji,jj,jk  ,Kmm)*xsi0r ) + zz1 * EXP( -gdepw(ji,jj,jk  ,Kmm)*xsi1r )
262            zc1 = zz0 * EXP( -gdepw(ji,jj,jk+1,Kmm)*xsi0r ) + zz1 * EXP( -gdepw(ji,jj,jk+1,Kmm)*xsi1r )
263            qsr_hc(ji,jj,jk) = qsr(ji,jj) * ( zc0 * wmask(ji,jj,jk) - zc1 * wmask(ji,jj,jk+1) ) 
264         END_3D
265         !
266      END SELECT
267      !
268      !                          !-----------------------------!
269      DO_3D( 0, 0, 0, 0, 1, nksr )
270         pts(ji,jj,jk,jp_tem,Krhs) = pts(ji,jj,jk,jp_tem,Krhs)   &
271            &                      + z1_2 * ( qsr_hc_b(ji,jj,jk) + qsr_hc(ji,jj,jk) )   &
272            &                             / e3t(ji,jj,jk,Kmm)
273      END_3D
274      !
275      ! sea-ice: store the 1st ocean level attenuation coefficient
276      DO_2D( 0, 0, 0, 0 )
277         IF( qsr(ji,jj) /= 0._wp ) THEN   ;   fraqsr_1lev(ji,jj) = qsr_hc(ji,jj,1) / ( r1_rho0_rcp * qsr(ji,jj) )
278         ELSE                             ;   fraqsr_1lev(ji,jj) = 1._wp
279         ENDIF
280      END_2D
281      CALL lbc_lnk( 'traqsr', fraqsr_1lev(:,:), 'T', 1._wp )
282      !
283      IF( iom_use('qsr3d') ) THEN      ! output the shortwave Radiation distribution
284         ALLOCATE( zetot(jpi,jpj,jpk) )
285         zetot(:,:,nksr+1:jpk) = 0._wp     ! below ~400m set to zero
286         DO jk = nksr, 1, -1
287            zetot(:,:,jk) = zetot(:,:,jk+1) + qsr_hc(:,:,jk) * rho0_rcp
288         END DO         
289         CALL iom_put( 'qsr3d', zetot )   ! 3D distribution of shortwave Radiation
290         DEALLOCATE( zetot ) 
291      ENDIF
292      !
293      IF( lrst_oce ) THEN     ! write in the ocean restart file
294         IF( lwxios ) CALL iom_swap(      cwxios_context          )
295         CALL iom_rstput( kt, nitrst, numrow, 'qsr_hc_b'   , qsr_hc     , ldxios = lwxios )
296         CALL iom_rstput( kt, nitrst, numrow, 'fraqsr_1lev', fraqsr_1lev, ldxios = lwxios ) 
297         IF( lwxios ) CALL iom_swap(      cxios_context          )
298      ENDIF
299      !
300      IF( l_trdtra ) THEN     ! qsr tracers trends saved for diagnostics
301         ztrdt(:,:,:) = pts(:,:,:,jp_tem,Krhs) - ztrdt(:,:,:)
302         CALL trd_tra( kt, Kmm, Krhs, 'TRA', jp_tem, jptra_qsr, ztrdt )
303         DEALLOCATE( ztrdt ) 
304      ENDIF
305      !                       ! print mean trends (used for debugging)
306      IF(sn_cfctl%l_prtctl)   CALL prt_ctl( tab3d_1=pts(:,:,:,jp_tem,Krhs), clinfo1=' qsr  - Ta: ', mask1=tmask, clinfo3='tra-ta' )
307      !
308      IF( ln_timing )   CALL timing_stop('tra_qsr')
309      !
310   END SUBROUTINE tra_qsr
311
312
313   SUBROUTINE tra_qsr_init
314      !!----------------------------------------------------------------------
315      !!                  ***  ROUTINE tra_qsr_init  ***
316      !!
317      !! ** Purpose :   Initialization for the penetrative solar radiation
318      !!
319      !! ** Method  :   The profile of solar radiation within the ocean is set
320      !!      from two length scale of penetration (rn_si0,rn_si1) and a ratio
321      !!      (rn_abs). These parameters are read in the namtra_qsr namelist. The
322      !!      default values correspond to clear water (type I in Jerlov'
323      !!      (1968) classification.
324      !!         called by tra_qsr at the first timestep (nit000)
325      !!
326      !! ** Action  : - initialize rn_si0, rn_si1 and rn_abs
327      !!
328      !! Reference : Jerlov, N. G., 1968 Optical Oceanography, Elsevier, 194pp.
329      !!----------------------------------------------------------------------
330      INTEGER  ::   ji, jj, jk                  ! dummy loop indices
331      INTEGER  ::   ios, irgb, ierror, ioptio   ! local integer
332      REAL(wp) ::   zz0, zc0 , zc1, zcoef      ! local scalars
333      REAL(wp) ::   zz1, zc2 , zc3, zchl       !   -      -
334      !
335      CHARACTER(len=100) ::   cn_dir   ! Root directory for location of ssr files
336      TYPE(FLD_N)        ::   sn_chl   ! informations about the chlorofyl field to be read
337      !!
338      NAMELIST/namtra_qsr/  sn_chl, cn_dir, ln_qsr_rgb, ln_qsr_2bd, ln_qsr_bio,  &
339         &                  nn_chldta, rn_abs, rn_si0, rn_si1
340      !!----------------------------------------------------------------------
341      !
342      READ  ( numnam_ref, namtra_qsr, IOSTAT = ios, ERR = 901)
343901   IF( ios /= 0 )   CALL ctl_nam ( ios , 'namtra_qsr in reference namelist' )
344      !
345      READ  ( numnam_cfg, namtra_qsr, IOSTAT = ios, ERR = 902 )
346902   IF( ios >  0 )   CALL ctl_nam ( ios , 'namtra_qsr in configuration namelist' )
347      IF(lwm) WRITE ( numond, namtra_qsr )
348      !
349      IF(lwp) THEN                ! control print
350         WRITE(numout,*)
351         WRITE(numout,*) 'tra_qsr_init : penetration of the surface solar radiation'
352         WRITE(numout,*) '~~~~~~~~~~~~'
353         WRITE(numout,*) '   Namelist namtra_qsr : set the parameter of penetration'
354         WRITE(numout,*) '      RGB (Red-Green-Blue) light penetration       ln_qsr_rgb = ', ln_qsr_rgb
355         WRITE(numout,*) '      2 band               light penetration       ln_qsr_2bd = ', ln_qsr_2bd
356         WRITE(numout,*) '      bio-model            light penetration       ln_qsr_bio = ', ln_qsr_bio
357         WRITE(numout,*) '      RGB : Chl data (=1) or cst value (=0)        nn_chldta  = ', nn_chldta
358         WRITE(numout,*) '      RGB & 2 bands: fraction of light (rn_si1)    rn_abs     = ', rn_abs
359         WRITE(numout,*) '      RGB & 2 bands: shortess depth of extinction  rn_si0     = ', rn_si0
360         WRITE(numout,*) '      2 bands: longest depth of extinction         rn_si1     = ', rn_si1
361         WRITE(numout,*)
362      ENDIF
363      !
364      ioptio = 0                    ! Parameter control
365      IF( ln_qsr_rgb  )   ioptio = ioptio + 1
366      IF( ln_qsr_2bd  )   ioptio = ioptio + 1
367      IF( ln_qsr_bio  )   ioptio = ioptio + 1
368      !
369      IF( ioptio /= 1 )   CALL ctl_stop( 'Choose ONE type of light penetration in namelist namtra_qsr',  &
370         &                               ' 2 bands, 3 RGB bands or bio-model light penetration' )
371      !
372      IF( ln_qsr_rgb .AND. nn_chldta == 0 )   nqsr = np_RGB 
373      IF( ln_qsr_rgb .AND. nn_chldta == 1 )   nqsr = np_RGBc
374      IF( ln_qsr_2bd                      )   nqsr = np_2BD
375      IF( ln_qsr_bio                      )   nqsr = np_BIO
376      !
377      !                             ! Initialisation
378      xsi0r = 1._wp / rn_si0
379      xsi1r = 1._wp / rn_si1
380      !
381      SELECT CASE( nqsr )
382      !                               
383      CASE( np_RGB , np_RGBc )         !==  Red-Green-Blue light penetration  ==!
384         !                             
385         IF(lwp)   WRITE(numout,*) '   ==>>>   R-G-B   light penetration '
386         !
387         CALL trc_oce_rgb( rkrgb )                 ! tabulated attenuation coef.
388         !                                   
389         nksr = trc_oce_ext_lev( r_si2, 33._wp )   ! level of light extinction
390         !
391         IF(lwp) WRITE(numout,*) '        level of light extinction = ', nksr, ' ref depth = ', gdepw_1d(nksr+1), ' m'
392         !
393         IF( nqsr == np_RGBc ) THEN                ! Chl data : set sf_chl structure
394            IF(lwp) WRITE(numout,*) '   ==>>>   Chlorophyll read in a file'
395            ALLOCATE( sf_chl(1), STAT=ierror )
396            IF( ierror > 0 ) THEN
397               CALL ctl_stop( 'tra_qsr_init: unable to allocate sf_chl structure' )   ;   RETURN
398            ENDIF
399            ALLOCATE( sf_chl(1)%fnow(jpi,jpj,1)   )
400            IF( sn_chl%ln_tint )   ALLOCATE( sf_chl(1)%fdta(jpi,jpj,1,2) )
401            !                                        ! fill sf_chl with sn_chl and control print
402            CALL fld_fill( sf_chl, (/ sn_chl /), cn_dir, 'tra_qsr_init',   &
403               &           'Solar penetration function of read chlorophyll', 'namtra_qsr' , no_print )
404         ENDIF
405         IF( nqsr == np_RGB ) THEN                 ! constant Chl
406            IF(lwp) WRITE(numout,*) '   ==>>>   Constant Chlorophyll concentration = 0.05'
407         ENDIF
408         !
409      CASE( np_2BD )                   !==  2 bands light penetration  ==!
410         !
411         IF(lwp)  WRITE(numout,*) '   ==>>>   2 bands light penetration'
412         !
413         nksr = trc_oce_ext_lev( rn_si1, 100._wp )    ! level of light extinction
414         IF(lwp) WRITE(numout,*) '        level of light extinction = ', nksr, ' ref depth = ', gdepw_1d(nksr+1), ' m'
415         !
416      CASE( np_BIO )                   !==  BIO light penetration  ==!
417         !
418         IF(lwp) WRITE(numout,*) '   ==>>>   bio-model light penetration'
419         IF( .NOT.lk_top )   CALL ctl_stop( 'No bio model : ln_qsr_bio = true impossible ' )
420         !
421         CALL trc_oce_rgb( rkrgb )                 ! tabulated attenuation coef.
422         !                                   
423         nksr = trc_oce_ext_lev( r_si2, 33._wp )   ! level of light extinction
424         !
425         IF(lwp) WRITE(numout,*) '        level of light extinction = ', nksr, ' ref depth = ', gdepw_1d(nksr+1), ' m'
426         !
427      END SELECT
428      !
429      qsr_hc(:,:,:) = 0._wp     ! now qsr heat content set to zero where it will not be computed
430      !
431      ! 1st ocean level attenuation coefficient (used in sbcssm)
432      IF( iom_varid( numror, 'fraqsr_1lev', ldstop = .FALSE. ) > 0 ) THEN
433         CALL iom_get( numror, jpdom_auto, 'fraqsr_1lev'  , fraqsr_1lev, ldxios = lrxios  )
434      ELSE
435         fraqsr_1lev(:,:) = 1._wp   ! default : no penetration
436      ENDIF
437      !
438      IF( lwxios ) THEN
439         CALL iom_set_rstw_var_active('qsr_hc_b')
440         CALL iom_set_rstw_var_active('fraqsr_1lev')
441      ENDIF
442      !
443   END SUBROUTINE tra_qsr_init
444
445   !!======================================================================
446END MODULE traqsr
Note: See TracBrowser for help on using the repository browser.