List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_FILE_BLOCK_META_FIELD_LIST lists block metadata fields of a file.

-Copyright

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

-I/O
   
   Given:
   
      filename       MISR product filename
      blockmeta      Block metadata name

   the call:
   
      status = MTK_FILE_BLOCK_META_FIELD_LIST( filename, blockmeta, nfields, fieldlist )
   
   returns:
   
      status         0 on success; otherwise failure
      nfield         Number of fields in block metadata
      bfieldlist     List of fields in block metadata

-Examples

      ;;
      ;; Set up input parameters
      ;;
      filename    = '../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf'
      blockmeta   = 'PerBlockMetadataCommon'
      status      = MTK_FILE_BLOCK_META_FIELD_LIST( filename, blockmeta, nfields, fieldlist )
      
      ;;
      ;; Output...
      ;;
      print, 'Filename                     : ', filename
      print, 'Block metadata               : ', blockmeta
      print, '================================================='
      print, 'Number block metadata fields : ', nfields
      print, 'Block metadata field list    : ', fieldlist

   IDL outputs:
   
      Filename                     : ../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf
      Block metadata               : PerBlockMetadataCommon
      =================================================
      Number block metadata fields :            7
      Block metadata field list    :  Block_number Ocean_flag Block_coor_ulc_som_meter.x Block_coor_ulc_som_meter.y
                                      Block_coor_lrc_som_meter.x Block_coor_lrc_som_meter.y Data_flag

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0