The HDF-EOS 4/5 Compatibility Layer is a library that provides a unified API for both HDF-EOS2 and HDF-EOS5 files. This allows developers to conveniently write HDF-EOS applications that handles both HDF-EOS2 and HDF-EOS5 files. This library does not cover all API sets; only grid and swath APIs are covered.
Since this library is a wrapper of the HDF-EOS2 library and the HDF-EOS5 library, both libraries are required. The HDF4 library and the HDF5 library that both HDF-EOS libraries are built on are also required.
Makefile
needs to be modified to set paths to
HDF4
,
HDF5
, HDF-EOS2 and HDF-EOS5.
If the HDF5 library is 1.8 or higher,
-DH5_USE_16_API
needs to be added to
.c.o
suffix rule.
This package includes README
file, and this document explains how to use this library.
When this library detects the format of the given HDF-EOS file, this library first
uses the HDF-EOS5 API to open the file as if the given file is an HDF-EOS5 file. If an HDF-EOS2 file is given,
an error message is generated. However, the application should not treat this error message as an "error".
By checking if an error message is generated, The library will figure out if the file is an HDF-EOS5 file or
an HDF-EOS2 file.
This library is required to build the hdfeos-netcdf conversion tool. The HDF Group has verified that the HE2NetCDF conversion tool can be successfully built with this library. But no further tests have been examined. Users should use this library in caution.