List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_FILE_TO_GRIDLIST returns a list of grid names for a MISR product file.

-Copyright

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

-I/O
   
   Given:
   
      file      MISR file
   
   the call:
   
      status = MTK_FILE_TO_GRIDLIST( file, ngrids, grid_list )
   
   returns:
   
      status     0 on success; otherwise failure
      ngrids     number of grids in file
      grid_list  string array of grid names
      
-Examples

      ;;
      ;; Set up input parameters
      ;;
      file  = '../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf'
      
      status = MTK_FILE_TO_GRIDLIST( file, ngrids, grid_list )
      
      ;;
      ;; Output...
      ;;
      print, 'file                  : ', file
      print, '================================================='
      FOR i=0,ngrids-1 DO $
         PRINT,'GRID #'+STRTRIM(i+1,2)+ $
         '               : '+grid_list[i]

   IDL outputs:
   
      file                  : ../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_CF_F03_0024.hdf
     =================================================
      GRID #1               : BlueBand
      GRID #2               : GreenBand
      GRID #3               : RedBand
      GRID #4               : NIRBand
      GRID #5               : BRF Conversion Factors
      GRID #6               : GeometricParameters

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0