List of Routines By Functionality | MISR Toolkit: Main Page
-Abstract
MTK_FILE_BLOCK_META_FIELD_READ retrieves 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
fieldname Field in block metadata
the call:
status = MTK_FILE_BLOCK_META_FIELD_READ( filename, blockmeta, field, buf )
returns:
status 0 on success; otherwise failure
buf buffer containing metadata read from fieldname
-Examples
;;
;; Set up input parameters
;;
filename = '../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf'
blockmeta = 'PerBlockMetadataCommon'
fieldname = 'Block_number'
status = MTK_FILE_BLOCK_META_FIELD_READ( filename, blockmeta, fieldname, buf )
;;
;; Output...
;;
print, 'Filename : ', filename
print, 'Block metadata : ', blockmeta
print, 'Field name : ', fieldname
print, '================================================='
print, 'Data buffer : ', reform(buf)
IDL outputs:
Filename : ../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf
Block metadata : PerBlockMetadataCommon
Field name : Block_number
=================================================
Data buffer : 1 2 3 4
5 6 7 8 9 10
11 12 13 14 15 16
17 18 19 20 21 22
23 24 25 26 27 28
29 30 31 32 33 34
35 36 37 38 39 40
41 42 43 44 45 46
47 48 49 50 51 52
53 54 55 56 57 58
59 60 61 62 63 64
65 66 67 68 69 70
71 72 73 74 75 76
77 78 79 80 81 82
83 84 85 86 87 88
89 90 91 92 93 94
95 96 97 98 99 100
101 102 103 104 105 106
107 108 109 110 111 112
113 114 115 116 117 118
119 120 121 122 123 124
125 126 127 128 129 130
131 132 133 134 135 136
137 138 139 140
-Particulars
None.
-Required Reading
For important details concerning this module's function, please refer to
the MTK routine MtkFileBlockMetaFieldRead.c.
-Version
-IDL-MTK Version 1.2.0