List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_FILE_GRID_FIELD_CHECK returns MTK_SUCCESS (0) if the specified filename, gridname, and fieldname are valid.
   Use MTK_ERROR_MESSAGE() to report the particular problem.

-Copyright

   Copyright (2005), California Institute of Technology.
   U.S. Government sponsorship acknowledged.

-I/O
   
   Given:
   
      filename       MISR product file
      gridname       grid name for file
      fieldname      field name for grid

   the call:
   
      status = MTK_FILE_GRID_FIELD_CHECK( filename, gridname, fieldname)
   
   returns:
   
      status         0 when file/grid/field are valid; invalid otherwise (see MTK_ERROR_MESSAGE())

-Examples

      ;;
      ;; Set up input parameters
      ;;
      file        = '../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf'
      grid        = 'RedBand'
      field       = 'Red Radiance/RDQI'
      field2      = 'Red Radiance/RDQI[10]'
      status      = MTK_FILE_GRID_FIELD_CHECK(file, grid, field )
      status2     = MTK_FILE_GRID_FIELD_CHECK(file, grid, field2 )

      ;;
      ;; Output...
      ;;
      print, 'file                  : ', file
      print, 'grid                  : ', grid
      print, 'field                 : ', field
      print, 'field2                : ', field2
      print, '================================================='
      print, field, ' validity      : ', mtk_error_message(status)
      print, field2, ' validity     : ', mtk_error_message(status2)

   IDL outputs:
   
       file                  : ../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf
       grid                  : RedBand
       field                 : Red Radiance/RDQI
       =================================================
       valid?                : SUCCESS

-Particulars
   None.

-Required Reading
   For important details concerning this module's function, please refer to
   the MTK routine MtkFileGridFieldCheck.c.

-Version
   -IDL-MTK Version 1.2.0