read_nam_pgd_dummy.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 read_nam_pgd_dummy(HPROGRAM, KDUMMY_NBR, HDUMMY_NAME, HDUMMY_AREA, &
                                      HDUMMY_ATYPE, HDUMMY_FILE, HDUMMY_FILETYPE      )  
!     ##############################################################
!
!!**** *READ_NAM_PGD_DUMMY* reads namelist NAM_DUMMY_PGD
!!
!!    PURPOSE
!!    -------
!!
!!    METHOD
!!    ------
!!   
!
!!    EXTERNAL
!!    --------
!!
!!    IMPLICIT ARGUMENTS
!!    ------------------
!!
!!    REFERENCE
!!    ---------
!!
!!    AUTHOR
!!    ------
!!
!!    V. Masson        Meteo-France
!!
!!    MODIFICATION
!!    ------------
!!
!!    Original    01/2005
!!
!----------------------------------------------------------------------------
!
!*    0.     DECLARATION
!            -----------
!
USE modi_get_luout
USE modi_open_namelist
USE modi_close_namelist
!
USE mode_pos_surf
!
!
USE yomhook   ,ONLY : lhook,   dr_hook
USE parkind1  ,ONLY : jprb
!
IMPLICIT NONE
!
!*    0.1    Declaration of arguments
!            ------------------------
!
 CHARACTER(LEN=6),                   INTENT(IN)   :: HPROGRAM     ! Type of program
INTEGER,                            INTENT(OUT)  :: KDUMMY_NBR
!                          ! number of dummy pgd fields chosen by user
 CHARACTER(LEN=20), DIMENSION(1000), INTENT(OUT)  :: HDUMMY_NAME
!                          ! name of the dummy pgd fields (for information)
 CHARACTER(LEN=3),  DIMENSION(1000), INTENT(OUT)  :: HDUMMY_AREA
!                          ! areas where dummy pgd fields are defined
!                          ! 'ALL' : everywhere
!                          ! 'SEA' : where sea exists
!                          ! 'LAN' : where land exists
!                          ! 'WAT' : where inland water exists
!                          ! 'NAT' : where natural or agricultural areas exist
!                          ! 'TWN' : where town areas exist
!                          ! 'STR' : where streets are present
!                          ! 'BLD' : where buildings are present
 CHARACTER(LEN=3),  DIMENSION(1000), INTENT(OUT)  :: HDUMMY_ATYPE    ! avg type for dummy pgd fields
!                                                                   ! 'ARI' , 'INV'
 CHARACTER(LEN=28), DIMENSION(1000), INTENT(OUT)  :: HDUMMY_FILE     ! data files
 CHARACTER(LEN=6),  DIMENSION(1000), INTENT(OUT)  :: HDUMMY_FILETYPE ! type of these files
!
!
!*    0.2    Declaration of local variables
!            ------------------------------
!
INTEGER                           :: ILUOUT    ! output listing logical unit
INTEGER                           :: ILUNAM    ! namelist file logical unit
LOGICAL                           :: GFOUND    ! flag when namelist is present
!
!*    0.3    Declaration of namelists
!            ------------------------
!
INTEGER                             :: NDUMMY_NBR
!                          ! number of dummy pgd fields chosen by user
 CHARACTER(LEN=20), DIMENSION(1000)  :: CDUMMY_NAME
!                          ! name of the dummy pgd fields (for information)
 CHARACTER(LEN=3),  DIMENSION(1000)  :: CDUMMY_AREA
!                          ! areas where dummy pgd fields are defined
!                          ! 'ALL' : everywhere
!                          ! 'SEA' : where sea exists
!                          ! 'LAN' : where land exists
!                          ! 'WAT' : where inland water exists
!                          ! 'NAT' : where natural or agricultural areas exist
!                          ! 'TWN' : where town areas exist
!                          ! 'STR' : where streets are present
!                          ! 'BLD' : where buildings are present
 CHARACTER(LEN=3),  DIMENSION(1000)  :: CDUMMY_ATYPE    ! avg type for dummy pgd fields
!                                                      ! 'ARI' , 'INV'
 CHARACTER(LEN=28), DIMENSION(1000)  :: CDUMMY_FILE     ! data files
 CHARACTER(LEN=6),  DIMENSION(1000)  :: CDUMMY_FILETYPE ! type of these files
REAL(KIND=JPRB) :: ZHOOK_HANDLE
!
NAMELIST/nam_dummy_pgd/ ndummy_nbr, cdummy_name, cdummy_area,       &
                          cdummy_atype, cdummy_file, cdummy_filetype  
!-------------------------------------------------------------------------------
!
!*    1.      Initializations of defaults
!             ---------------------------
!
IF (lhook) CALL dr_hook('READ_NAM_PGD_DUMMY',0,zhook_handle)
ndummy_nbr = 0
!
CDUMMY_NAME     = "                    "
CDUMMY_FILE     = "                            "
CDUMMY_FILETYPE = "      "
CDUMMY_AREA     = "ALL"
CDUMMY_ATYPE    = "ARI"
!
 CALL get_luout(hprogram,iluout)
!
!-------------------------------------------------------------------------------
!
!*    2.      Reading of namelist
!             -------------------
!
 CALL open_namelist(hprogram,ilunam)
!
 CALL posnam(ilunam,'NAM_DUMMY_PGD',gfound,iluout)
IF (gfound) READ(unit=ilunam,nml=nam_dummy_pgd)
!
 CALL close_namelist(hprogram,ilunam)
!
!-------------------------------------------------------------------------------
!
!*    3.      Fills output arguments
!             ----------------------
!
kdummy_nbr         = ndummy_nbr
hdummy_name(:)     = cdummy_name(:)
hdummy_area(:)     = cdummy_area(:)
hdummy_atype(:)    = cdummy_atype(:)
hdummy_file(:)     = cdummy_file(:)
hdummy_filetype(:) = cdummy_filetype(:)
IF (lhook) CALL dr_hook('READ_NAM_PGD_DUMMY',1,zhook_handle)
!
!-------------------------------------------------------------------------------
!
END SUBROUTINE read_nam_pgd_dummy