diag_townn.F90

Go to the documentation of this file.

!SFX_LIC Copyright 1994-2014 CNRS, Meteo-France and Universite Paul Sabatier
!SFX_LIC This is part of the SURFEX software governed by the CeCILL-C licence
!SFX_LIC version 1. See LICENSE, CeCILL-C_V1-en.txt and CeCILL-C_V1-fr.txt  
!SFX_LIC for details. version 1.
!     #########
SUBROUTINE diag_town_n (DGL, DGT, U, &
                        hprogram,                                           &
                         prn, ph, ple, plei, pgflux, pri, pcd, pch, pce, pqs,&
                         pz0, pz0h, pt2m, pts, pq2m, phu2m, pzon10m, pmer10m,&
                         pswd, pswu, pswbd, pswbu, plwd, plwu, pfmu, pfmv,   &
                         prnc, phc, plec, pgfluxc, pswdc, pswuc, plwdc,      &
                         plwuc, pfmuc, pfmvc, pt2m_min, pt2m_max, pleic,     &
                         phu2m_min, phu2m_max, pwind10m, pwind10m_max,       &
                         pevap, pevapc, psubl, psublc                        )
!     ######################################################################
!
!!****  *DIAG_TOWN_n * - Chooses the surface schemes for town diagnostics
!!
!!    PURPOSE
!!    -------
!
!!**  METHOD
!!    ------
!!
!!    REFERENCE
!!    ---------
!!      
!!
!!    AUTHOR
!!    ------
!!     V. Masson 
!!
!!    MODIFICATIONS
!!    -------------
!!      Original    01/2004
!!      Modified    01/2006 : sea flux parameterization.
!!      Modified    08/2009 : new diag
!!      Modified    09/2012 : new PLEI diag required by atmospheric model
!       B. decharme 04/2013 : Add EVAP and SUBL diag
!!------------------------------------------------------------------
!

!
!
!
!
USE modd_diag_ideal_n, ONLY : diag_ideal_t
USE modd_diag_teb_n, ONLY : diag_teb_t
USE modd_surf_atm_n, ONLY : surf_atm_t
!
USE modd_surf_par,   ONLY : xundef
USE modd_csts,       ONLY : xtt, xlstt, xlvtt
!
USE modi_diag_teb_n
USE modi_diag_ideal_n
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!*      0.1    declarations of arguments
!
!
TYPE(diag_ideal_t), INTENT(INOUT) :: dgl
TYPE(diag_teb_t), INTENT(INOUT) :: dgt
TYPE(surf_atm_t), INTENT(INOUT) :: u
!
 CHARACTER(LEN=6),   INTENT(IN)  :: hprogram ! program calling surf. schemes
!
REAL, DIMENSION(:), INTENT(OUT) :: prn      ! Net radiation       (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: ph       ! Sensible heat flux  (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: ple      ! Total latent heat flux    (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: plei     ! Sublimation latent heat flux (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pgflux   ! Storage flux        (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pevap    ! Total evapotranspiration  (kg/m2/s)
REAL, DIMENSION(:), INTENT(OUT) :: psubl    ! Sublimation (kg/m2/s)
REAL, DIMENSION(:), INTENT(OUT) :: pri      ! Richardson number   (-)
REAL, DIMENSION(:), INTENT(OUT) :: pcd      ! drag coefficient    (W/s2)
REAL, DIMENSION(:), INTENT(OUT) :: pch      ! transf. coef heat   (W/s)
REAL, DIMENSION(:), INTENT(OUT) :: pce      ! transf. coef vapor  (W/s/K)
REAL, DIMENSION(:), INTENT(OUT) :: pqs
REAL, DIMENSION(:), INTENT(OUT) :: pz0      ! rough. length wind  (m)
REAL, DIMENSION(:), INTENT(OUT) :: pz0h     ! rough. length heat  (m)
REAL, DIMENSION(:), INTENT(OUT) :: pts      ! surface temperature (K)
REAL, DIMENSION(:), INTENT(OUT) :: pt2m     ! temperature at 2m   (K)
REAL, DIMENSION(:), INTENT(OUT) :: pq2m     ! humidity at 2m      (kg/kg)
REAL, DIMENSION(:), INTENT(OUT) :: phu2m    ! relative humidity at 2m (-)
REAL, DIMENSION(:), INTENT(OUT) :: pzon10m  ! zonal wind at 10m   (m/s)
REAL, DIMENSION(:), INTENT(OUT) :: pmer10m  ! meridian wind at 10m(m/s)
REAL, DIMENSION(:), INTENT(OUT) :: pswd     ! incoming short wave radiation (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pswu     ! outgoing short wave radiation (W/m2)
REAL, DIMENSION(:,:), INTENT(OUT) :: pswbd  ! incoming short wave radiation by spectral band(W/m2)
REAL, DIMENSION(:,:), INTENT(OUT) :: pswbu  ! outgoing short wave radiation by spectral band(W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: plwd     ! incoming long wave radiation (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: plwu     ! outgoing long wave radiation (W/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pfmu     ! zonal friction
REAL, DIMENSION(:), INTENT(OUT) :: pfmv     ! meridian friction 
REAL, DIMENSION(:), INTENT(OUT) :: prnc     ! Net radiation       (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: phc      ! Sensible heat flux  (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: plec     ! Total latent heat flux       (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pleic    ! Sublimation latent heat flux (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pgfluxc  ! Storage flux        (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pevapc   ! Total evapotranspiration  (kg/m2/s)
REAL, DIMENSION(:), INTENT(OUT) :: psublc   ! Sublimation (kg/m2/s)
REAL, DIMENSION(:), INTENT(OUT) :: pswdc    ! incoming short wave radiation (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pswuc    ! outgoing short wave radiation (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: plwdc    ! incoming long wave radiation (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: plwuc    ! outgoing long wave radiation (J/m2)
REAL, DIMENSION(:), INTENT(OUT) :: pfmuc    ! zonal friction
REAL, DIMENSION(:), INTENT(OUT) :: pfmvc    ! meridian friction 
REAL, DIMENSION(:), INTENT(OUT) :: pt2m_min ! Minimum temperature at 2m   (K)
REAL, DIMENSION(:), INTENT(OUT) :: pt2m_max ! Maximum temperature at 2m   (K)
REAL, DIMENSION(:), INTENT(OUT) :: phu2m_min! Minimum relative humidity at 2m (-)
REAL, DIMENSION(:), INTENT(OUT) :: phu2m_max! Maximum relative humidity at 2m (-)
REAL, DIMENSION(:), INTENT(OUT) :: pwind10m ! wind at 10m (m/s)
REAL, DIMENSION(:), INTENT(OUT) :: pwind10m_max! Maximum wind at 10m (m/s)
!
!*      0.2    declarations of local variables
!
REAL, DIMENSION(SIZE(PRN)) :: zdelta
!
REAL(KIND=JPRB) :: zhook_handle
!-------------------------------------------------------------------------------------
!
IF (lhook) CALL dr_hook('DIAG_TOWN_N',0,zhook_handle)
IF (u%CTOWN=='TEB   ') THEN
  CALL diag_teb_n(dgt, &
                  hprogram,                                           &
                    prn, ph, ple, pgflux, pri, pcd, pch, pce, pqs,      &
                    pz0, pz0h, pt2m, pts, pq2m, phu2m, pzon10m, pmer10m,&
                    pswd, pswu, plwd, plwu, pswbd, pswbu, pfmu, pfmv,  &
                    pt2m_min, pt2m_max, phu2m_min, phu2m_max,          &
                    pwind10m, pwind10m_max                             )
!
!!!!! important, diagd should be computed in teb !!!!!!
!
! diag not yet inplemeted for TEB (these diag are required for the climate model)
!
! Ok with atmospheric model but LEI (latent heat of sublimation w/m2), EVAP (total evapotranspiration kg/m2/s),
! and SUBL (sublimation kg/m2/s) must by implemented in TEB as well as theirs cumulative values
! Not good if LCPL_ARP = TRUE in ISBA (ALARO)
!
  IF (SIZE(plei)>0) THEN
    plei(:) = xundef
    pevap(:) = xundef
    psubl(:) = xundef
    WHERE(ple(:)/=xundef)
      zdelta(:) = max(0.0,sign(1.0,xtt-pts(:)))
      pevap(:) = (ple(:) * zdelta(:))/xlstt + (ple(:) * (1.0-zdelta(:)))/xlvtt
      plei(:) = ple(:) * zdelta(:)
      psubl(:) = plei(:)/xlstt
    ENDWHERE
  ENDIF
!
  plec     = xundef
  pleic    = xundef
  pevapc   = xundef
  psublc   = xundef
  prnc     = xundef
  phc      = xundef
  pgfluxc  = xundef
  pswdc    = xundef
  pswuc    = xundef
  plwdc    = xundef
  plwuc    = xundef
  pfmuc    = xundef
  pfmvc    = xundef
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!      
ELSE IF (u%CTOWN=='FLUX  ') THEN
  CALL diag_ideal_n(dgl, hprogram,                                         &
                        prn, ph, ple, plei, pgflux, pri, pcd, pch, pce, pqs,&
                        pz0, pz0h, pt2m, pts, pq2m, phu2m, pzon10m, pmer10m,&
                        pswd, pswu, plwd, plwu, pswbd, pswbu, pfmu, pfmv,   &
                        prnc, phc, plec, pgfluxc, pswdc, pswuc, plwdc,      &
                        plwuc, pfmuc, pfmvc, pt2m_min, pt2m_max, pleic,     &
                        phu2m_min, phu2m_max, pwind10m, pwind10m_max,       &
                        pevap, pevapc, psubl, psublc                        )
ELSE IF (u%CTOWN=='NONE  ') THEN
  prn      = xundef
  ph       = xundef
  ple      = xundef
  plei     = xundef
  pevap    = xundef
  psubl    = xundef  
  pgflux   = xundef
  pri      = xundef
  pcd      = xundef
  pch      = xundef
  pce      = xundef
  pqs      = xundef
  pz0      = xundef
  pz0h     = xundef
  pts      = xundef
  pt2m     = xundef
  pq2m     = xundef
  phu2m    = xundef
  pzon10m  = xundef
  pmer10m  = xundef
  pswd     = xundef
  pswu     = xundef
  pswbd    = xundef
  pswbu    = xundef
  plwd     = xundef
  plwu     = xundef
  pfmu     = xundef
  pfmv     = xundef
  prnc     = xundef
  phc      = xundef
  plec     = xundef
  pleic    = xundef
  pevapc   = xundef
  psublc   = xundef
  pgfluxc  = xundef
  pswdc    = xundef
  pswuc    = xundef
  plwdc    = xundef
  plwuc    = xundef
  pfmuc    = xundef
  pfmvc    = xundef 
  pt2m_min = xundef
  pt2m_max = xundef
  phu2m_min= xundef
  phu2m_max= xundef  
  pwind10m = xundef
  pwind10m_max = xundef
END IF
IF (lhook) CALL dr_hook('DIAG_TOWN_N',1,zhook_handle)
!
!-------------------------------------------------------------------------------------
!
END SUBROUTINE diag_town_n