SUBROUTINE tl_lmd_swfrac_tile (ng, tile, &
& LBi, UBi, LBj, UBj, &
& IminS, ImaxS, JminS, JmaxS, &
& Zscale, Z, tl_Z, tl_swdk)
!
!git $Id$
!svn $Id: tl_lmd_swfrac.F 1151 2023-02-09 03:08:53Z arango $
!================================================== Hernan G. Arango ===
! Copyright (c) 2002-2023 The ROMS/TOMS Group !
! Licensed under a MIT/X style license !
! See License_ROMS.md !
!=======================================================================
! !
! This routine computes the tangent linear fraction of solar !
! shortwave flux penetrating to specified depth (times Zscale) !
! due to exponential decay in Jerlov water type. !
! !
! On Input: !
! !
! Zscale Scale factor to apply to depth array. !
! Z Vertical height (meters, negative) for !
! desired solar short-wave fraction. !
! tl_Z Tangent linear vertical height for !
! desired solar short-wave fraction. !
! !
! On Output: !
! !
! tl_swdk Tangent linear shortwave (radiation) fractional decay. !
! !
! Reference: !
! !
! Paulson, C.A., and J.J. Simpson, 1977: Irradiance meassurements !
! in the upper ocean, J. Phys. Oceanogr., 7, 952-956. !
! !
! This routine was adapted from Bill Large 1995 code. !
! !
!=======================================================================
!
USE mod_param
USE mod_mixing
USE mod_scalars
!
implicit none
!
! Imported variable declarations.
!
integer, intent(in) :: ng, tile
integer, intent(in) :: LBi, UBi, LBj, UBj
integer, intent(in) :: IminS, ImaxS, JminS, JmaxS
real(r8), intent(in) :: Zscale
real(r8), intent(in) :: Z(IminS:ImaxS,JminS:JmaxS)
real(r8), intent(in) :: tl_Z(IminS:ImaxS,JminS:JmaxS)
real(r8), intent(out) :: tl_swdk(IminS:ImaxS,JminS:JmaxS)
!
! Local variable declarations.
!
integer :: Jindex, i, j
real(r8) :: cff1, cff2
real(r8) :: tl_cff1, tl_cff2
real(r8), dimension(IminS:ImaxS) :: fac1, fac2, fac3
!
!-----------------------------------------------------------------------
! Set lower and upper tile bounds and staggered variables bounds for
! this horizontal domain partition. Notice that if tile=-1, it will
! set the values for the global grid.
!-----------------------------------------------------------------------
!
integer :: Istr, IstrB, IstrP, IstrR, IstrT, IstrM, IstrU
integer :: Iend, IendB, IendP, IendR, IendT
integer :: Jstr, JstrB, JstrP, JstrR, JstrT, JstrM, JstrV
integer :: Jend, JendB, JendP, JendR, JendT
integer :: Istrm3, Istrm2, Istrm1, IstrUm2, IstrUm1
integer :: Iendp1, Iendp2, Iendp2i, Iendp3
integer :: Jstrm3, Jstrm2, Jstrm1, JstrVm2, JstrVm1
integer :: Jendp1, Jendp2, Jendp2i, Jendp3
!
Istr =BOUNDS(ng) % Istr (tile)
IstrB =BOUNDS(ng) % IstrB (tile)
IstrM =BOUNDS(ng) % IstrM (tile)
IstrP =BOUNDS(ng) % IstrP (tile)
IstrR =BOUNDS(ng) % IstrR (tile)
IstrT =BOUNDS(ng) % IstrT (tile)
IstrU =BOUNDS(ng) % IstrU (tile)
Iend =BOUNDS(ng) % Iend (tile)
IendB =BOUNDS(ng) % IendB (tile)
IendP =BOUNDS(ng) % IendP (tile)
IendR =BOUNDS(ng) % IendR (tile)
IendT =BOUNDS(ng) % IendT (tile)
Jstr =BOUNDS(ng) % Jstr (tile)
JstrB =BOUNDS(ng) % JstrB (tile)
JstrM =BOUNDS(ng) % JstrM (tile)
JstrP =BOUNDS(ng) % JstrP (tile)
JstrR =BOUNDS(ng) % JstrR (tile)
JstrT =BOUNDS(ng) % JstrT (tile)
JstrV =BOUNDS(ng) % JstrV (tile)
Jend =BOUNDS(ng) % Jend (tile)
JendB =BOUNDS(ng) % JendB (tile)
JendP =BOUNDS(ng) % JendP (tile)
JendR =BOUNDS(ng) % JendR (tile)
JendT =BOUNDS(ng) % JendT (tile)
!
Istrm3 =BOUNDS(ng) % Istrm3 (tile) ! Istr-3
Istrm2 =BOUNDS(ng) % Istrm2 (tile) ! Istr-2
Istrm1 =BOUNDS(ng) % Istrm1 (tile) ! Istr-1
IstrUm2=BOUNDS(ng) % IstrUm2(tile) ! IstrU-2
IstrUm1=BOUNDS(ng) % IstrUm1(tile) ! IstrU-1
Iendp1 =BOUNDS(ng) % Iendp1 (tile) ! Iend+1
Iendp2 =BOUNDS(ng) % Iendp2 (tile) ! Iend+2
Iendp2i=BOUNDS(ng) % Iendp2i(tile) ! Iend+2 interior
Iendp3 =BOUNDS(ng) % Iendp3 (tile) ! Iend+3
Jstrm3 =BOUNDS(ng) % Jstrm3 (tile) ! Jstr-3
Jstrm2 =BOUNDS(ng) % Jstrm2 (tile) ! Jstr-2
Jstrm1 =BOUNDS(ng) % Jstrm1 (tile) ! Jstr-1
JstrVm2=BOUNDS(ng) % JstrVm2(tile) ! JstrV-2
JstrVm1=BOUNDS(ng) % JstrVm1(tile) ! JstrV-1
Jendp1 =BOUNDS(ng) % Jendp1 (tile) ! Jend+1
Jendp2 =BOUNDS(ng) % Jendp2 (tile) ! Jend+2
Jendp2i=BOUNDS(ng) % Jendp2i(tile) ! Jend+2 interior
Jendp3 =BOUNDS(ng) % Jendp3 (tile) ! Jend+3
!
!-----------------------------------------------------------------------
! Use Paulson and Simpson (1977) two wavelength bands solar
! absorption model.
!-----------------------------------------------------------------------
!
DO j=Jstr,Jend
DO i=Istr,Iend
Jindex=INT(MIXING(ng)%Jwtype(i,j))
fac1(i)=Zscale/lmd_mu1(Jindex)
fac2(i)=Zscale/lmd_mu2(Jindex)
fac3(i)=lmd_r1(Jindex)
END DO
DO i=Istr,Iend
cff1=EXP(Z(i,j)*fac1(i))
tl_cff1=fac1(i)*tl_Z(i,j)*cff1
cff2=EXP(Z(i,j)*fac2(i))
tl_cff2=fac2(i)*tl_Z(i,j)*cff2
!^ swdk(i,j)=cff1*fac3(i)+ &
!^ & cff2*(1.0_r8-fac3(i))
!^
tl_swdk(i,j)=tl_cff1*fac3(i)+ &
& tl_cff2*(1.0_r8-fac3(i))
END DO
END DO
RETURN
END SUBROUTINE tl_lmd_swfrac_tile