surface_fluxes.f90 Source File


This file depends on

sourcefile~~surface_fluxes.f90~~EfferentGraph sourcefile~surface_fluxes.f90 surface_fluxes.f90 sourcefile~types.f90 types.f90 sourcefile~surface_fluxes.f90->sourcefile~types.f90 sourcefile~physical_constants.f90 physical_constants.f90 sourcefile~surface_fluxes.f90->sourcefile~physical_constants.f90 sourcefile~geometry.f90 geometry.f90 sourcefile~surface_fluxes.f90->sourcefile~geometry.f90 sourcefile~mod_radcon.f90 mod_radcon.f90 sourcefile~surface_fluxes.f90->sourcefile~mod_radcon.f90 sourcefile~params.f90 params.f90 sourcefile~surface_fluxes.f90->sourcefile~params.f90 sourcefile~humidity.f90 humidity.f90 sourcefile~surface_fluxes.f90->sourcefile~humidity.f90 sourcefile~physical_constants.f90->sourcefile~types.f90 sourcefile~physical_constants.f90->sourcefile~params.f90 sourcefile~geometry.f90->sourcefile~types.f90 sourcefile~geometry.f90->sourcefile~physical_constants.f90 sourcefile~geometry.f90->sourcefile~params.f90 sourcefile~mod_radcon.f90->sourcefile~types.f90 sourcefile~mod_radcon.f90->sourcefile~params.f90 sourcefile~params.f90->sourcefile~types.f90 sourcefile~humidity.f90->sourcefile~types.f90 sourcefile~humidity.f90->sourcefile~params.f90

Files dependent on this one

sourcefile~~surface_fluxes.f90~~AfferentGraph sourcefile~surface_fluxes.f90 surface_fluxes.f90 sourcefile~physics.f90 physics.f90 sourcefile~physics.f90->sourcefile~surface_fluxes.f90 sourcefile~forcing.f90 forcing.f90 sourcefile~forcing.f90->sourcefile~surface_fluxes.f90 sourcefile~speedy.f90 speedy.f90 sourcefile~speedy.f90->sourcefile~forcing.f90 sourcefile~initialization.f90 initialization.f90 sourcefile~speedy.f90->sourcefile~initialization.f90 sourcefile~time_stepping.f90 time_stepping.f90 sourcefile~speedy.f90->sourcefile~time_stepping.f90 sourcefile~tendencies.f90 tendencies.f90 sourcefile~tendencies.f90->sourcefile~physics.f90 sourcefile~initialization.f90->sourcefile~forcing.f90 sourcefile~initialization.f90->sourcefile~time_stepping.f90 sourcefile~speedy_driver.f90 speedy_driver.f90 sourcefile~speedy_driver.f90->sourcefile~speedy.f90 sourcefile~speedy_driver.f90->sourcefile~initialization.f90 sourcefile~time_stepping.f90->sourcefile~tendencies.f90

Contents

Source Code


Source Code

!> Parametrization of surface fluxes
module surface_fluxes
    use types, only : p
    use params
    use geometry, only : ModGeometry_t

    implicit none

    private
    public get_surface_fluxes, set_orog_land_sfc_drag

    !  Constants for surface fluxes
    real(p), parameter :: fwind0 = 0.95 !! Ratio of near-sfc wind to lowest-level wind

    !> Weight for near-sfc temperature extrapolation (0-1) :
    !  1 : linear extrapolation from two lowest levels
    !  0 : constant potential temperature ( = lowest level)
    real(p), parameter :: ftemp0 = 1.0

    !> Weight for near-sfc specific humidity extrapolation (0-1) :
    !  1 : extrap. with constant relative hum. ( = lowest level)
    !  0 : constant specific hum. ( = lowest level)
    real(p), parameter :: fhum0 = 0.0

    real(p), parameter :: cdl = 2.4e-3   !! Drag coefficient for momentum over land
    real(p), parameter :: cds = 1.0e-3   !! Drag coefficient for momentum over sea
    real(p), parameter :: chl = 1.2e-3   !! Heat exchange coefficient over land
    real(p), parameter :: chs = 0.9e-3   !! Heat exchange coefficient over sea
    real(p), parameter :: vgust = 5.0    !! Wind speed for sub-grid-scale gusts
    real(p), parameter :: ctday = 1.0e-2 !! Daily-cycle correction (dTskin/dSSRad)
    real(p), parameter :: dtheta = 3.0   !! Potential temp. gradient for stability correction
    real(p), parameter :: fstab = 0.67   !! Amplitude of stability correction (fraction)
    real(p), parameter :: hdrag = 2000.0 !! Height scale for orographic correction
    real(p), parameter :: clambda = 7.0  !! Heat conductivity in skin-to-root soil layer
    real(p), parameter :: clambsn = 7.0  !! Heat conductivity in soil for snow cover = 1

contains
    !> Compute surface fluxes of momentum, energy and moisture, and define surface
    !  skin temperature from energy balance
    subroutine get_surface_fluxes(&
            psa, ua, va, ta, qa, rh, phi, phi0, fmask, forog, tsea, &
            ssrd, slrd, ustr, vstr, shf, evap, slru, hfluxn, &
            tsfc, tskin, u0, v0, t0, lfluxland, &
            alb_land, alb_sea, snowc, land_temp, soil_avail_water, &
            coa, sigl, wvi)

        use physical_constants, only : p0, rgas, cp, alhc, sbc

        use mod_radcon, only : emisfc
        use humidity, only : get_qsat, rel_hum_to_spec_hum

        real(p), intent(in) :: psa(ix, il)    !! Normalised surface pressure
        real(p), intent(in) :: ua(ix, il, kx)  !! u-wind
        real(p), intent(in) :: va(ix, il, kx)  !! v-wind
        real(p), intent(in) :: ta(ix, il, kx)  !! Temperature
        real(p), intent(in) :: qa(ix, il, kx)  !! Specific humidity [g/kg]
        real(p), intent(in) :: rh(ix, il, kx)  !! Relative humidity
        real(p), intent(in) :: phi(ix, il, kx) !! Geopotential
        real(p), intent(in) :: phi0(ix, il)   !! Surface geopotential
        real(p), intent(in) :: fmask(ix, il)  !! Fractional land-sea mask
        real(p), intent(in) :: forog(ix, il)  !! Orographic factor for land surface drag
        real(p), intent(in) :: tsea(ix, il)   !! Sea-surface temperature
        real(p), intent(in) :: ssrd(ix, il)   !! Downward flux of short-wave radiation at the surface
        real(p), intent(in) :: slrd(ix, il)   !! Downward flux of long-wave radiation at the surface
        logical, intent(in) :: lfluxland
        real(p), intent(out) :: ustr(ix, il, 3) !! u-stress
        real(p), intent(out) :: vstr(ix, il, 3) !! v-stress
        real(p), intent(out) :: shf(ix, il, 3)  !! Sensible heat flux
        real(p), intent(out) :: evap(ix, il, 3) !! Evaporation
        real(p), intent(out) :: slru(ix, il, 3) !! Upward flux of long-wave radiation at the surface
        real(p), intent(out) :: hfluxn(ix, il, 2) !! Net downward heat flux
        real(p), intent(out) :: tsfc(ix, il)   !! Surface temperature
        real(p), intent(out) :: tskin(ix, il)  !! Skin surface temperature
        real(p), intent(out) :: u0(ix, il) !! Near-surface u-wind
        real(p), intent(out) :: v0(ix, il) !! Near-surface v-wind
        real(p), intent(out) :: t0(ix, il) !! Near-surface temperature

        real(p), intent(in) :: alb_land(ix, il) !! Daily-mean albedo over land (bare-land + snow)
        real(p), intent(in) :: alb_sea(ix, il) !! Daily-mean albedo over sea  (open sea + sea ice)
        real(p), intent(in) :: snowc(ix, il) !! Effective snow cover (fraction)
        real(p), intent(in) :: land_temp(ix, il) !! Land surface temperature
        real(p), intent(in) :: soil_avail_water(ix, il) !! Soil water availability

        real(p), intent(in) :: coa(il)      !! cosine(latitude)
        real(p), intent(in) :: sigl(kx)   !! Logarithm of full-level sigma
        real(p), intent(in) :: wvi(kx, 2)    !! Weights for vertical interpolation

        ! Local variables
        integer :: i, j, ks, nl1
        real(p) :: dt1, dthl, dths, esbc, ghum0, gtemp0, astab, cdldv, chlcp
        real(p) :: rcp, rdth
        logical lscasym, lskineb

        real(p), allocatable, dimension(:, :, :) :: t1, q1
        real(p), allocatable, dimension(:, :, :) :: t2, qsat0
        real(p), allocatable, dimension(:, :, :) :: denvvs
        real(p), allocatable, dimension(:, :) :: dslr, dtskin, clamb, cdsdv, tsk3

        !----------------------- End of declarations -----------------------------

        ! Allocate arrays
        allocate(t1(ix, il, 2), q1(ix, il, 2), t2(ix, il, 2), qsat0(ix, il, 2))
        allocate(denvvs(ix, il, 0:2))
        allocate(dslr(ix, il), dtskin(ix, il), clamb(ix, il), cdsdv(ix, il), tsk3(ix, il))

        lscasym = .true.   ! true : use an asymmetric stability coefficient
        lskineb = .true.   ! true : redefine skin temp. from energy balance

        esbc = emisfc * sbc

        ghum0 = 1.0 - fhum0

        ! =========================================================================
        ! Land surface
        ! =========================================================================
        if (lfluxland) then
            ! 1. Extrapolation of wind, temp, hum. and density to the surface

            ! 1.1 Wind components
            u0 = fwind0 * ua(:, :, kx)
            v0 = fwind0 * va(:, :, kx)

            ! 1.2 Temperature
            gtemp0 = 1.0 - ftemp0
            rcp = 1.0 / cp
            nl1 = kx - 1

            do i = 1, ix
                do j = 1, il
                    ! Temperature difference between lowest level and sfc
                    dt1 = wvi(kx, 2) * (ta(i, j, kx) - ta(i, j, nl1))

                    ! Extrapolated temperature using actual lapse rate (1:land, 2:sea)
                    t1(i, j, 1) = ta(i, j, kx) + dt1
                    t1(i, j, 2) = t1(i, j, 1) - phi0(i, j) * dt1 / (rgas * 288.0 * sigl(kx))

                    ! Extrapolated temperature using dry-adiab. lapse rate (1:land, 2:sea)
                    t2(i, j, 2) = ta(i, j, kx) + rcp * phi(i, j, kx)
                    t2(i, j, 1) = t2(i, j, 2) - rcp * phi0(i, j)
                end do
            end do

            do i = 1, ix
                do j = 1, il
                    if (ta(i, j, kx) > ta(i, j, nl1)) then
                        ! Use extrapolated temp. if dT/dz < 0
                        t1(i, j, 1) = ftemp0 * t1(i, j, 1) + gtemp0 * t2(i, j, 1)
                        t1(i, j, 2) = ftemp0 * t1(i, j, 2) + gtemp0 * t2(i, j, 2)
                    else
                        ! Use temp. at lowest level if dT/dz > 0
                        t1(i, j, 1) = ta(i, j, kx)
                        t1(i, j, 2) = ta(i, j, kx)
                    end if
                    t0(i, j) = t1(i, j, 2) + fmask(i, j) * (t1(i, j, 1) - t1(i, j, 2))
                end do
            end do

            ! 1.3 Density * wind speed (including gustiness factor)
            denvvs(:, :, 0) = (p0 * psa / (rgas * t0)) * sqrt(u0**2.0 + v0**2.0 + vgust**2.0)

            ! 2. Compute land-sfc. fluxes using prescribed skin temperature

            ! 2.1 Define effective skin temperature to compensate for
            !     non-linearity of heat/moisture fluxes during the daily cycle
            do j = 1, il
                tskin(:, j) = land_temp(:, j) + ctday * sqrt(coa(j)) * ssrd(:, j) * (1.0 - alb_land(:, j)) * psa(:, j)
            end do

            ! 2.2 Stability correction = f[pot.temp.(sfc)-pot.temp.(air)]
            rdth = fstab / dtheta
            astab = 1.0
            if (lscasym) astab = 0.5   ! to get smaller ds/dt in stable conditions

            do i = 1, ix
                do j = 1, il
                    ! Potential temp. difference (land+sea average)
                    if (tskin(i, j) > t2(i, j, 1)) then
                        dthl = min(dtheta, tskin(i, j) - t2(i, j, 1))
                    else
                        dthl = max(-dtheta, astab * (tskin(i, j) - t2(i, j, 1)))
                    end if
                    denvvs(i, j, 1) = denvvs(i, j, 0) * (1.0 + dthl * rdth)
                end do
            end do

            ! 2.3 Wind stress
            do i = 1, ix
                do j = 1, il
                    cdldv = cdl * denvvs(i, j, 0) * forog(i, j)
                    ustr(i, j, 1) = -cdldv * ua(i, j, kx)
                    vstr(i, j, 1) = -cdldv * va(i, j, kx)
                end do
            end do

            ! 2.4 Sensible heat flux
            chlcp = chl * cp
            shf(:, :, 1) = chlcp * denvvs(:, :, 1) * (tskin - t1(:, :, 1))

            ! 2.5 Evaporation
            if (fhum0 > 0.0) then
                call rel_hum_to_spec_hum(t1, psa, 1.0_p, rh(:, :, kx), q1, qsat0(:, :, 1))

                q1(:, :, 1) = fhum0 * q1(:, :, 1) + ghum0 * qa(:, :, kx)
            else
                q1(:, :, 1) = qa(:, :, kx)
            end if

            qsat0(:, :, 1) = get_qsat(tskin, psa, 1.0_p)
            evap(:, :, 1) = chl * denvvs(:, :, 1) * max(0.0, soil_avail_water * qsat0(:, :, 1) - q1(:, :, 1))

            ! 3. Compute land-surface energy balance;
            !    adjust skin temperature and heat fluxes

            ! 3.1. Emission of lw radiation from the surface
            !      and net heat fluxes into land surface
            tsk3 = tskin**3.0
            dslr = 4.0 * esbc * tsk3
            slru(:, :, 1) = esbc * tsk3 * tskin
            hfluxn(:, :, 1) = ssrd * (1.0 - alb_land) + slrd - (slru(:, :, 1) + shf(:, :, 1) + alhc * evap(:, :, 1))

            ! 3.2 Re-definition of skin temperature from energy balance
            if (lskineb) then
                ! Compute net heat flux including flux into ground
                clamb = clambda + snowc * (clambsn - clambda)
                hfluxn(:, :, 1) = hfluxn(:, :, 1) - clamb * (tskin - land_temp)
                dtskin = tskin + 1.0

                ! Compute d(Evap) for a 1-degree increment of Tskin
                qsat0(:, :, 2) = get_qsat(dtskin, psa, 1.0_p)

                do i = 1, ix
                    do j = 1, il
                        if (evap(i, j, 1) > 0.0) then
                            qsat0(i, j, 2) = soil_avail_water(i, j) * (qsat0(i, j, 2) - qsat0(i, j, 1))
                        else
                            qsat0(i, j, 2) = 0.0
                        end if
                    end do
                end do

                ! Redefine skin temperature to balance the heat budget
                dtskin = hfluxn(:, :, 1) / (clamb + dslr + chl * denvvs(:, :, 1) * (cp + alhc * qsat0(:, :, 2)))
                tskin = tskin + dtskin

                ! Add linear corrections to heat fluxes
                shf(:, :, 1) = shf(:, :, 1) + chlcp * denvvs(:, :, 1) * dtskin
                evap(:, :, 1) = evap(:, :, 1) + chl * denvvs(:, :, 1) * qsat0(:, :, 2) * dtskin
                slru(:, :, 1) = slru(:, :, 1) + dslr * dtskin
                hfluxn(:, :, 1) = clamb * (tskin - land_temp)
            end if

            rdth = fstab / dtheta
            astab = 1.0
            if (lscasym) astab = 0.5   ! to get smaller dS/dT in stable conditions

            do i = 1, ix
                do j = 1, il
                    if (tsea(i, j) > t2(i, j, 2)) then
                        dths = min(dtheta, tsea(i, j) - t2(i, j, 2))
                    else
                        dths = max(-dtheta, astab * (tsea(i, j) - t2(i, j, 2)))
                    end if
                    denvvs(i, j, 2) = denvvs(i, j, 0) * (1.0 + dths * rdth)
                end do
            end do

            if (fhum0 > 0.0) then
                call rel_hum_to_spec_hum(t1(:, :, 2), psa, 1.0_p, rh(:, :, kx), q1(:, :, 2), qsat0(:, :, 2))

                q1(:, :, 2) = fhum0 * q1(:, :, 2) + ghum0 * qa(:, :, kx)
            else
                q1(:, :, 2) = qa(:, :, kx)
            end if

            ! 4.2 Wind stress
            ks = 2

            cdsdv = cds * denvvs(:, :, ks)
            ustr(:, :, 2) = -cdsdv * ua(:, :, kx)
            vstr(:, :, 2) = -cdsdv * va(:, :, kx)
        end if

        ! =========================================================================
        ! Sea surface
        ! =========================================================================

        ! 4.3 Sensible heat flux
        shf(:, :, 2) = chs * cp * denvvs(:, :, ks) * (tsea - t1(:, :, 2))

        ! 4.4 Evaporation
        qsat0(:, :, 2) = get_qsat(tsea, psa, 1.0_p)
        evap(:, :, 2) = chs * denvvs(:, :, ks) * (qsat0(:, :, 2) - q1(:, :, 2))

        ! 4.5 Emission of lw radiation from the surface
        !     and net heat fluxes into sea surface
        slru(:, :, 2) = esbc * tsea**4.0
        hfluxn(:, :, 2) = ssrd * (1.0 - alb_sea) + slrd - slru(:, :, 2) + shf(:, :, 2) + alhc * evap(:, :, 2)

        ! =========================================================================
        ! Weighted average of surface fluxes and temperatures according to land-sea
        ! mask
        ! =========================================================================

        if (lfluxland) then
            ustr(:, :, 3) = ustr(:, :, 2) + fmask * (ustr(:, :, 1) - ustr(:, :, 2))
            vstr(:, :, 3) = vstr(:, :, 2) + fmask * (vstr(:, :, 1) - vstr(:, :, 2))
            shf(:, :, 3) = shf(:, :, 2) + fmask * (shf(:, :, 1) - shf(:, :, 2))
            evap(:, :, 3) = evap(:, :, 2) + fmask * (evap(:, :, 1) - evap(:, :, 2))
            slru(:, :, 3) = slru(:, :, 2) + fmask * (slru(:, :, 1) - slru(:, :, 2))

            tsfc = tsea + fmask * (land_temp - tsea)
            tskin = tsea + fmask * (tskin - tsea)
            t0 = t1(:, :, 2) + fmask * (t1(:, :, 1) - t1(:, :, 2))
        end if

        ! Deallocate arrays
        deallocate(t1, q1, t2, qsat0)
        deallocate(denvvs)
        deallocate(dslr, dtskin, clamb, cdsdv, tsk3)
    end

    !> Compute orographic factor for land surface drag
    ! Input:   phi0 = surface geopotential
    subroutine set_orog_land_sfc_drag(phi0, forog)
        use physical_constants, only : grav

        real(p), intent(in) :: phi0(ix, il)
        real(p), intent(inout) :: forog(ix, il)  !! Orographic factor for land surface drag
        real(p) :: rhdrag

        rhdrag = 1.0 / (grav * hdrag)

        forog = 1.0 + rhdrag * (1.0 - exp(-max(phi0, 0.0) * rhdrag))
    end
end module