init_tebn.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 init_teb_n (DTCO, UG, U, GCP, CHT, DTT, SB, TG, TOP, TPN,    &
                             TIR, NT, TD, BDD, BOP, DTB, NB, GDM, GRM,        &
                             HPROGRAM, HINIT, KI, KSV, KSW, HSV, PCO2,        &
                             PRHOA, PZENITH, PAZIM, PSW_BANDS, PDIR_ALB,      &
                             PSCA_ALB, PEMIS, PTSRAD, PTSURF, KYEAR, KMONTH,  &
                             KDAY, PTIME, HATMFILE, HATMFILETYPE, HTEST )  
!     #############################################################
!
!!****  *INIT_TEB_n* - routine to initialize TEB
!!
!!    PURPOSE
!!    -------
!!
!!**  METHOD
!!    ------
!!
!!    EXTERNAL
!!    --------
!!
!!
!!    IMPLICIT ARGUMENTS
!!    ------------------
!!
!!    REFERENCE
!!    ---------
!!
!!
!!    AUTHOR
!!    ------
!!      V. Masson   *Meteo France*
!!
!!    MODIFICATIONS
!!    -------------
!!      Original    01/2003
!!      G. Pigeon   09/2012: add ROUGH_WALL/ROUGH_ROOF/CH_BEM for conv. coef.
!!      B. Decharme  04/2013 new coupling variables
!!                           delete CTOPREG option (never used)
!-------------------------------------------------------------------------------
!
!*       0.    DECLARATIONS
!              ------------
!
USE modd_data_cover_n, ONLY : data_cover_t
USE modd_surf_atm_grid_n, ONLY : surf_atm_grid_t
USE modd_surf_atm_n, ONLY : surf_atm_t
USE modd_grid_conf_proj_n, ONLY : grid_conf_proj_t
!
USE modd_ch_teb_n, ONLY : ch_teb_t
USE modd_data_teb_n, ONLY : data_teb_t
USE modd_canopy_n, ONLY: canopy_t
USE modd_sfx_grid_n, ONLY : grid_t
USE modd_teb_option_n, ONLY : teb_options_t
USE modd_teb_panel_n, ONLY : teb_panel_t
USE modd_teb_irrig_n, ONLY : teb_irrig_t
USE modd_teb_n, ONLY : teb_np_t
USE modd_surfex_n, ONLY : teb_diag_t, teb_veg_diag_t, teb_garden_model_t, teb_greenroof_model_t
USE modd_bld_description_n, ONLY : bld_desc_t
USE modd_bem_option_n, ONLY : bem_options_t
USE modd_data_bem_n, ONLY : data_bem_t
USE modd_bem_n, ONLY : bem_np_t
!
USE modd_io_surf_asc,ONLY: cmask
USE modd_snow_par, ONLY : xemissn
!
USE modd_read_namelist, ONLY : lnam_read
!
USE modd_chs_aerosol,     ONLY: lvarsigi, lvarsigj
USE modd_dst_surf,        ONLY: lvarsig_dst, ndstmde, ndst_mdebeg, lrgfix_dst 
USE modd_slt_surf,        ONLY: lvarsig_slt, nsltmde, nslt_mdebeg, lrgfix_slt
USE modd_surf_par,        ONLY: xundef, nundef
!
USE modn_prep_teb, ONLY : croad_dir, cwall_opt
!
USE modi_init_io_surf_n
USE modi_default_ch_dep
USE modi_default_teb
USE modi_default_diag_teb
USE modi_read_default_teb_n
USE modi_read_teb_conf_n
USE modi_prep_ctrl_teb
USE modi_read_teb_n
USE modi_read_pgd_teb_n
USE modi_convert_teb
USE modi_convert_patch_teb
USE modi_init_snow_lw
USE modi_averaged_tsrad_teb
USE modi_averaged_albedo_teb
USE modi_diag_teb_init_n
USE modi_diag_misc_teb_init_n
USE modi_end_io_surf_n
USE modi_get_luout
USE modi_read_surf
USE modi_read_prep_teb_snow
USE modi_read_teb_date
USE modi_read_nam_prep_teb_n
USE modi_init_chemical_n
USE modi_teb_veg_properties
USE modi_hvac_autosize
!
USE modi_init_teb_garden_n
USE modi_init_teb_garden_pgd_n
USE modi_init_teb_veg_options_n
USE modi_teb_morpho
USE modi_init_bem_n
USE modi_init_teb_greenroof_n
USE modi_init_teb_greenroof_pgd_n
USE modi_read_pgd_teb_irrig_n
!
USE modi_read_cover_garden
USE modi_abor1_sfx
USE modi_read_sbl_n
USE modi_set_surfex_filein
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!*       0.1   Declarations of arguments
!              -------------------------
!
!
TYPE(data_cover_t), INTENT(INOUT) :: DTCO
TYPE(surf_atm_grid_t), INTENT(INOUT) :: UG
TYPE(surf_atm_t), INTENT(INOUT) :: U
TYPE(grid_conf_proj_t),INTENT(INOUT) :: GCP
!
TYPE(ch_teb_t), INTENT(INOUT) :: CHT 
TYPE(data_teb_t), INTENT(INOUT) :: DTT
TYPE(canopy_t), INTENT(INOUT) :: SB
TYPE(grid_t), INTENT(INOUT) :: TG
TYPE(teb_options_t), INTENT(INOUT) :: TOP
TYPE(teb_panel_t), INTENT(INOUT) :: TPN
TYPE(teb_irrig_t), INTENT(INOUT) :: TIR
TYPE(teb_np_t), INTENT(INOUT) :: NT
!
TYPE(teb_diag_t), INTENT(INOUT) :: TD
!
TYPE(bld_desc_t), INTENT(INOUT) :: BDD
TYPE(bem_options_t), INTENT(INOUT) :: BOP 
TYPE(data_bem_t), INTENT(INOUT) :: DTB
TYPE(bem_np_t), INTENT(INOUT) :: NB
!
TYPE(teb_garden_model_t), INTENT(INOUT) :: GDM
TYPE(teb_greenroof_model_t), INTENT(INOUT) :: GRM
!
 CHARACTER(LEN=6),                   INTENT(IN)  :: HPROGRAM    ! program calling surf. schemes
 CHARACTER(LEN=3),                   INTENT(IN)  :: HINIT       ! choice of fields to initialize
INTEGER,                            INTENT(IN)  :: KI          ! number of points
INTEGER,                            INTENT(IN)  :: KSV         ! number of scalars
INTEGER,                            INTENT(IN)  :: KSW         ! number of short-wave spectral bands
 CHARACTER(LEN=6), DIMENSION(KSV),   INTENT(IN)  :: HSV         ! name of all scalar variables
REAL,             DIMENSION(KI),    INTENT(IN)  :: PCO2        ! CO2 concentration (kg/m3)
REAL,             DIMENSION(KI),    INTENT(IN)  :: PRHOA       ! air density
REAL,             DIMENSION(KI),    INTENT(IN)  :: PZENITH     ! solar zenithal angle
REAL,             DIMENSION(KI),    INTENT(IN)  :: PAZIM       ! solar azimuthal angle (rad from N, clock)
REAL,             DIMENSION(KSW),   INTENT(IN)  :: PSW_BANDS   ! middle wavelength of each band
REAL,             DIMENSION(KI,KSW),INTENT(OUT) :: PDIR_ALB    ! direct albedo for each band
REAL,             DIMENSION(KI,KSW),INTENT(OUT) :: PSCA_ALB    ! diffuse albedo for each band
REAL,             DIMENSION(KI),    INTENT(OUT) :: PEMIS       ! emissivity
REAL,             DIMENSION(KI),    INTENT(OUT) :: PTSRAD      ! radiative temperature
REAL,             DIMENSION(KI),    INTENT(OUT) :: PTSURF      ! surface effective temperature         (K)
INTEGER,                            INTENT(IN)  :: KYEAR       ! current year (UTC)
INTEGER,                            INTENT(IN)  :: KMONTH      ! current month (UTC)
INTEGER,                            INTENT(IN)  :: KDAY        ! current day (UTC)
REAL,                               INTENT(IN)  :: PTIME       ! current time since
                                                               !  midnight (UTC, s)
!
 CHARACTER(LEN=28),                  INTENT(IN)  :: HATMFILE    ! atmospheric file name
 CHARACTER(LEN=6),                   INTENT(IN)  :: HATMFILETYPE! atmospheric file type
 CHARACTER(LEN=2),                   INTENT(IN)  :: HTEST       ! must be equal to 'OK'
!
!*       0.2   Declarations of local variables
!              -------------------------------
!
INTEGER                         :: ILU              ! sizes of TEB arrays
INTEGER                         :: ILUOUT           ! unit of output listing file
INTEGER                         :: IRESP            ! return code
!
INTEGER                         :: ISWB             ! number of shortwave spectral bands
INTEGER                         :: JSWB             ! loop on shortwave spectral bands
!
REAL                            :: ZDEF_ROAD_DIR    ! default raod direction
REAL, DIMENSION(:), ALLOCATABLE :: ZDIR_ALB         ! direct town albedo
REAL, DIMENSION(:), ALLOCATABLE :: ZSCA_ALB         ! diffuse town albedo
!
!              local variables for urban green areas
REAL, DIMENSION(KI,KSW)         :: ZDIR_SW          ! direct  SW for each band
REAL, DIMENSION(KI,KSW)         :: ZSCA_SW          ! diffuse SW for each band
REAL, DIMENSION(KI)             :: ZEMIS_GARDEN     ! emissivity
REAL, DIMENSION(KI)             :: ZALB_GARDEN      ! albedo
REAL, DIMENSION(KI)             :: ZTS_GARDEN       ! radiative temperature
!
!              local variables for urban greenroofs
REAL, DIMENSION(KI)             :: ZEMIS_GREENROOF     ! emissivity
REAL, DIMENSION(KI)             :: ZALB_GREENROOF      ! albedo
REAL, DIMENSION(KI)             :: ZTS_GREENROOF       ! radiative temperature
!
INTEGER                         :: JP
INTEGER                         :: IVERSION, IBUGFIX

REAL(KIND=JPRB) :: ZHOOK_HANDLE
!-------------------------------------------------------------------------------
!
!         Initialisation for IO
!
IF (lhook) CALL dr_hook('INIT_TEB_N',0,zhook_handle)
 CALL get_luout(hprogram,iluout)
!
IF (htest/='OK') THEN
  CALL abor1_sfx('INIT_TEBN: FATAL ERROR DURING ARGUMENT TRANSFER')
END IF
!
!         Other little things
!
pdir_alb = xundef
psca_alb = xundef
pemis    = xundef
ptsrad   = xundef
ptsurf   = xundef
!
td%MTO%LSURF_EVAP_BUDGET = .false.
!
IF (lnam_read) THEN
 !
 !*       0.     Defaults
 !               --------
 !
 !        0.1. Hard defaults
 !  
  CALL default_teb(top%CZ0H, top%XTSTEP, top%XOUT_TSTEP, top%CCH_BEM, &
                   nt%AL(1)%XDT_RES, nt%AL(1)%XDT_OFF)
  CALL default_ch_dep(cht%CCH_DRY_DEP)
  CALL default_diag_teb(td%O%N2M, td%O%LSURF_BUDGET, td%O%L2M_MIN_ZS, td%O%LRAD_BUDGET,&
                        td%O%LCOEF, td%O%LSURF_VARS, td%MTO%LSURF_MISC_BUDGET, &
                        td%MTO%LSURF_DIAG_ALBEDO, td%DUT%LUTCI, td%O%LPGD,     &
                        td%O%XDIAG_TSTEP)  
!
ENDIF
!
!        0.2. Defaults from file header
!    
 CALL read_default_teb_n(cht, td%MTO, td%O, td%DUT, grm%O, nt%AL(1), top, hprogram)
!
!*       1.     Reading of configuration:
!               -------------------------
!
 CALL read_teb_conf_n(cht, td%MTO, td%O, td%DUT, nt%AL(1), top, hprogram)
!
!* initialization of snow scheme
!
IF (hinit=='PRE') THEN
  CALL read_prep_teb_snow(hprogram, nt%AL(1)%TSNOW_ROOF%SCHEME, nt%AL(1)%TSNOW_ROOF%NLAYER, &
                                    nt%AL(1)%TSNOW_ROAD%SCHEME, nt%AL(1)%TSNOW_ROAD%NLAYER)
ENDIF
!
!*       2.     Cover fields and grid:
!               ---------------------
!* date
!
SELECT CASE (hinit)
  CASE ('PGD')
    top%TTIME%TDATE%YEAR = nundef
    top%TTIME%TDATE%MONTH= nundef
    top%TTIME%TDATE%DAY  = nundef
    top%TTIME%TIME       = xundef

  CASE ('PRE')
    CALL prep_ctrl_teb(td%O, td%MTO%LSURF_EVAP_BUDGET, td%MTO%LSURF_MISC_BUDGET, td%DUT%LUTCI,iluout )           
    IF (lnam_read) CALL read_nam_prep_teb_n(hprogram)   
    CALL read_teb_date(hprogram,hinit,iluout,hatmfile,hatmfiletype,kyear,kmonth,kday,ptime,top%TTIME)

  CASE DEFAULT
    CALL init_io_surf_n(dtco, u, hprogram,'FULL  ','SURF  ','READ ')
    CALL read_surf(hprogram,'DTCUR',top%TTIME,iresp)
    CALL end_io_surf_n(hprogram)
END SELECT
!
!-----------------------------------------------------------------------------------------------------
! READ PGD FILE
!-----------------------------------------------------------------------------------------------------
!
!         Initialisation for IO
!
 CALL set_surfex_filein(hprogram,'PGD ') ! change input file name to pgd name
 CALL init_io_surf_n(dtco, u, hprogram,'TOWN  ','TEB   ','READ ')
!
 CALL read_surf(hprogram,'VERSION',iversion,iresp)
 CALL read_surf(hprogram,'BUG',ibugfix,iresp)
!
!         Reading of the fields
!
 CALL read_cover_garden(hprogram,top%LGARDEN)
!
 CALL read_pgd_teb_n(dtco, u, ug, gcp, top, tg, bop, bdd, dtb, dtt, hprogram)
!
 CALL end_io_surf_n(hprogram)
! 
!*        Fraction of each patch in the grid mesh
!
ilu = SIZE(top%XCOVER,1)
!
ALLOCATE(top%XTEB_PATCH(ilu,top%NTEB_PATCH))
 CALL convert_teb(top%NTEB_PATCH, top%XCOVER,top%XTEB_PATCH)
!
!
!* reads what is the option defined for road orientations & walls
!
IF (hinit=='ALL') THEN
  !
  CALL set_surfex_filein(hprogram,'PREP') ! restore input file name
  CALL init_io_surf_n(dtco, u, hprogram,'TOWN  ','TEB   ','READ ')
!
  CALL read_surf(hprogram,'VERSION',iversion,iresp)
  CALL read_surf(hprogram,'BUG',ibugfix,iresp)
!
  top%CROAD_DIR='UNIF'
  top%CWALL_OPT='UNIF'
  IF (iversion>7 .OR. (iversion==7 .AND. ibugfix>=3)) THEN
    CALL read_surf(hprogram,'ROAD_DIR',top%CROAD_DIR,iresp)
    CALL read_surf(hprogram,'WALL_OPT',top%CWALL_OPT,iresp)
  END IF
  CALL end_io_surf_n(hprogram)
  !
ELSE
  !
  top%CROAD_DIR = croad_dir
  top%CWALL_OPT = cwall_opt
  !  
ENDIF
!      
!-----------------------------------------------------------------------------------
!
!*              LOOP ON TEB PATCHES
!               -------------------
!
DO jp=1,top%NTEB_PATCH
  !
  !-----------------------------------------------------------------------------------
  !
  !*       3.     Physiographic data fields from land cover:
  !               -----------------------------------------
  !
  ALLOCATE(nt%AL(jp)%XZ0_TOWN     (ilu))
  ALLOCATE(nt%AL(jp)%XALB_ROOF    (ilu))
  ALLOCATE(nt%AL(jp)%XEMIS_ROOF   (ilu))
  ALLOCATE(nt%AL(jp)%XALB_ROAD    (ilu))
  ALLOCATE(nt%AL(jp)%XEMIS_ROAD   (ilu))
  ALLOCATE(nt%AL(jp)%XALB_WALL    (ilu))
  ALLOCATE(nt%AL(jp)%XEMIS_WALL   (ilu))
  ALLOCATE(nt%AL(jp)%XBLD         (ilu))
  ALLOCATE(nt%AL(jp)%XROAD_DIR    (ilu))
  ALLOCATE(nt%AL(jp)%XROAD        (ilu))
  ALLOCATE(nt%AL(jp)%XBLD_HEIGHT  (ilu))
  ALLOCATE(nt%AL(jp)%XWALL_O_HOR  (ilu))
  ALLOCATE(nt%AL(jp)%XCAN_HW_RATIO(ilu))
  ALLOCATE(nt%AL(jp)%XROAD_O_GRND (ilu))
  ALLOCATE(nt%AL(jp)%XGARDEN_O_GRND(ilu))
  ALLOCATE(nt%AL(jp)%XWALL_O_GRND (ilu))
  ALLOCATE(nt%AL(jp)%XWALL_O_BLD(  ilu))
  ALLOCATE(nt%AL(jp)%XH_TRAFFIC   (ilu))
  ALLOCATE(nt%AL(jp)%XLE_TRAFFIC  (ilu))
  ALLOCATE(nt%AL(jp)%XH_INDUSTRY  (ilu))
  ALLOCATE(nt%AL(jp)%XLE_INDUSTRY (ilu))
  ALLOCATE(nt%AL(jp)%XHC_ROOF     (ilu,top%NROOF_LAYER))
  ALLOCATE(nt%AL(jp)%XTC_ROOF     (ilu,top%NROOF_LAYER))
  ALLOCATE(nt%AL(jp)%XD_ROOF      (ilu,top%NROOF_LAYER))
  ALLOCATE(nt%AL(jp)%XHC_ROAD     (ilu,top%NROAD_LAYER))
  ALLOCATE(nt%AL(jp)%XTC_ROAD     (ilu,top%NROAD_LAYER))
  ALLOCATE(nt%AL(jp)%XD_ROAD      (ilu,top%NROAD_LAYER))
  ALLOCATE(nt%AL(jp)%XHC_WALL     (ilu,top%NWALL_LAYER))
  ALLOCATE(nt%AL(jp)%XTC_WALL     (ilu,top%NWALL_LAYER))
  ALLOCATE(nt%AL(jp)%XD_WALL      (ilu,top%NWALL_LAYER))
  ALLOCATE(nt%AL(jp)%XROUGH_ROOF  (ilu))
  ALLOCATE(nt%AL(jp)%XROUGH_WALL  (ilu))
  ALLOCATE(nt%AL(jp)%XRESIDENTIAL (ilu))
  ALLOCATE(nt%AL(jp)%XGREENROOF   (ilu))
  ALLOCATE(nt%AL(jp)%XGARDEN      (ilu))
  ALLOCATE(tpn%XEMIS_PANEL    (ilu))
  ALLOCATE(tpn%XALB_PANEL     (ilu))
  ALLOCATE(tpn%XEFF_PANEL     (ilu))
  ALLOCATE(tpn%XFRAC_PANEL    (ilu))
  !
  nt%AL(jp)%XROAD_DIR(:) = 0.
  nt%AL(jp)%XROAD    (:) = 0.
  !
  zdef_road_dir = 0.
  IF (top%CROAD_DIR/='UNIF') THEN
    !* road direction if not specified by the user depends on patch number
    !  First patch has a Notrh-South road. Other patches have roads spaced by
    !  regular angles
    zdef_road_dir = 180. * float(jp-1) / float(top%NTEB_PATCH)
  END IF
  !
  CALL convert_patch_teb(bdd, dtb, dtco, dtt, top, zdef_road_dir, t=nt%AL(jp), tpn=tpn  )
  !
  IF (.NOT. top%LGREENROOF .AND. maxval(nt%AL(jp)%XGREENROOF)>0. ) THEN 
    WRITE(iluout,*) 'You choose NOT to have greenroofs, BUT your greenroof fraction is not zero'
    WRITE(iluout,*) 'Please activate the greenroof option (and rerun the SURFEX suite from the PGD step)'
    WRITE(iluout,*) 'Or be sure NOT to have any greenroofs in your area'
    CALL abor1_sfx('INIT_TEBN: GREENROOF OPTION NOT ACTIVATED WHILE GREENROOFS ARE PRESENT')
  ENDIF
  !
  IF (.NOT. top%LSOLAR_PANEL .AND. maxval(tpn%XFRAC_PANEL)>0. ) THEN 
    WRITE(iluout,*) 'You choose NOT to have solar panels, BUT your solar panel fraction is not zero'
    WRITE(iluout,*) 'Please activate the solar panel option (and rerun the SURFEX suite from the PGD step)'
    WRITE(iluout,*) 'Or be sure NOT to have any solar panel in your area'
    CALL abor1_sfx('INIT_TEBN: SOLAR_PANEL OPTION NOT ACTIVATED WHILE SOLAR PANELS ARE PRESENT')
  ENDIF
  !
  !-------------------------------------------------------------------------------
  !
  !*       5.     Sky-view-factors:
  !               ----------------
  !
  ALLOCATE(nt%AL(jp)%XSVF_ROAD  (ilu))
  ALLOCATE(nt%AL(jp)%XSVF_GARDEN(ilu))
  ALLOCATE(nt%AL(jp)%XSVF_WALL  (ilu))
  !
  ALLOCATE(nb%AL(jp)%XGR          (ilu))
  ALLOCATE(nb%AL(jp)%XALB_WIN     (ilu))
  ALLOCATE(nb%AL(jp)%XF_WASTE_CAN (ilu))
  !
  !
  CALL teb_morpho(hprogram, nt%AL(jp)  )
                !
  !-------------------------------------------------------------------------------
  !
  !*       6.     Building Energy Model
  !               ---------------------
  !
  CALL init_bem_n(dtco, top, bop, dtt, dtb, bdd, tg, nt%AL(jp), nb%AL(jp), iluout)
  !
  !-------------------------------------------------------------------------------
  !
  !*      7.      Case of urban green areas
  !               -------------------------
  !
  IF (top%LGARDEN) THEN
  !
    CALL set_surfex_filein(hprogram,'PGD ') ! change input file name to pgd name
    CALL init_io_surf_n(dtco, u, hprogram,'TOWN  ','TEB   ','READ ')     
    IF (jp==1) CALL init_teb_veg_options_n(cht, td%MTO%LSURF_DIAG_ALBEDO, top%LGREENROOF, gdm%O, grm%O, hprogram)
    CALL init_teb_garden_pgd_n(dtco, u, cht%LCH_BIO_FLUX, tg, nt%AL(jp)%XGARDEN, top, &
                               gdm%O, gdm%S, gdm%K, gdm%P, gdm%NPE%AL(jp), gdm%DTV, gdm%GB, &
                               hprogram,hinit,(jp==1),ki,iversion,ibugfix,pco2,prhoa)
    ! Case of urban green roofs
    IF (top%LGREENROOF) THEN
      CALL init_teb_greenroof_pgd_n(dtco, u, cht%LCH_BIO_FLUX, tg, nt%AL(jp)%XGREENROOF, top, &
                                    grm%O, grm%S, grm%K, grm%P, grm%NPE%AL(jp), grm%DTV, grm%GB, &
                                    hprogram,hinit,(jp==1),ki,iversion,pco2,prhoa)
    ENDIF
    CALL end_io_surf_n(hprogram)
    !
  ENDIF
!-------------------------------------------------------------------------------
END DO ! end of loop on TEB patches
!-------------------------------------------------------------------------------
!
!* Read irrigation parameters for TEB
!
 CALL set_surfex_filein(hprogram,'PGD ') ! change input file name to pgd name
 CALL init_io_surf_n(dtco, u, hprogram,'TOWN  ','TEB   ','READ ')     
 CALL read_pgd_teb_irrig_n(tg, tir, hprogram)
 CALL end_io_surf_n(hprogram)
!
!-------------------------------------------------------------------------------
!
!* if only physiographic fields are to be initialized, stop here.
!
IF (hinit/='ALL' .AND. hinit/='SOD') THEN
  IF (lhook) CALL dr_hook('INIT_TEB_N',1,zhook_handle)
  RETURN
END IF
!
!-------------------------------------------------------------------------------
!
!         Initialisation for IO
!
 CALL set_surfex_filein(hprogram,'PREP') ! restore input file name
 CALL init_io_surf_n(dtco, u, hprogram,'TOWN  ','TEB   ','READ ')
!
!*       9.     Prognostic fields:
!               -----------------
!
!*              LOOP ON TEB PATCHES
!               -------------------
!
DO jp=1,top%NTEB_PATCH
!
!* TEB fields
  CALL read_teb_n(nb%AL(jp), bop, dtco, u, nt%AL(jp), top, tpn, hprogram,jp)
!
  ALLOCATE(nt%AL(jp)%XAC_ROOF    (ilu))
  ALLOCATE(nt%AL(jp)%XAC_ROAD    (ilu))
  ALLOCATE(nt%AL(jp)%XAC_WALL    (ilu))
  ALLOCATE(nt%AL(jp)%XAC_TOP     (ilu))
  ALLOCATE(nt%AL(jp)%XAC_ROOF_WAT(ilu))
  ALLOCATE(nt%AL(jp)%XAC_ROAD_WAT(ilu))
  ALLOCATE(nt%AL(jp)%XQSAT_ROOF  (ilu))
  ALLOCATE(nt%AL(jp)%XQSAT_ROAD  (ilu))
  ALLOCATE(nt%AL(jp)%XDELT_ROOF  (ilu))
  ALLOCATE(nt%AL(jp)%XDELT_ROAD  (ilu))
!
!* Case of urban green areas
  IF (top%LGARDEN) THEN
    !     
    CALL init_teb_garden_n(dtco, ug, u, td%MTO, top, gdm%O, gdm%DTV, gdm%K, gdm%P, &
                           gdm%NPE%AL(jp), gdm%VD%ND%AL(jp), gdm%VD%NDE%AL(jp), gdm%VD%NDEC%AL(jp), gdm%VD%NDM%AL(jp), &
                           hprogram, hinit, ki, ksw, psw_bands, jp)
    ! Case of urban green roofs
    IF (top%LGREENROOF) CALL init_teb_greenroof_n(dtco, u, td%MTO, top, grm%O, grm%DTV, grm%K, grm%P, &
                           grm%NPE%AL(jp), grm%VD%ND%AL(jp), grm%VD%NDE%AL(jp), grm%VD%NDEC%AL(jp), grm%VD%NDM%AL(jp), &
                           hprogram, hinit, ki, ksv, psw_bands, jp)
    !
  ENDIF
!-------------------------------------------------------------------------------
!
!*      10.     Infra-red Radiative fields:
!               --------------------------
!
!* snow long-wave properties (not initialized in read_gr_snow)
!
  CALL init_snow_lw(xemissn,nt%AL(jp)%TSNOW_ROOF)
  CALL init_snow_lw(xemissn,nt%AL(jp)%TSNOW_ROAD)
!
  IF (top%LGARDEN) THEN
    zdir_sw=0. ! night as first guess for albedo computation
    zsca_sw=0. !
    CALL teb_veg_properties(nt%AL(jp)%XGARDEN, gdm%O, gdm%NPE%AL(jp), &
                           zdir_sw, zsca_sw, psw_bands, ksw,      &
                           zts_garden, zemis_garden, zalb_garden )      
  ELSE
    zalb_garden = xundef
    zemis_garden= xundef
    zts_garden  = xundef
  END IF
  !
  IF (top%LGREENROOF) THEN
    zdir_sw=0. ! night as first guess for albedo computation
    zsca_sw=0. !
    CALL teb_veg_properties(nt%AL(jp)%XGREENROOF, grm%O, grm%NPE%AL(jp),         & 
                              zdir_sw, zsca_sw, psw_bands, ksw,              &
                              zts_greenroof, zemis_greenroof, zalb_greenroof )  
  ELSE
    zalb_greenroof  = xundef
    zemis_greenroof = xundef
    zts_greenroof   = xundef
  END IF
!
!* averaged albedo, emissivity and radiative temperature
!
  CALL averaged_tsrad_teb(nt%AL(jp), nb%AL(jp), zemis_garden, zts_garden,  &
                          zemis_greenroof, zts_greenroof, pemis, ptsrad  )
!
!
!*       9.     Visible and near-infra-red Radiative fields:
!               -------------------------------------------
!
  ALLOCATE(zdir_alb(ilu))
  ALLOCATE(zsca_alb(ilu))
!
  CALL averaged_albedo_teb(top,nt%AL(jp),tpn,nb%AL(jp),pzenith,pazim,   &
                           zalb_garden, zalb_greenroof,zdir_alb, zsca_alb)  

  iswb=SIZE(psw_bands)
  DO jswb=1,iswb
    pdir_alb(:,jswb) = zdir_alb(:)
    psca_alb(:,jswb) = zsca_alb(:)
  END DO
  !
  DEALLOCATE(zdir_alb)
  DEALLOCATE(zsca_alb)
!-------------------------------------------------------------------------------
!
!*      10.     Chemistry /dust
!               ---------------
!
  CALL init_chemical_n(iluout, ksv, hsv, cht%SVT,          &
                       cht%CCH_NAMES, cht%CAER_NAMES,     &
                       hdstnames=cht%CDSTNAMES, hsltnames=cht%CSLTNAMES        )
!
!* Initialization of dry deposition scheme (chemistry)
!
  IF (cht%SVT%NBEQ>0 .AND. cht%CCH_DRY_DEP=='WES89') THEN
    ALLOCATE(cht%XDEP(ilu,cht%SVT%NBEQ))
  ELSE
    ALLOCATE(cht%XDEP(0,0))
  END IF
!
!-------------------------------------------------------------------------------
END DO ! end of loop on patches
!
IF (hinit/='ALL') THEN
  CALL end_io_surf_n(hprogram)
  IF (lhook) CALL dr_hook('INIT_TEB_N',1,zhook_handle)
  RETURN
END IF
!-------------------------------------------------------------------------------
!
!*       7.     Canopy air fields:
!               ------------------
!
 CALL read_sbl_n(dtco, u, sb, top%LCANOPY, hprogram, "TOWN  ")
!
!-------------------------------------------------------------------------------
!
!*      11.     Diagnostics:
!               -----------
!
 CALL diag_teb_init_n(td%O, td%D, td%DUT, hprogram,ilu,iswb)
!
DO jp=1,top%NTEB_PATCH
  CALL diag_misc_teb_init_n(td%NDMTC%AL(jp), td%NDMT%AL(jp), td%MTO, top, ilu, iswb)
END DO ! end of loop on patches
!
!-------------------------------------------------------------------------------
!
!         End of IO
!
 CALL end_io_surf_n(hprogram)
IF (lhook) CALL dr_hook('INIT_TEB_N',1,zhook_handle)
!
!
END SUBROUTINE init_teb_n