snow_heat_to_t_wliq.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.
!      ########################
MODULE modi_snow_heat_to_t_wliq
!      ########################
!
INTERFACE snow_heat_to_t_wliq
!
SUBROUTINE snow_heat_to_t_wliq_1d(PHEAT,PRHO,PT,PWLIQ)
REAL, DIMENSION(:), INTENT(IN)           :: pheat  ! snow heat density        (J/m3)
REAL, DIMENSION(:), INTENT(IN)           :: prho   ! snow density             (kg/m3)
REAL, DIMENSION(:), INTENT(OUT)          :: pt     ! snow temperature profile (K)
REAL, DIMENSION(:), INTENT(OUT), OPTIONAL:: pwliq  ! liquid water profile     (kg/m3)
END SUBROUTINE snow_heat_to_t_wliq_1d
!
SUBROUTINE snow_heat_to_t_wliq_2d(PHEAT,PRHO,PT,PWLIQ)
REAL, DIMENSION(:,:), INTENT(IN)           :: pheat  ! snow heat density        (J/m3)
REAL, DIMENSION(:,:), INTENT(IN)           :: prho   ! snow density             (kg/m3)
REAL, DIMENSION(:,:), INTENT(OUT)          :: pt     ! snow temperature profile (K)
REAL, DIMENSION(:,:), INTENT(OUT), OPTIONAL:: pwliq  ! liquid water profile     (kg/m3)
END SUBROUTINE snow_heat_to_t_wliq_2d
!
SUBROUTINE snow_heat_to_t_wliq_3d(PHEAT,PRHO,PT,PWLIQ)
REAL, DIMENSION(:,:,:), INTENT(IN)           :: pheat  ! snow heat density        (J/m3)
REAL, DIMENSION(:,:,:), INTENT(IN)           :: prho   ! snow density             (kg/m3)
REAL, DIMENSION(:,:,:), INTENT(OUT)          :: pt     ! snow temperature profile (K)
REAL, DIMENSION(:,:,:), INTENT(OUT), OPTIONAL:: pwliq  ! liquid water profile     (kg/m3)
END SUBROUTINE snow_heat_to_t_wliq_3d
!
END INTERFACE
!
END MODULE modi_snow_heat_to_t_wliq
!
!          ###########################################
SUBROUTINE snow_heat_to_t_wliq_1d(PHEAT,PRHO,PT,PWLIQ)
!          ###########################################
!
USE modd_surf_par,   ONLY : xundef
USE modd_csts,       ONLY : xtt, xlmtt
USE mode_snow3l
!
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!
!
!*      0.1    declarations of arguments
!
REAL, DIMENSION(:), INTENT(IN)           :: pheat  ! snow heat density        (J/m3)
REAL, DIMENSION(:), INTENT(IN)           :: prho   ! snow density             (kg/m3)
REAL, DIMENSION(:), INTENT(OUT)          :: pt     ! snow temperature profile (K)
REAL, DIMENSION(:), INTENT(OUT), OPTIONAL:: pwliq  ! liquid water profile     (kg/m3)
REAL(KIND=JPRB) :: zhook_handle
!
!
!*      0.2    declarations of local variables
!
!---------------------------------------------------------------------------
!
IF (lhook) CALL dr_hook('MODI_SNOW_HEAT_TO_T_WLIQ:SNOW_HEAT_TO_T_WLIQ_1D',0,zhook_handle)
pt = xundef
IF (present(pwliq)) pwliq = xundef
!
!* temperature from heat
!
WHERE(prho/=xundef) pt = xtt + (pheat + xlmtt*prho) / snow3lscap(prho)
!
!* effect of liquid water
!
IF (present(pwliq)) THEN
  WHERE(prho/=xundef) pwliq = (pt-xtt) * snow3lscap(prho) / xlmtt
END IF
!
!* physical limits
!
IF (present(pwliq)) THEN
  pt = min(xtt,pt)
  pwliq = max(0.,pwliq)
  pwliq = min(snow3lwliqmax(prho),pwliq)
END IF
IF (lhook) CALL dr_hook('MODI_SNOW_HEAT_TO_T_WLIQ:SNOW_HEAT_TO_T_WLIQ_1D',1,zhook_handle)
!
!---------------------------------------------------------------------------
!
END SUBROUTINE snow_heat_to_t_wliq_1d
!
!          ###########################################
SUBROUTINE snow_heat_to_t_wliq_2d(PHEAT,PRHO,PT,PWLIQ)
!          ###########################################
!
USE modd_surf_par,   ONLY : xundef
USE modd_csts,       ONLY : xtt, xlmtt
USE mode_snow3l
!
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!
!
!*      0.1    declarations of arguments
!
REAL, DIMENSION(:,:), INTENT(IN)           :: pheat  ! snow heat density        (J/m3)
REAL, DIMENSION(:,:), INTENT(IN)           :: prho   ! snow density             (kg/m3)
REAL, DIMENSION(:,:), INTENT(OUT)          :: pt     ! snow temperature profile (K)
REAL, DIMENSION(:,:), INTENT(OUT), OPTIONAL:: pwliq  ! liquid water profile     (kg/m3)
REAL(KIND=JPRB) :: zhook_handle
!
!
!*      0.2    declarations of local variables
!
!---------------------------------------------------------------------------
!
IF (lhook) CALL dr_hook('MODI_SNOW_HEAT_TO_T_WLIQ:SNOW_HEAT_TO_T_WLIQ_2D',0,zhook_handle)
pt = xundef
IF (present(pwliq)) pwliq = xundef
!
!* temperature from heat
!
WHERE(prho/=xundef) pt = xtt + (pheat + xlmtt*prho) / snow3lscap(prho)
!
!* effect of liquid water
!
IF (present(pwliq)) THEN
  WHERE(prho/=xundef) pwliq = (pt-xtt) * snow3lscap(prho) / xlmtt
END IF
!
!* physical limits
!
IF (present(pwliq)) THEN
  pt = min(xtt,pt)
  pwliq = max(0.,pwliq)
  pwliq = min(snow3lwliqmax(prho),pwliq)
END IF
IF (lhook) CALL dr_hook('MODI_SNOW_HEAT_TO_T_WLIQ:SNOW_HEAT_TO_T_WLIQ_2D',1,zhook_handle)
!
!---------------------------------------------------------------------------
!
END SUBROUTINE snow_heat_to_t_wliq_2d
!
!          ###########################################
SUBROUTINE snow_heat_to_t_wliq_3d(PHEAT,PRHO,PT,PWLIQ)
!          ###########################################
!
USE modd_surf_par,   ONLY : xundef
USE modd_csts,       ONLY : xtt, xlmtt
USE mode_snow3l
!
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!
!
!*      0.1    declarations of arguments
!
REAL, DIMENSION(:,:,:), INTENT(IN)           :: pheat  ! snow heat density        (J/m3)
REAL, DIMENSION(:,:,:), INTENT(IN)           :: prho   ! snow density             (kg/m3)
REAL, DIMENSION(:,:,:), INTENT(OUT)          :: pt     ! snow temperature profile (K)
REAL, DIMENSION(:,:,:), INTENT(OUT), OPTIONAL:: pwliq  ! liquid water profile     (kg/m3)
REAL(KIND=JPRB) :: zhook_handle
!
!
!*      0.2    declarations of local variables
!
!---------------------------------------------------------------------------
!
IF (lhook) CALL dr_hook('MODI_SNOW_HEAT_TO_T_WLIQ:SNOW_HEAT_TO_T_WLIQ_3D',0,zhook_handle)
pt = xundef
IF (present(pwliq)) pwliq = xundef
!
!* temperature from heat
!
WHERE(prho/=xundef) pt = xtt + (pheat + xlmtt*prho) / snow3lscap(prho)
!
!* effect of liquid water
!
IF (present(pwliq)) THEN
  WHERE(prho/=xundef) pwliq = (pt-xtt) * snow3lscap(prho) / xlmtt
END IF
!
!* physical limits
!
IF (present(pwliq)) THEN
  pt = min(xtt,pt)
  pwliq = max(0.,pwliq)
  pwliq = min(snow3lwliqmax(prho),pwliq)
END IF
IF (lhook) CALL dr_hook('MODI_SNOW_HEAT_TO_T_WLIQ:SNOW_HEAT_TO_T_WLIQ_3D',1,zhook_handle)
!
!---------------------------------------------------------------------------
!
END SUBROUTINE snow_heat_to_t_wliq_3d