Help Information for eos2dump program NAME eos2dump - hdfeos2 dumper program BUILD To build eos2dump, one needs to modify the Makefile appropriately. The following library paths should be set. ZLIB_DIR=/mnt/scr1/xcao/hdf_java/lib/linux32/zlib SZIP_DIR=/mnt/scr1/xcao/hdf_java/lib/linux32/szip JPEG_DIR=/mnt/hdf/n-gupta/eos2dump/jpeg6b-linux2.4 HDF4_DIR=/mnt/hdf/n-gupta/eos2dump/hdf-4.2.5 HDFEOS2_DIR=/mnt/hdf/n-gupta/eos2dump/hdfeos/hdfeos2 With Makefile, one can build this program by issuing 'make' command. The generated binary is named eos2dump. This software has an old version which was built by configure script. Since configure script might have installation problem in some users' machines, we provide the Makefile template for this new version. SYNOPSIS ./eos2dump [OPTION] ... [HDF-EOS2 FILE NAME] ... [GRID/SWATH NAME] ... [SOM BLOCK DIMENSION] DESCRIPTION Dump information about the FILEs (the current directory by default). -o prints # of grid, swath and point objects, and file size -c calculate lon/lat values and print -a calculate adjusted lon/lat values and print them only if swath dimension maps are used -1 (valid only when -c or -a is used). print latitude data -2 (valid only when -c or -a is used). print longitude data -v (valid only when -c or -a is used). add explanatory information to the lat and lon data -m (valid only when -c or -a is used). dumps 5 data per line, default is 1. -g print grid/swath name separatedly -h print help information -d print all elements for each data fields -o just print # of grid, swath and point objects, and file size -r read the file, but does not dump to stdout -n behave like OPeNDAP HDF4 handler. The name of Adjusted geo-location fields are from its base geo-location field's name and some characters are appended to make them unique. This is simulated when -n is give. EXAMPLES: 1. Dump lat data of AIRS.2002.12.31.001.L2.CC_H.v4.0.21.0.G06100185050.hdf which contains only one swath. ./eos2dump -c1m AIRS.2002.12.31.001.L2.CC_H.v4.0.21.0.G06100185050.hdf -71.0091, -70.9504, -70.8625, -70.7595, -70.6461, -70.5277, -70.4059, -70.2819, -70.156, -70.0277, -69.8982, -69.7672, -69.6335, -69.4951, -69.3532, -69.2063, -69.0534, -68.8931, -68.7232, -68.5445, -68.3521, -68.1443, -67.9179, -67.6685, -67.3907, -67.0772, -66.7182, -66.2973, -65.8015, -65.1923, ... 2. Dump lat data of grid "BlueBand" of MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf which contains SOM projection. Specify the 20th block dimensio with explanatory information. $ ./eos2dump -vcm1 MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf BlueBand 20 HDF-EOS2 file MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf { GRID: BlueBand{ 84.2115, 84.2018, 84.192, 84.1822, 84.1724, 84.1626, 84.1528, 84.1431, 84.1333, 84.1235, 84.1137, 84.1039, 84.0941, 84.0844, 84.0746, 84.0648, 84.055, 84.0452, 84.0354, 84.0256, 84.0158, 84.0061, 83.9963, 83.9865, 83.9767, ... } } 3. Dump lat data of grid "BlueBand" of MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf which contains SOM projection. Dump all block dimensions with explanatory information. $ ./eos2dump -vcm1 MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf BlueBand all HDF-EOS2 file MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf { GRID: BlueBand{ 66.2263, 66.224, 66.2217, 66.2195, 66.2172, 66.2149, 66.2126, 66.2103, 66.2079, 66.2056, 66.2033, 66.201, 66.1987, 66.1963, 66.194, 66.1917, 66.1893, 66.187, 66.1846, 66.1823, 66.1799, 66.1776, 66.1752, 66.1729, 66.1705, ... } } 4. Dump adjusted lat data of a swath object containing dimension maps called MODIS_SWATH_Type_L1B in MYD02HKM.A2010031.0035.005.2010031183706.hdf. $ ./eos2dump -a1m MYD02HKM.A2010031.0035.005.2010031183706.hdf -61.0802, -61.0949, -61.1096, -61.1241, -61.1387, -61.1531, -61.1675, -61.1818, -61.196, -61.2102, -61.2243, -61.2383, -61.2524, -61.2663, -61.2801, -61.2939, -61.3077, -61.3213, -61.335, -61.3485, -61.3621, -61.3755, -61.3889, -61.4022, -61.4155, ... LIMITATIONS 1. The program can't handle HDF-EOS2 file which contains 'DEFAULT' values for UpperLeft and LowerRight points. The example file is CER_ES4_TRMM-PFM_Edition1_009001.199808.hdf. 2.For LAMAZ projection, the output lat and lon values both contain rather large values which should be considered as fillvalues. 3. The program can't handle HDF-EOS2 file MISR_AM1_CGAS_MAR_01_2006_SITE_INTEXB_F06_0021.hdf. It has problem when calling "GDij2ll" function. The problem might come from the HDF-EOS2 library. 4. If the HDF-EOS2 file contains swath dimension map, using option -c will read unadjusted lat and lon that the date file provides. If you want to read adjusted lat and lon, option -a should be used instead. When the unadjusted lat and lon data contains fillvalue, the adjusted lat and lon will also contain fillvalue. 5. Now the number of output data per line could be chosen as one or five for use in other softwares, like Makelab and IDL, further options should be added to let users specify their own number of output data per line. 6. When the swath dimension maps are used, the adjusted lat and lon values may fall out of valid range due to their closeness to the boundary lat/lon data provided in the date file. Here we make those unvalid values equal to the boundary points. Special cautions are needed when handling swath dimension map file. TEST FILES: AMSR_E_L3_DailyLand_V06_20050118.hdf ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/veer/MAP_DATA/files/NSIDC/AMSR/AE_Land3/AMSR_E_L3_DailyLand_V06_20050118.hdf CER_ES4_TRMM-PFM_Edition1_009001.199808.hdf ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/veer/MAP_DATA/files/CERES/CER_ES4_TRMM-PFM_Edition1_009001.199808.hdf MCD43C1.A2006353.004.2007012185705.hdf ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/veer/MAP_DATA/files/LP-DAAC/MCD/MCD43C1.A2006353.004.2007012185705.hdf MISR_LAND_P017_O036105_F06_0020_GOM_b64-72.hdf ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/veer/MAP_DATA/files/LARC/GOMACCS/MISR_LAND_P017_O036105_F06_0020_GOM_b64-72.hdf AIRS.2002.12.31.001.L2.CC_H.v4.0.21.0.G06100185050.hdf ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/veer/MAP_DATA/files/GESDISC/AIRS_Level2/AIRH2CCF.003/AIRS.2002.12.31.001.L2.CC_H.v4.0.21.0.G06100185050.hdf MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/NASAHDF/MISR_AM1_GRP_ELLIPSOID_GM_P117_O058421_BA_F03_0024.hdf MYD02HKM.A2010031.0035.005.2010031183706.hdf ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/veer/MAP_DATA/files/LAADS/MYD/MYD02HKM/2010/031/MYD02HKM.A2010031.0035.005.2010031183706.hdf