📄 frmt_hdf4.html

📁 gdal库的学习文档
💻 HTML
字号:
<!-- $Id: frmt_hdf4.html 10296 2006-11-15 18:09:08Z fwarmerdam $ --><html><head><title>HDF4 --- Hierarchical Data Format Release 4 (HDF4)</title></head><body bgcolor="#ffffff"><h1>HDF4 --- Hierarchical Data Format Release 4 (HDF4)</h1>There are two HDF formats, HDF4 (4.x and previous releases) and HDF5.These formats are completely different and NOT compatible. This driverintended for HDF4 file formats importing.  NASA's Earth Observing System (EOS)maintains its own HDF modification called HDF-EOS.  This modification issuited for use with remote sensing data and fully compatible withunderlying HDF.  This driver can import HDF4-EOS files.  Currently EOS useHDF4-EOS for data storing (telemetry form `Terra' and `Aqua' satellites). Inthe future they will switch to HDF5-EOS format, which will be used fortelemetry from `Aura' satellite.<p><h2>Multiple Image Handling (Subdatasets)</h2>Hierarchical Data Format is a container for several different datasets.For data storing Scientific Datasets (SDS) used most often. SDS is amultidimensional array filled by data.  One HDF file may contain several different SDS arrays.  They may differ in size, number of dimensions and may represent data for different regions.<p>If the file contains only one SDS that appears to be an image, it may beaccessed normally, but if it contains multiple images it may be necessary toimport the file via a two step process.  The first step is to get a reportof the components images (SDS arrays) in the file using <b>gdalinfo</b>, andthen to import the desired images using gdal_translate.The <b>gdalinfo</b> utility lists all multidimensional subdatasets from the input HDF file. The name of individual images (subdatasets) are assigned to the <b>SUBDATASET_n_NAME</b> metadata item.  The description for each image isfound in the <b>SUBDATASET_n_DESC</b> metadata item.  For HDF4 images thesubdataset names will be formatted like this:<p><i>HDF4_SDS:subdataset_type:file_name:subdataset_index</i><p>where <i>subdataset_type</i> shows predefined names for some of the well known HDF datasets, <i>file_name</i> is the name of the input file, and<i>subdataset_index</i> is the index of the image to use (for internal use in GDAL).<p>On the second step you should provide this name for <b>gdalinfo</b> or<b>gdal_translate</b> for actual reading of the data.<p>For example, we want to read data from the MODIS Level 1B dataset:<p><pre>$ gdalinfo GSUB1.A2001124.0855.003.200219309451.hdfDriver: HDF4/Hierarchical Data Format Release 4Size is 512, 512Coordinate System is `'Metadata:  HDFEOSVersion=HDFEOS_V2.7  Number of Scans=204  Number of Day mode scans=204  Number of Night mode scans=0  Incomplete Scans=0</pre>...a lot of metadata output skipped...<p><pre>Subdatasets:  SUBDATASET_1_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:0  SUBDATASET_1_DESC=[408x271] Latitude (32-bit floating-point)  SUBDATASET_2_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:1  SUBDATASET_2_DESC=[408x271] Longitude (32-bit floating-point)  SUBDATASET_3_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:2  SUBDATASET_3_DESC=[12x2040x1354] EV_1KM_RefSB (16-bit unsigned integer)  SUBDATASET_4_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:3  SUBDATASET_4_DESC=[12x2040x1354] EV_1KM_RefSB_Uncert_Indexes (8-bit unsigned integer)  SUBDATASET_5_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:4  SUBDATASET_5_DESC=[408x271] Height (16-bit integer)  SUBDATASET_6_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:5  SUBDATASET_6_DESC=[408x271] SensorZenith (16-bit integer)  SUBDATASET_7_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:6  SUBDATASET_7_DESC=[408x271] SensorAzimuth (16-bit integer)  SUBDATASET_8_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:7  SUBDATASET_8_DESC=[408x271] Range (16-bit unsigned integer)  SUBDATASET_9_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:8  SUBDATASET_9_DESC=[408x271] SolarZenith (16-bit integer)  SUBDATASET_10_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:9  SUBDATASET_10_DESC=[408x271] SolarAzimuth (16-bit integer)  SUBDATASET_11_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:10  SUBDATASET_11_DESC=[408x271] gflags (8-bit unsigned integer)  SUBDATASET_12_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:12  SUBDATASET_12_DESC=[16x10] Noise in Thermal Detectors (8-bit unsigned integer)  SUBDATASET_13_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:13  SUBDATASET_13_DESC=[16x10] Change in relative responses of thermal detectors (8-bit unsigned integer)  SUBDATASET_14_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:14  SUBDATASET_14_DESC=[204x16x10] DC Restore Change for Thermal Bands (8-bit integer)  SUBDATASET_15_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:15  SUBDATASET_15_DESC=[204x2x40] DC Restore Change for Reflective 250m Bands (8-bit integer)  SUBDATASET_16_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:16  SUBDATASET_16_DESC=[204x5x20] DC Restore Change for Reflective 500m Bands (8-bit integer)  SUBDATASET_17_NAME=HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:17  SUBDATASET_17_DESC=[204x15x10] DC Restore Change for Reflective 1km Bands (8-bit integer)Corner Coordinates:Upper Left  (    0.0,    0.0)Lower Left  (    0.0,  512.0)Upper Right (  512.0,    0.0)Lower Right (  512.0,  512.0)Center      (  256.0,  256.0)</pre>Now select one of the subdatasets, described as<tt>[12x2040x1354] EV_1KM_RefSB (16-bit unsigned integer)</tt>:<p><pre>$ gdalinfo HDF4_SDS:MODIS_L1B:GSUB1.A2001124.0855.003.200219309451.hdf:2Driver: HDF4Image/HDF4 Internal DatasetSize is 1354, 2040Coordinate System is `'Metadata:  long_name=Earth View 1KM Reflective Solar Bands Scaled Integers</pre>...metadata skipped...<p><pre>Corner Coordinates:Upper Left  (    0.0,    0.0)Lower Left  (    0.0, 2040.0)Upper Right ( 1354.0,    0.0)Lower Right ( 1354.0, 2040.0)Center      (  677.0, 1020.0)Band 1 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 2 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 3 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 4 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 5 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 6 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 7 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 8 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 9 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 10 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 11 Block=1354x2040 Type=UInt16, ColorInterp=UndefinedBand 12 Block=1354x2040 Type=UInt16, ColorInterp=Undefined</pre>Or you may use <b>gdal_translate</b> for reading image bands from thisdataset.<p>Note that you should provide exactly the contents of the line marked <b>SUBDATASET_n_NAME</b> to GDAL, including the <b>HDF4_SDS:</b> prefix.<p>This driver is intended only for importing remote sensing and geospatial datasets in form of raster images. If you want explore all data contained in HDF file you should use another tools (you can find information about different HDF tools using links at end of this page).<h2>Georeference</h2>There is no universal way of storing georeferencing in HDF files.  However,some product types have mechanisms for saving georeferencing, and some ofthese are supported by GDAL.  Currently supported are (<i>subdataset_type</i>shown in parenthesis):<p><ul>	<li> HDF4 files created by GDAL (<B>GDAL_HDF4</B>)		<li> ASTER Level 1A (<B>ASTER_L1A</B>)		<li> ASTER Level 1B (<B>ASTER_L1B</B>)		<li> ASTER Level 2 (<B>ASTER_L2</B>)		<li> ASTER DEM (<B>AST14DEM</B>)	<li> MODIS Level 1B Earth View products (<B>MODIS_L1B</B>)	<li> MODIS Level 3 products (<B>MODIS_L3</B>)	<li> SeaWiFS Level 3 Standard Mapped Image Products (<B>SEAWIFS_L3</B>)</ul><h2>Creation Issues</h2>This driver supports creation of the HDF4 Scientific Datasets. You may createset of 2D datasets (one per each input band) or single 3D dataset where the thirddimension represents band numbers. All metadata and band descriptions fromthe input dataset are stored as HDF4 attributes. Projection information (if itexists) and affine transformation coefficients also stored in form of attributes.Files, created by GDAL have the special attribute:<p>"Signature=Created with GDAL (http://www.remotesensing.org/gdal/)"<p>and are automatically recognised when read, so the projection info andtransformation matrix restored back.<p>Creation Options:<p><ul>	<li> <b>RANK=n</b>: Create <b>n</b>-dimensional SDS. Currently only 2D	and 3D datasets supported. By default a 3-dimensional dataset will be	created.<p>	<!--li> <b>COMPRESS=[RLE/HUFFMAN/DEFLATE/NONE]</b>: Set the compression	to use. <b>RLE</b> is Run-length encoding, <b>HUFFMAN</b> is adaptive	Huffman, <b>DEFLATE</b> is GZIP "deflation" (Lempel/Ziv-77 dictionary	coder). <b>NONE</b> is the default.<p-->	</ul><h2>Metadata</h2>All HDF4 attributes are transparently translated as GDAL metadata. In the HDF file attributes may be assigned assigned to the whole file as well as to particular subdatasets.<h2>Driver building</h2>This driver builded on top of NCSA HDF library, so you need one to compileGDAL with HDF4 support. You may search your operating system distribution forthe precompiled binaries or download source code or binaries from the NCSA HDFHome Page (see links below).<p>Please note, that NCSA HDF library compiled with several defaults which isdefined in <i>hlimits.h</i> file. For example, <i>hlimits.h</i> definesthe maximum number of opened files:<pre>#   define MAX_FILE   32</pre>If you need open more HDF4 files simultaneously you should change this valueand rebuild HDF4 library (and relink GDAL if using static HDF libraries).<p><h2>See Also:</h2><ul><li> Implemented as <tt>gdal/frmts/hdf4/hdf4dataset.cpp</tt>and <tt>gdal/frmts/hdf4/hdf4imagedataset.cpp</tt>.<p><li> <a href="http://www.hdfgroup.org/">The HDF Group</a><p><li> Sources of the data in HDF4 and HDF4-EOS formats: <p><a href="http://edcimswww.cr.usgs.gov/pub/imswelcome/">Earth Observing System Data Gateway</a></ul>Documentation to individual products, supported by this driver:<p><ul><li> <a href="http://edcdaac.usgs.gov/aster/ASTER_GeoRef_FINAL.pdf">Geo-Referencing ASTER L1B Data</a><li> <a href="http://asterweb.jpl.nasa.gov/documents/ASTERHigherLevelUserGuideVer2May01.pdf">ASTER Standard Data Product Specifications Document</a><li> <a href="http://www.mcst.ssai.biz/mcstweb/L1B/product.html">MODIS Level 1B Product Information and Status</a><li> <a href="http://modis-ocean.gsfc.nasa.gov/userguide.html">MODIS Ocean User's Guide</a></ul></body></html>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -