average1_cti.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 average1_cti(KLUOUT,KNBLINES,PLAT,PLON,PVALUE,PNODATA)
!     ################################################
!
!!**** *AVERAGE1_CTI* computes the sum of cti, squared cti
!!                    and subgrid cti characteristics
!!
!!    PURPOSE
!!    -------
!!
!!    METHOD
!!    ------
!!   
!!    EXTERNAL
!!    --------
!!
!!    IMPLICIT ARGUMENTS
!!    ------------------
!!
!!
!!    REFERENCE
!!    ---------
!!
!!    AUTHOR
!!    ------
!!
!!    B. Decharme         Meteo-France
!!
!!    MODIFICATION
!!    ------------
!!
!!    Original    06/2009
!!
!----------------------------------------------------------------------------
!
!*    0.     DECLARATION
!            -----------
!
USE modd_pgdwork,       ONLY : xsumval, xsumval2, xsumval3, nsize, &
                                  xmax_work, xmin_work   
!
USE modi_get_mesh_index
USE modd_point_overlay
!!
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!*    0.1    Declaration of arguments
!            ------------------------
!
INTEGER,                 INTENT(IN)    :: kluout
INTEGER,                 INTENT(IN)    :: knblines
REAL, DIMENSION(:),      INTENT(IN)    :: plat    ! latitude of the point to add
REAL, DIMENSION(:),      INTENT(IN)    :: plon    ! longitude of the point to add
REAL, DIMENSION(:),      INTENT(IN)    :: pvalue  ! value of the point to add
REAL, OPTIONAL, INTENT(IN) :: pnodata
!
!*    0.2    Declaration of other local variables
!            ------------------------------------
!
INTEGER, DIMENSION(NOVMX,SIZE(PLAT)) :: iindex ! mesh index of all input points
                                         ! 0 indicates the point is out of the domain
!
REAL, DIMENSION(SIZE(PLAT)) :: zvalue
REAL :: znodata
!
INTEGER :: jloop, jover        ! loop index on input arrays
REAL(KIND=JPRB) :: zhook_handle
!----------------------------------------------------------------------------
!
!
!*    1.     Get position
!            ------------
! 
IF (lhook) CALL dr_hook('AVERAGE1_CTI',0,zhook_handle)
!
IF (present(pnodata)) THEN
  zvalue(:) = pvalue(:)
  znodata = pnodata
  CALL get_mesh_index(kluout,knblines,plat,plon,iindex,zvalue,znodata)
ELSE
  zvalue(:) = 1.
  znodata = 0.
  CALL get_mesh_index(kluout,knblines,plat,plon,iindex)
ENDIF
!
!*    2.     Loop on all input data points
!            -----------------------------
!     
bloop: &
DO jloop = 1 , SIZE(plat)
!
  DO jover = 1, novmx
!
!*    3.     Tests on position
!            -----------------
!
    IF (iindex(jover,jloop)==0) cycle bloop
!
!*    4.     Summation
!            ---------
!
    nsize(iindex(jover,jloop))=nsize(iindex(jover,jloop))+1
!
!*    5.     CTI
!            ---
!
    xsumval(iindex(jover,jloop))=xsumval(iindex(jover,jloop))+pvalue(jloop)
!
!*    6.     Square of CTI
!            -------------
!
    xsumval2(iindex(jover,jloop))=xsumval2(iindex(jover,jloop))+pvalue(jloop)**2
!
!
!*    7.     Cube of CTI
!            -------------
!
    xsumval3(iindex(jover,jloop))=xsumval3(iindex(jover,jloop))+pvalue(jloop)**3
!
!
!*    8.     Maximum CTI in the mesh
!            -----------------------
!
    xmax_work(iindex(jover,jloop))=max(xmax_work(iindex(jover,jloop)),pvalue(jloop))
!
!
!*    9.     Minimum CTI in the mesh
!            -----------------------
!
    xmin_work(iindex(jover,jloop))=min(xmin_work(iindex(jover,jloop)),pvalue(jloop))
!
!
  ENDDO
!  
ENDDO bloop
!
IF (lhook) CALL dr_hook('AVERAGE1_CTI',1,zhook_handle)
!
!-------------------------------------------------------------------------------
!
END SUBROUTINE average1_cti