layer_e_budget.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 layer_e_budget( PT, PTSTEP, PIMPL, PHC, PTC, PD, PA, PB, PC, PY, PDQS )
!   ##########################################################################
!
!!****  *FLOOR_LAYER_E_BUDGET*  
!!
!!    PURPOSE
!!    -------
!
!     Computes the evoultion of building floor temperatures
!         
!     
!!**  METHOD
!     ------
!
!    6 : equations for evolution of Ts_floor 
!        *************************************************************
!
!     dTf_k(t) / dt = 1/(df_k*Cf_k) * (- 2*Kf_k-1*(Tf_k-Tf_k-1)/(df_k-1 +df_k) 
!                                      - 2*Kf_k  *(Tf_k-Tf_k+1)/(df_k+1 +df_k) )
!
!     dTf_1(t) / dt = 1/(df_1*Cf_1) * (- 2*Kw_1*(Tw_1-Tw_2)/(dw_1 +dw_2))
!
!       with
!
!   K*_k  = (d*_k+ d*_k+1)/(d*_k/k*_k+ d*_k+1/k*_k+1)
!
!
! The system is implicited (or semi-implicited).
!
! ZIMPL=1    ---> implicit system
! ZIMPL=0.5  ---> semi-implicit system
! ZIMPL=0    ---> explicit system
!
!
!
!
!!    EXTERNAL
!!    --------
!!
!!
!!    IMPLICIT ARGUMENTS
!!    ------------------
!!
!!    MODD_CST
!!
!!      
!!    REFERENCE
!!    ---------
!!
!!      
!!    AUTHOR
!!    ------
!!
!!      G. Pigeon           * Meteo-France *
!!
!!    MODIFICATIONS
!!    -------------
!!      Original    15/04/09 
!!                     08/10 (G. Pigeon) computation of residual of energy balance 
!!                                       modification of the limit condition for
!!                                       the deep temp. from the deep road temp.
!!                                       to zero flux condition. idem for sfce T
!-------------------------------------------------------------------------------
!
!*       0.     DECLARATIONS
!               ------------
!
USE modi_tridiag_ground
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!*      0.1    declarations of arguments
!
REAL, DIMENSION(:,:), INTENT(INOUT) :: pt      ! floor layers temperatures
REAL,                 INTENT(IN)    :: ptstep  ! time step
REAL, DIMENSION(:,:), INTENT(IN)    :: phc     ! heat capacity for road layers
REAL, DIMENSION(:,:), INTENT(IN)    :: ptc     ! thermal conductivity for 
                                               !road layers
REAL, DIMENSION(:,:), INTENT(IN)  :: pd      ! depth of road layers
REAL, DIMENSION(:,:), INTENT(IN)  :: pa 
REAL, DIMENSION(:,:), INTENT(IN)  :: pb 
REAL, DIMENSION(:,:), INTENT(IN)  :: pc
REAL, DIMENSION(:,:), INTENT(IN)  :: py
REAL, DIMENSION(:), INTENT(OUT) :: pdqs
REAL,               INTENT(IN)  :: pimpl ! implicitation coefficient
!
!*      0.2    declarations of local variables
!
!
REAL :: zimpl          ! implicit coefficient
REAL :: zexpl          ! explicit coefficient
!
REAL, DIMENSION(SIZE(PT,1),SIZE(PT,2)) :: zx   ! solution
!
REAL, DIMENSION(SIZE(PT,1)) :: zei  ! internal energy of floor at t
REAL, DIMENSION(SIZE(PT,1)) :: zpei ! internal energy of floor at time t+
!
INTEGER :: ilayer          ! number of floor layers
INTEGER :: jlayer          ! loop counter
INTEGER :: jj              ! loop counter
REAL(KIND=JPRB) :: zhook_handle
!-------------------------------------------------------------------------------
IF (lhook) CALL dr_hook('LAYER_E_BUDGET',0,zhook_handle)
!
ilayer = SIZE(pt,2)
!
zimpl = pimpl
zexpl = 1.-pimpl
!
!-------------------------------------------------------------------------------
!
!*      1.    Preliminaries : internal energy of floor at the current time step
!             -----------------------------------------------------------------
!
zei(:) = 0.
DO jlayer=1,ilayer
  DO jj=1,SIZE(pt,1)
     zei(jj)=zei(jj) + ( phc(jj,jlayer)*pd(jj,jlayer)*pt(jj,jlayer) )
  ENDDO
END DO
!
!-------------------------------------------------------------------------------
!
!*     2.     Tri-diagonal system resolution
!              ------------------------------
!
 CALL tridiag_ground(pa,pb,pc,py,zx)
!
DO jlayer=1,ilayer
  pt(:,jlayer) = zx(:,jlayer)
END DO
!
!*      3.     heat storage inside floor and flux toward the floor
!              ---------------------------------------------------
!
!       3.1    internal energy of the floor at the next time step
!              --------------------------------------------------
!
zpei(:) = 0.0
DO jlayer=1,ilayer
  DO jj=1,SIZE(pt,1)
     zpei(jj) = zpei(jj)+ ( phc(jj,jlayer)*pd(jj,jlayer)*pt(jj,jlayer) )
  ENDDO
END DO
!
!        3.2   heat storage flux inside floor 
!              ------------------------------
!
pdqs(:)=(zpei(:)-zei(:))/ptstep
!
IF (lhook) CALL dr_hook('LAYER_E_BUDGET',1,zhook_handle)
!-------------------------------------------------------------------------------
END SUBROUTINE layer_e_budget