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 branches/UKMO/dev_r5518_GO6_package_FOAMv14/NEMOGCM/NEMO/OPA_SRC/TRA – NEMO

Context Navigation

source: branches/UKMO/dev_r5518_GO6_package_FOAMv14/NEMOGCM/NEMO/OPA_SRC/TRA/traqsr.F90 @ 11442

Last change on this file since 11442 was 11442, checked in by mattmartin, 5 years ago
Introduction of stochastic physics in NEMO, based on Andrea Storto's code. For details, see ticket https://code.metoffice.gov.uk/trac/utils/ticket/251.
File size: 32.9 KB

Rev	Line
[3]	1	MODULE traqsr
	2	!!======================================================================
	3	!! * MODULE traqsr *
	4	!! Ocean physics: solar radiation penetration in the top ocean levels
	5	!!======================================================================
[1423]	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)
[6498]	12	!! 3.4 ! 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
[3]	14	!!----------------------------------------------------------------------
[503]	15
	16	!!----------------------------------------------------------------------
[3]	17	!! tra_qsr : trend due to the solar radiation penetration
	18	!! tra_qsr_init : solar radiation penetration initialization
	19	!!----------------------------------------------------------------------
	20	USE oce ! ocean dynamics and active tracers
	21	USE dom_oce ! ocean space and time domain
[888]	22	USE sbc_oce ! surface boundary condition: ocean
	23	USE trc_oce ! share SMS/Ocean variables
[4990]	24	USE trd_oce ! trends: ocean variables
	25	USE trdtra ! trends manager: tracers
[3]	26	USE in_out_manager ! I/O manager
	27	USE phycst ! physical constants
[258]	28	USE prtctl ! Print control
[1423]	29	USE iom ! I/O manager
	30	USE fldread ! read input fields
[4161]	31	USE restart ! ocean restart
[2715]	32	USE lib_mpp ! MPP library
[3294]	33	USE wrk_nemo ! Memory Allocation
	34	USE timing ! Timing
[11442]	35	USE stopack
[3]	36
	37	IMPLICIT NONE
	38	PRIVATE
	39
[2528]	40	PUBLIC tra_qsr ! routine called by step.F90 (ln_traqsr=T)
[5407]	41	PUBLIC tra_qsr_init ! routine called by nemogcm.F90
[3]	42
[4147]	43	! !!* Namelist namtra_qsr: penetrative solar radiation
	44	LOGICAL , PUBLIC :: ln_traqsr !: light absorption (qsr) flag
	45	LOGICAL , PUBLIC :: ln_qsr_rgb !: Red-Green-Blue light absorption flag
	46	LOGICAL , PUBLIC :: ln_qsr_2bd !: 2 band light absorption flag
	47	LOGICAL , PUBLIC :: ln_qsr_bio !: bio-model light absorption flag
[4205]	48	LOGICAL , PUBLIC :: ln_qsr_ice !: light penetration for ice-model LIM3 (clem)
[4147]	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)
[5407]	53
[1445]	54	! Module variables
[11442]	55	REAL(wp), ALLOCATABLE :: xsi0r(:,:) !: inverse of rn_si0
[2528]	56	REAL(wp) :: xsi1r !: inverse of rn_si1
[1423]	57	TYPE(FLD), ALLOCATABLE, DIMENSION(:) :: sf_chl ! structure of input Chl (file informations, fields read)
[2528]	58	INTEGER, PUBLIC :: nksr ! levels below which the light cannot penetrate ( depth larger than 391 m)
[1445]	59	REAL(wp), DIMENSION(3,61) :: rkrgb !: tabulated attenuation coefficients for RGB absorption
[3]	60
	61	!! * Substitutions
	62	# include "domzgr_substitute.h90"
	63	# include "vectopt_loop_substitute.h90"
	64	!!----------------------------------------------------------------------
[2528]	65	!! NEMO/OPA 3.3 , NEMO Consortium (2010)
[888]	66	!! $Id$
[2715]	67	!! Software governed by the CeCILL licence (NEMOGCM/NEMO_CeCILL.txt)
[3]	68	!!----------------------------------------------------------------------
	69	CONTAINS
	70
	71	SUBROUTINE tra_qsr( kt )
	72	!!----------------------------------------------------------------------
	73	!! * ROUTINE tra_qsr *
	74	!!
	75	!! ** Purpose : Compute the temperature trend due to the solar radiation
	76	!! penetration and add it to the general temperature trend.
	77	!!
[1423]	78	!! ** Method : The profile of the solar radiation within the ocean is defined
	79	!! through 2 wavebands (rn_si0,rn_si1) or 3 wavebands (RGB) and a ratio rn_abs
	80	!! Considering the 2 wavebands case:
	81	!! I(k) = Qsr( rn_absEXP(z(k)/rn_si0) + (1.-rn_abs)*EXP(z(k)/rn_si1) )
	82	!! The temperature trend associated with the solar radiation penetration
	83	!! is given by : zta = 1/e3t dk[ I ] / (rau0*Cp)
[3]	84	!! At the bottom, boudary condition for the radiation is no flux :
	85	!! all heat which has not been absorbed in the above levels is put
	86	!! in the last ocean level.
	87	!! In z-coordinate case, the computation is only done down to the
	88	!! level where I(k) < 1.e-15 W/m2. In addition, the coefficients
	89	!! used for the computation are calculated one for once as they
	90	!! depends on k only.
	91	!!
	92	!! ** Action : - update ta with the penetrative solar radiation trend
	93	!! - save the trend in ttrd ('key_trdtra')
[1423]	94	!!
	95	!! Reference : Jerlov, N. G., 1968 Optical Oceanography, Elsevier, 194pp.
	96	!! Lengaigne et al. 2007, Clim. Dyn., V28, 5, 503-516.
[6498]	97	!! Morel, A. et Berthon, JF, 1989, Limnol Oceanogr 34(8), 1545-1562
[503]	98	!!----------------------------------------------------------------------
[2715]	99	!
[503]	100	INTEGER, INTENT(in) :: kt ! ocean time-step
[2715]	101	!
[1423]	102	INTEGER :: ji, jj, jk ! dummy loop indices
[2715]	103	INTEGER :: irgb ! local integers
	104	REAL(wp) :: zchl, zcoef, zfact ! local scalars
[1423]	105	REAL(wp) :: zc0, zc1, zc2, zc3 ! - -
[2715]	106	REAL(wp) :: zz0, zz1, z1_e3t ! - -
[6498]	107	REAL(wp) :: zCb, zCmax, zze, zpsi, zpsimax, zdelpsi, zCtot, zCze
	108	REAL(wp) :: zlogc, zlogc2, zlogc3
[3294]	109	REAL(wp), POINTER, DIMENSION(:,: ) :: zekb, zekg, zekr
[6498]	110	REAL(wp), POINTER, DIMENSION(:,:,:) :: ze0, ze1, ze2, ze3, zea, ztrdt, zchl3d
	111	!!--------------------------------------------------------------------------
[3294]	112	!
	113	IF( nn_timing == 1 ) CALL timing_start('tra_qsr')
	114	!
	115	CALL wrk_alloc( jpi, jpj, zekb, zekg, zekr )
[6498]	116	CALL wrk_alloc( jpi, jpj, jpk, ze0, ze1, ze2, ze3, zea, zchl3d )
[3294]	117	!
[3]	118	IF( kt == nit000 ) THEN
[503]	119	IF(lwp) WRITE(numout,*)
	120	IF(lwp) WRITE(numout,*) 'tra_qsr : penetration of the surface solar radiation'
	121	IF(lwp) WRITE(numout,*) '~~~~~~~'
[1423]	122	IF( .NOT.ln_traqsr ) RETURN
[3]	123	ENDIF
	124
[503]	125	IF( l_trdtra ) THEN ! Save ta and sa trends
[3294]	126	CALL wrk_alloc( jpi, jpj, jpk, ztrdt )
	127	ztrdt(:,:,:) = tsa(:,:,:,jp_tem)
[216]	128	ENDIF
	129
[2528]	130	! Set before qsr tracer content field
	131	! ***********************************
	132	IF( kt == nit000 ) THEN ! Set the forcing field at nit000 - 1
	133	! ! -----------------------------------
[4834]	134	qsr_hc(:,:,:) = 0.e0
	135	!
[2528]	136	IF( ln_rstart .AND. & ! Restart: read in restart file
	137	& iom_varid( numror, 'qsr_hc_b', ldstop = .FALSE. ) > 0 ) THEN
	138	IF(lwp) WRITE(numout,*) ' nit000-1 qsr tracer content forcing field red in the restart file'
	139	zfact = 0.5e0
	140	CALL iom_get( numror, jpdom_autoglo, 'qsr_hc_b', qsr_hc_b ) ! before heat content trend due to Qsr flux
	141	ELSE ! No restart or restart not found: Euler forward time stepping
	142	zfact = 1.e0
	143	qsr_hc_b(:,:,:) = 0.e0
	144	ENDIF
	145	ELSE ! Swap of forcing field
	146	! ! ---------------------
	147	zfact = 0.5e0
	148	qsr_hc_b(:,:,:) = qsr_hc(:,:,:)
	149	ENDIF
	150	! Compute now qsr tracer content field
	151	! ************************************
[1423]	152
	153	! ! ============================================== !
[1445]	154	IF( lk_qsr_bio .AND. ln_qsr_bio ) THEN ! bio-model fluxes : all vertical coordinates !
[1423]	155	! ! ============================================== !
	156	DO jk = 1, jpkm1
[3625]	157	qsr_hc(:,:,jk) = r1_rau0_rcp * ( etot3(:,:,jk) - etot3(:,:,jk+1) )
[2528]	158	END DO
	159	! Add to the general trend
	160	DO jk = 1, jpkm1
	161	DO jj = 2, jpjm1
[3]	162	DO ji = fs_2, fs_jpim1 ! vector opt.
[2528]	163	z1_e3t = zfact / fse3t(ji,jj,jk)
	164	tsa(ji,jj,jk,jp_tem) = tsa(ji,jj,jk,jp_tem) + ( qsr_hc_b(ji,jj,jk) + qsr_hc(ji,jj,jk) ) * z1_e3t
[3]	165	END DO
	166	END DO
[1423]	167	END DO
[1756]	168	CALL iom_put( 'qsr3d', etot3 ) ! Shortwave Radiation 3D distribution
[4161]	169	! clem: store attenuation coefficient of the first ocean level
[5407]	170	IF ( ln_qsr_ice ) THEN
[4161]	171	DO jj = 1, jpj
	172	DO ji = 1, jpi
	173	IF ( qsr(ji,jj) /= 0._wp ) THEN
[4990]	174	fraqsr_1lev(ji,jj) = ( qsr_hc(ji,jj,1) / ( r1_rau0_rcp * qsr(ji,jj) ) )
[5407]	175	ELSE
	176	fraqsr_1lev(ji,jj) = 1.
[4161]	177	ENDIF
	178	END DO
	179	END DO
	180	ENDIF
[1423]	181	! ! ============================================== !
	182	ELSE ! Ocean alone :
	183	! ! ============================================== !
	184	!
[11442]	185	!
	186	IF( ln_stopack .AND. ( nn_spp_qsi0 > 0 ) ) THEN
	187	xsi0r = rn_si0
	188	CALL spp_gen(kt, xsi0r, nn_spp_qsi0, rn_qsi0_sd, jk_spp_qsi0 )
	189	xsi0r = 1.e0 / xsi0r
	190	ENDIF
	191	! ! ------------------------- !
[1423]	192	IF( ln_qsr_rgb) THEN ! R-G-B light penetration !
	193	! ! ------------------------- !
	194	! Set chlorophyl concentration
[6498]	195	IF( nn_chldta == 1 .OR. nn_chldta == 2 .OR. lk_vvl ) THEN !* Variable Chlorophyll or ocean volume
[1423]	196	!
[6498]	197	IF( nn_chldta == 1 ) THEN !* 2D Variable Chlorophyll
[2528]	198	!
[6498]	199	CALL fld_read( kt, 1, sf_chl ) ! Read Chl data and provides it at the current time step
	200	DO jk = 1, nksr + 1
	201	zchl3d(:,:,jk) = sf_chl(1)%fnow(:,:,1)
	202	ENDDO
	203	!
	204	ELSE IF( nn_chldta == 2 ) THEN !* -3-D Variable Chlorophyll
	205	!
	206	CALL fld_read( kt, 1, sf_chl ) ! Read Chl data and provides it at the current time step
	207	!CDIR NOVERRCHK !
	208	DO jj = 1, jpj
[1423]	209	!CDIR NOVERRCHK
[2528]	210	DO ji = 1, jpi
[6498]	211	zchl = sf_chl(1)%fnow(ji,jj,1)
	212	zCtot = 40.6 * zchl**0.459
	213	zze = 568.2 * zCtot**(-0.746)
	214	IF( zze > 102. ) zze = 200.0 * zCtot**(-0.293)
	215	zlogc = LOG( zchl )
	216	zlogc2 = zlogc * zlogc
	217	zlogc3 = zlogc * zlogc * zlogc
	218	zCb = 0.768 + 0.087 * zlogc - 0.179 * zlogc2 - 0.025 * zlogc3
	219	zCmax = 0.299 - 0.289 * zlogc + 0.579 * zlogc2
	220	zpsimax = 0.6 - 0.640 * zlogc + 0.021 * zlogc2 + 0.115 * zlogc3
	221	zdelpsi = 0.710 + 0.159 * zlogc + 0.021 * zlogc2
	222	zCze = 1.12 * (zchl)**0.803
	223	DO jk = 1, nksr + 1
	224	zpsi = fsdept(ji,jj,jk) / zze
	225	zchl3d(ji,jj,jk) = zCze * ( zCb + zCmax * EXP( -( (zpsi - zpsimax) / zdelpsi )**2 ) )
	226	END DO
	227	!
	228	END DO
	229	END DO
	230	!
	231	ELSE !* Variable ocean volume but constant chrlorophyll
	232	DO jk = 1, nksr + 1
	233	zchl3d(:,:,jk) = 0.05
	234	ENDDO
[2528]	235	ENDIF
[1423]	236	!
[6498]	237	zcoef = ( 1. - rn_abs ) / 3.e0 ! equi-partition in R-G-B
[1423]	238	ze0(:,:,1) = rn_abs * qsr(:,:)
	239	ze1(:,:,1) = zcoef * qsr(:,:)
	240	ze2(:,:,1) = zcoef * qsr(:,:)
	241	ze3(:,:,1) = zcoef * qsr(:,:)
	242	zea(:,:,1) = qsr(:,:)
	243	!
	244	DO jk = 2, nksr+1
[6498]	245	!
	246	DO jj = 1, jpj ! Separation in R-G-B depending of vertical profile of Chl
[1423]	247	!CDIR NOVERRCHK
[6498]	248	DO ji = 1, jpi
	249	zchl = MIN( 10. , MAX( 0.03, zchl3d(ji,jj,jk) ) )
	250	irgb = NINT( 41 + 20.*LOG10(zchl) + 1.e-15 )
	251	zekb(ji,jj) = rkrgb(1,irgb)
	252	zekg(ji,jj) = rkrgb(2,irgb)
	253	zekr(ji,jj) = rkrgb(3,irgb)
	254	END DO
	255	END DO
	256	!CDIR NOVERRCHK
[1423]	257	DO jj = 1, jpj
	258	!CDIR NOVERRCHK
	259	DO ji = 1, jpi
[11442]	260	zc0 = ze0(ji,jj,jk-1) * EXP( - fse3t(ji,jj,jk-1) * xsi0r(ji,jj) )
[1423]	261	zc1 = ze1(ji,jj,jk-1) * EXP( - fse3t(ji,jj,jk-1) * zekb(ji,jj) )
	262	zc2 = ze2(ji,jj,jk-1) * EXP( - fse3t(ji,jj,jk-1) * zekg(ji,jj) )
	263	zc3 = ze3(ji,jj,jk-1) * EXP( - fse3t(ji,jj,jk-1) * zekr(ji,jj) )
	264	ze0(ji,jj,jk) = zc0
	265	ze1(ji,jj,jk) = zc1
	266	ze2(ji,jj,jk) = zc2
	267	ze3(ji,jj,jk) = zc3
	268	zea(ji,jj,jk) = ( zc0 + zc1 + zc2 + zc3 ) * tmask(ji,jj,jk)
	269	END DO
	270	END DO
	271	END DO
	272	!
	273	DO jk = 1, nksr ! compute and add qsr trend to ta
[3625]	274	qsr_hc(:,:,jk) = r1_rau0_rcp * ( zea(:,:,jk) - zea(:,:,jk+1) )
[1423]	275	END DO
[1756]	276	zea(:,:,nksr+1:jpk) = 0.e0 ! below 400m set to zero
	277	CALL iom_put( 'qsr3d', zea ) ! Shortwave Radiation 3D distribution
[1423]	278	!
[6498]	279	IF ( ln_qsr_ice ) THEN ! store attenuation coefficient of the first ocean level
	280	!CDIR NOVERRCHK
	281	DO jj = 1, jpj ! Separation in R-G-B depending of the surface Chl
	282	!CDIR NOVERRCHK
	283	DO ji = 1, jpi
	284	zchl = MIN( 10. , MAX( 0.03, zchl3d(ji,jj,1) ) )
	285	irgb = NINT( 41 + 20.*LOG10(zchl) + 1.e-15 )
	286	zekb(ji,jj) = rkrgb(1,irgb)
	287	zekg(ji,jj) = rkrgb(2,irgb)
	288	zekr(ji,jj) = rkrgb(3,irgb)
	289	END DO
	290	END DO
	291	!
	292	DO jj = 1, jpj
	293	DO ji = 1, jpi
[11442]	294	zc0 = rn_abs * EXP( - fse3t(ji,jj,1) * xsi0r(ji,jj) )
[6498]	295	zc1 = zcoef * EXP( - fse3t(ji,jj,1) * zekb(ji,jj) )
	296	zc2 = zcoef * EXP( - fse3t(ji,jj,1) * zekg(ji,jj) )
	297	zc3 = zcoef * EXP( - fse3t(ji,jj,1) * zekr(ji,jj) )
	298	fraqsr_1lev(ji,jj) = 1.0 - ( zc0 + zc1 + zc2 + zc3 ) * tmask(ji,jj,2)
	299	END DO
	300	END DO
	301	!
	302	ENDIF
	303	!
[1423]	304	ELSE !* Constant Chlorophyll
	305	DO jk = 1, nksr
[2528]	306	qsr_hc(:,:,jk) = etot3(:,:,jk) * qsr(:,:)
[1423]	307	END DO
[6498]	308	! store attenuation coefficient of the first ocean level
	309	IF( ln_qsr_ice ) THEN
[4990]	310	fraqsr_1lev(:,:) = etot3(:,:,1) / r1_rau0_rcp
[4161]	311	ENDIF
	312	ENDIF
[1423]	313
[1448]	314	ENDIF
	315	! ! ------------------------- !
	316	IF( ln_qsr_2bd ) THEN ! 2 band light penetration !
[1423]	317	! ! ------------------------- !
	318	!
[11442]	319	IF( lk_vvl .OR. ( ln_stopack .AND. ( nn_spp_qsi0 > 0 ) ) ) THEN !* variable volume
	320
[3625]	321	zz0 = rn_abs * r1_rau0_rcp
	322	zz1 = ( 1. - rn_abs ) * r1_rau0_rcp
[2528]	323	DO jk = 1, nksr ! solar heat absorbed at T-point in the top 400m
[3294]	324	DO jj = 1, jpj
	325	DO ji = 1, jpi
[11442]	326	zc0 = zz0 * EXP( -fsdepw(ji,jj,jk )xsi0r(ji,jj) ) + zz1 EXP( -fsdepw(ji,jj,jk )*xsi1r )
	327	zc1 = zz0 * EXP( -fsdepw(ji,jj,jk+1)xsi0r(ji,jj) ) + zz1 EXP( -fsdepw(ji,jj,jk+1)*xsi1r )
[2528]	328	qsr_hc(ji,jj,jk) = qsr(ji,jj) * ( zc0tmask(ji,jj,jk) - zc1tmask(ji,jj,jk+1) )
	329	END DO
[187]	330	END DO
	331	END DO
[4161]	332	! clem: store attenuation coefficient of the first ocean level
[5407]	333	IF ( ln_qsr_ice ) THEN
[4161]	334	DO jj = 1, jpj
	335	DO ji = 1, jpi
[11442]	336	zc0 = zz0 * EXP( -fsdepw(ji,jj,1)xsi0r(ji,jj) ) + zz1 EXP( -fsdepw(ji,jj,1)*xsi1r )
	337	zc1 = zz0 * EXP( -fsdepw(ji,jj,2)xsi0r(ji,jj) ) + zz1 EXP( -fsdepw(ji,jj,2)*xsi1r )
[4990]	338	fraqsr_1lev(ji,jj) = ( zc0tmask(ji,jj,1) - zc1tmask(ji,jj,2) ) / r1_rau0_rcp
[4161]	339	END DO
	340	END DO
	341	ENDIF
[2528]	342	ELSE !* constant volume: coef. computed one for all
	343	DO jk = 1, nksr
	344	DO jj = 2, jpjm1
	345	DO ji = fs_2, fs_jpim1 ! vector opt.
[4990]	346	! (ISF) no light penetration below the ice shelves
	347	qsr_hc(ji,jj,jk) = etot3(ji,jj,jk) * qsr(ji,jj) * tmask(ji,jj,1)
[2528]	348	END DO
	349	END DO
	350	END DO
[4161]	351	! clem: store attenuation coefficient of the first ocean level
[5407]	352	IF ( ln_qsr_ice ) THEN
[4990]	353	fraqsr_1lev(:,:) = etot3(:,:,1) / r1_rau0_rcp
[4161]	354	ENDIF
[2528]	355	!
	356	ENDIF
[1423]	357	!
[187]	358	ENDIF
	359	!
[2528]	360	! Add to the general trend
	361	DO jk = 1, nksr
	362	DO jj = 2, jpjm1
	363	DO ji = fs_2, fs_jpim1 ! vector opt.
	364	z1_e3t = zfact / fse3t(ji,jj,jk)
	365	tsa(ji,jj,jk,jp_tem) = tsa(ji,jj,jk,jp_tem) + ( qsr_hc_b(ji,jj,jk) + qsr_hc(ji,jj,jk) ) * z1_e3t
	366	END DO
	367	END DO
	368	END DO
	369	!
[3]	370	ENDIF
[2528]	371	!
	372	IF( lrst_oce ) THEN ! Write in the ocean restart file
	373	! *******************************
	374	IF(lwp) WRITE(numout,*)
	375	IF(lwp) WRITE(numout,*) 'qsr tracer content forcing field written in ocean restart file ', &
	376	& 'at it= ', kt,' date= ', ndastp
	377	IF(lwp) WRITE(numout,*) '~~~~'
[10302]	378	IF(nn_timing == 2) CALL timing_start('iom_rstput')
[5407]	379	CALL iom_rstput( kt, nitrst, numrow, 'qsr_hc_b' , qsr_hc )
	380	CALL iom_rstput( kt, nitrst, numrow, 'fraqsr_1lev', fraqsr_1lev ) ! default definition in sbcssm
[10302]	381	IF(nn_timing == 2) CALL timing_stop('iom_rstput')
[2528]	382	!
	383	ENDIF
[3]	384
[503]	385	IF( l_trdtra ) THEN ! qsr tracers trends saved for diagnostics
[2528]	386	ztrdt(:,:,:) = tsa(:,:,:,jp_tem) - ztrdt(:,:,:)
[4990]	387	CALL trd_tra( kt, 'TRA', jp_tem, jptra_qsr, ztrdt )
[3294]	388	CALL wrk_dealloc( jpi, jpj, jpk, ztrdt )
[3]	389	ENDIF
[457]	390	! ! print mean trends (used for debugging)
[2528]	391	IF(ln_ctl) CALL prt_ctl( tab3d_1=tsa(:,:,:,jp_tem), clinfo1=' qsr - Ta: ', mask1=tmask, clinfo3='tra-ta' )
[503]	392	!
[3294]	393	CALL wrk_dealloc( jpi, jpj, zekb, zekg, zekr )
[6498]	394	CALL wrk_dealloc( jpi, jpj, jpk, ze0, ze1, ze2, ze3, zea, zchl3d )
[2715]	395	!
[3294]	396	IF( nn_timing == 1 ) CALL timing_stop('tra_qsr')
	397	!
[3]	398	END SUBROUTINE tra_qsr
	399
	400
	401	SUBROUTINE tra_qsr_init
	402	!!----------------------------------------------------------------------
	403	!! * ROUTINE tra_qsr_init *
	404	!!
	405	!! ** Purpose : Initialization for the penetrative solar radiation
	406	!!
	407	!! ** Method : The profile of solar radiation within the ocean is set
[1423]	408	!! from two length scale of penetration (rn_si0,rn_si1) and a ratio
[1601]	409	!! (rn_abs). These parameters are read in the namtra_qsr namelist. The
[3]	410	!! default values correspond to clear water (type I in Jerlov'
	411	!! (1968) classification.
	412	!! called by tra_qsr at the first timestep (nit000)
	413	!!
[1423]	414	!! ** Action : - initialize rn_si0, rn_si1 and rn_abs
[3]	415	!!
[503]	416	!! Reference : Jerlov, N. G., 1968 Optical Oceanography, Elsevier, 194pp.
[3]	417	!!----------------------------------------------------------------------
[2715]	418	!
[4147]	419	INTEGER :: ji, jj, jk ! dummy loop indices
[2715]	420	INTEGER :: irgb, ierror, ioptio, nqsr ! local integer
[4147]	421	INTEGER :: ios ! Local integer output status for namelist read
[2715]	422	REAL(wp) :: zz0, zc0 , zc1, zcoef ! local scalars
	423	REAL(wp) :: zz1, zc2 , zc3, zchl ! - -
[3294]	424	REAL(wp), POINTER, DIMENSION(:,: ) :: zekb, zekg, zekr
	425	REAL(wp), POINTER, DIMENSION(:,:,:) :: ze0, ze1, ze2, ze3, zea
[2715]	426	!
[1423]	427	CHARACTER(len=100) :: cn_dir ! Root directory for location of ssr files
	428	TYPE(FLD_N) :: sn_chl ! informations about the chlorofyl field to be read
[2715]	429	!!
[4161]	430	NAMELIST/namtra_qsr/ sn_chl, cn_dir, ln_traqsr, ln_qsr_rgb, ln_qsr_2bd, ln_qsr_bio, ln_qsr_ice, &
[2528]	431	& nn_chldta, rn_abs, rn_si0, rn_si1
[3]	432	!!----------------------------------------------------------------------
	433
[3294]	434	!
	435	IF( nn_timing == 1 ) CALL timing_start('tra_qsr_init')
	436	!
	437	CALL wrk_alloc( jpi, jpj, zekb, zekg, zekr )
	438	CALL wrk_alloc( jpi, jpj, jpk, ze0, ze1, ze2, ze3, zea )
	439	!
[2715]	440
[4147]	441	REWIND( numnam_ref ) ! Namelist namtra_qsr in reference namelist : Ratio and length of penetration
	442	READ ( numnam_ref, namtra_qsr, IOSTAT = ios, ERR = 901)
	443	901 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtra_qsr in reference namelist', lwp )
	444
	445	REWIND( numnam_cfg ) ! Namelist namtra_qsr in configuration namelist : Ratio and length of penetration
	446	READ ( numnam_cfg, namtra_qsr, IOSTAT = ios, ERR = 902 )
	447	902 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtra_qsr in configuration namelist', lwp )
[4624]	448	IF(lwm) WRITE ( numond, namtra_qsr )
[1423]	449	!
	450	IF(lwp) THEN ! control print
	451	WRITE(numout,*)
	452	WRITE(numout,*) 'tra_qsr_init : penetration of the surface solar radiation'
	453	WRITE(numout,*) '~~~~~~~~~~~~'
[1601]	454	WRITE(numout,*) ' Namelist namtra_qsr : set the parameter of penetration'
	455	WRITE(numout,*) ' Light penetration (T) or not (F) ln_traqsr = ', ln_traqsr
	456	WRITE(numout,*) ' RGB (Red-Green-Blue) light penetration ln_qsr_rgb = ', ln_qsr_rgb
	457	WRITE(numout,*) ' 2 band light penetration ln_qsr_2bd = ', ln_qsr_2bd
	458	WRITE(numout,*) ' bio-model light penetration ln_qsr_bio = ', ln_qsr_bio
[4161]	459	WRITE(numout,*) ' light penetration for ice-model LIM3 ln_qsr_ice = ', ln_qsr_ice
[6498]	460	WRITE(numout,*) ' RGB : Chl data (=1/2) or cst value (=0) nn_chldta = ', nn_chldta
[1601]	461	WRITE(numout,*) ' RGB & 2 bands: fraction of light (rn_si1) rn_abs = ', rn_abs
	462	WRITE(numout,*) ' RGB & 2 bands: shortess depth of extinction rn_si0 = ', rn_si0
	463	WRITE(numout,*) ' 2 bands: longest depth of extinction rn_si1 = ', rn_si1
[1423]	464	ENDIF
[1448]	465
	466	IF( ln_traqsr ) THEN ! control consistency
	467	!
[1601]	468	IF( .NOT.lk_qsr_bio .AND. ln_qsr_bio ) THEN
	469	CALL ctl_warn( 'No bio model : force ln_qsr_bio = FALSE ' )
[1448]	470	ln_qsr_bio = .FALSE.
	471	ENDIF
	472	!
	473	ioptio = 0 ! Parameter control
	474	IF( ln_qsr_rgb ) ioptio = ioptio + 1
	475	IF( ln_qsr_2bd ) ioptio = ioptio + 1
	476	IF( ln_qsr_bio ) ioptio = ioptio + 1
	477	!
[2528]	478	IF( ioptio /= 1 ) &
	479	CALL ctl_stop( ' Choose ONE type of light penetration in namelist namtra_qsr', &
	480	& ' 2 bands, 3 RGB bands or bio-model light penetration' )
[1448]	481	!
[1455]	482	IF( ln_qsr_rgb .AND. nn_chldta == 0 ) nqsr = 1
	483	IF( ln_qsr_rgb .AND. nn_chldta == 1 ) nqsr = 2
[6498]	484	IF( ln_qsr_rgb .AND. nn_chldta == 2 ) nqsr = 3
	485	IF( ln_qsr_2bd ) nqsr = 4
	486	IF( ln_qsr_bio ) nqsr = 5
[1455]	487	!
[1448]	488	IF(lwp) THEN ! Print the choice
	489	WRITE(numout,*)
[2528]	490	IF( nqsr == 1 ) WRITE(numout,*) ' R-G-B light penetration - Constant Chlorophyll'
[6498]	491	IF( nqsr == 2 ) WRITE(numout,*) ' R-G-B light penetration - 2D Chl data '
	492	IF( nqsr == 3 ) WRITE(numout,*) ' R-G-B light penetration - 3D Chl data '
	493	IF( nqsr == 4 ) WRITE(numout,*) ' 2 bands light penetration'
	494	IF( nqsr == 5 ) WRITE(numout,*) ' bio-model light penetration'
[1448]	495	ENDIF
	496	!
	497	ENDIF
[1423]	498	! ! ===================================== !
	499	IF( ln_traqsr ) THEN ! Initialisation of Light Penetration !
	500	! ! ===================================== !
	501	!
[11442]	502	ALLOCATE( xsi0r(jpi,jpj) )
[2528]	503	xsi0r = 1.e0 / rn_si0
	504	xsi1r = 1.e0 / rn_si1
[1423]	505	! ! ---------------------------------- !
	506	IF( ln_qsr_rgb ) THEN ! Red-Green-Blue light penetration !
	507	! ! ---------------------------------- !
	508	!
[2528]	509	CALL trc_oce_rgb( rkrgb ) !* tabulated attenuation coef.
	510	!
	511	! !* level of light extinction
	512	IF( ln_sco ) THEN ; nksr = jpkm1
	513	ELSE ; nksr = trc_oce_ext_lev( r_si2, 0.33e2 )
[457]	514	ENDIF
[2528]	515
[4292]	516	IF(lwp) WRITE(numout,*) ' level of light extinction = ', nksr, ' ref depth = ', gdepw_1d(nksr+1), ' m'
[1423]	517	!
[6498]	518	IF( nn_chldta == 1 .OR. nn_chldta == 2 ) THEN !* Chl data : set sf_chl structure
[1423]	519	IF(lwp) WRITE(numout,*)
	520	IF(lwp) WRITE(numout,*) ' Chlorophyll read in a file'
	521	ALLOCATE( sf_chl(1), STAT=ierror )
	522	IF( ierror > 0 ) THEN
	523	CALL ctl_stop( 'tra_qsr_init: unable to allocate sf_chl structure' ) ; RETURN
	524	ENDIF
[2528]	525	ALLOCATE( sf_chl(1)%fnow(jpi,jpj,1) )
	526	IF( sn_chl%ln_tint )ALLOCATE( sf_chl(1)%fdta(jpi,jpj,1,2) )
[1423]	527	! ! fill sf_chl with sn_chl and control print
	528	CALL fld_fill( sf_chl, (/ sn_chl /), cn_dir, 'tra_qsr_init', &
[1601]	529	& 'Solar penetration function of read chlorophyll', 'namtra_qsr' )
[1423]	530	!
	531	ELSE !* constant Chl : compute once for all the distribution of light (etot3)
	532	IF(lwp) WRITE(numout,*)
	533	IF(lwp) WRITE(numout,*) ' Constant Chlorophyll concentration = 0.05'
[2528]	534	IF( lk_vvl ) THEN ! variable volume
	535	IF(lwp) WRITE(numout,*) ' key_vvl: light distribution will be computed at each time step'
	536	ELSE ! constant volume: computes one for all
	537	IF(lwp) WRITE(numout,*) ' fixed volume: light distribution computed one for all'
	538	!
	539	zchl = 0.05 ! constant chlorophyll
	540	irgb = NINT( 41 + 20.*LOG10(zchl) + 1.e-15 )
	541	zekb(:,:) = rkrgb(1,irgb) ! Separation in R-G-B depending of the chlorophyll
	542	zekg(:,:) = rkrgb(2,irgb)
	543	zekr(:,:) = rkrgb(3,irgb)
	544	!
	545	zcoef = ( 1. - rn_abs ) / 3.e0 ! equi-partition in R-G-B
	546	ze0(:,:,1) = rn_abs
	547	ze1(:,:,1) = zcoef
	548	ze2(:,:,1) = zcoef
	549	ze3(:,:,1) = zcoef
	550	zea(:,:,1) = tmask(:,:,1) ! = ( ze0+ze1+z2+ze3 ) * tmask
[1423]	551
[2528]	552	DO jk = 2, nksr+1
[1423]	553	!CDIR NOVERRCHK
[2528]	554	DO jj = 1, jpj
[1423]	555	!CDIR NOVERRCHK
[2528]	556	DO ji = 1, jpi
[11442]	557	zc0 = ze0(ji,jj,jk-1) * EXP( - e3t_0(ji,jj,jk-1) * xsi0r(ji,jj) )
[4292]	558	zc1 = ze1(ji,jj,jk-1) * EXP( - e3t_0(ji,jj,jk-1) * zekb(ji,jj) )
	559	zc2 = ze2(ji,jj,jk-1) * EXP( - e3t_0(ji,jj,jk-1) * zekg(ji,jj) )
	560	zc3 = ze3(ji,jj,jk-1) * EXP( - e3t_0(ji,jj,jk-1) * zekr(ji,jj) )
[2528]	561	ze0(ji,jj,jk) = zc0
	562	ze1(ji,jj,jk) = zc1
	563	ze2(ji,jj,jk) = zc2
	564	ze3(ji,jj,jk) = zc3
	565	zea(ji,jj,jk) = ( zc0 + zc1 + zc2 + zc3 ) * tmask(ji,jj,jk)
	566	END DO
[1423]	567	END DO
[2528]	568	END DO
	569	!
	570	DO jk = 1, nksr
[4990]	571	! (ISF) no light penetration below the ice shelves
	572	etot3(:,:,jk) = r1_rau0_rcp * ( zea(:,:,jk) - zea(:,:,jk+1) ) * tmask(:,:,1)
[1423]	573	END DO
[2528]	574	etot3(:,:,nksr+1:jpk) = 0.e0 ! below 400m set to zero
	575	ENDIF
[1423]	576	ENDIF
	577	!
[1448]	578	ENDIF
[1423]	579	! ! ---------------------------------- !
[1448]	580	IF( ln_qsr_2bd ) THEN ! 2 bands light penetration !
[1423]	581	! ! ---------------------------------- !
	582	!
	583	! ! level of light extinction
	584	nksr = trc_oce_ext_lev( rn_si1, 1.e2 )
	585	IF(lwp) THEN
	586	WRITE(numout,*)
[4292]	587	IF(lwp) WRITE(numout,*) ' level of light extinction = ', nksr, ' ref depth = ', gdepw_1d(nksr+1), ' m'
[1423]	588	ENDIF
	589	!
[2528]	590	IF( lk_vvl ) THEN ! variable volume
	591	IF(lwp) WRITE(numout,*) ' key_vvl: light distribution will be computed at each time step'
	592	ELSE ! constant volume: computes one for all
[3625]	593	zz0 = rn_abs * r1_rau0_rcp
	594	zz1 = ( 1. - rn_abs ) * r1_rau0_rcp
[2528]	595	DO jk = 1, nksr !* solar heat absorbed at T-point computed once for all
	596	DO jj = 1, jpj ! top 400 meters
	597	DO ji = 1, jpi
[11442]	598	zc0 = zz0 * EXP( -fsdepw(ji,jj,jk )xsi0r(ji,jj) ) + zz1 EXP( -fsdepw(ji,jj,jk )*xsi1r )
	599	zc1 = zz0 * EXP( -fsdepw(ji,jj,jk+1)xsi0r(ji,jj) ) + zz1 EXP( -fsdepw(ji,jj,jk+1)*xsi1r )
[4990]	600	etot3(ji,jj,jk) = ( zc0 * tmask(ji,jj,jk) - zc1 * tmask(ji,jj,jk+1) ) * tmask(ji,jj,1)
[2528]	601	END DO
[1423]	602	END DO
	603	END DO
[2528]	604	etot3(:,:,nksr+1:jpk) = 0.e0 ! below 400m set to zero
	605	!
	606	ENDIF
[187]	607	ENDIF
[1423]	608	! ! ===================================== !
	609	ELSE ! No light penetration !
	610	! ! ===================================== !
[457]	611	IF(lwp) THEN
	612	WRITE(numout,*)
	613	WRITE(numout,*) 'tra_qsr_init : NO solar flux penetration'
	614	WRITE(numout,*) '~~~~~~~~~~~~'
	615	ENDIF
[3]	616	ENDIF
[503]	617	!
[5407]	618	! initialisation of fraqsr_1lev used in sbcssm
	619	IF( iom_varid( numror, 'fraqsr_1lev', ldstop = .FALSE. ) > 0 ) THEN
[10302]	620	IF(nn_timing == 2) CALL timing_start('iom_rstget')
[5407]	621	CALL iom_get( numror, jpdom_autoglo, 'fraqsr_1lev' , fraqsr_1lev )
[10302]	622	IF(nn_timing == 2) CALL timing_stop('iom_rstget')
[5407]	623	ELSE
	624	fraqsr_1lev(:,:) = 1._wp ! default definition
	625	ENDIF
	626	!
[3294]	627	CALL wrk_dealloc( jpi, jpj, zekb, zekg, zekr )
	628	CALL wrk_dealloc( jpi, jpj, jpk, ze0, ze1, ze2, ze3, zea )
[2715]	629	!
[3294]	630	IF( nn_timing == 1 ) CALL timing_stop('tra_qsr_init')
	631	!
[3]	632	END SUBROUTINE tra_qsr_init
	633
	634	!!======================================================================
	635	END MODULE traqsr

Note: See TracBrowser for help on using the repository browser.

Download in other formats: