Index of /software/aug_eos5

[ICO]NameLast modifiedSizeDescription
[DIR]Parent Directory  -
[TXT]release.txt23-Aug-2017 13:53 487
[DIR]previous_versions/22-Aug-2017 16:09 -
[DIR]doc/05-Jul-2017 09:48 -
[DIR]bin/08-Jul-2019 11:10 -
[ ]aug_eos5_2.6_sha256sum.pdf08-Jul-2019 11:11 29K
[ ]aug_eos5_2.5_sha256sum.xlsx23-Aug-2017 13:50 10K
[ ]aug_eos5_2.5_sha256sum.pdf23-Aug-2017 13:50 182K
[ ]aug_eos5-2.6.tar.gz08-Jul-2019 11:11 1.7M
[ ]aug_eos5-2.5.tar.gz23-Aug-2017 09:59 1.7M
[ ]HDFEOS5AugToolUsersGuide.pdf02-Jun-2017 11:14 897K
[ ]HDFEOS5AugToolUsersGuide.docx02-Jun-2017 10:37 244K
[ ]Edit-HDF5-attr.pdf05-Jul-2017 09:48 231K
[ ]Edit-HDF5-attr.docx02-Jun-2017 10:37 19K
[ ]Aug-NASA-EOS5-Guide.pdf02-Jun-2017 11:14 477K
[ ]Aug-NASA-EOS5-Guide.docx02-Jun-2017 10:37 26K
*****************************************************************************
* You can find a PDF version of a comprehensive document for this tool      *
* under this directory (HDFEOS5AugToolUsersGuide.pdf) or under              *
* http://hdfeos.org/software/aug_eos5/HDFEOS5AugToolUsersGuide.pdf          *
*                                                                           *
* This readme file gives a quick guide for this tool.                       *
*                                                                           *
* The static binary utility can be found in the /bin. The source code       *
* is aug_eos5-2.5.tar.gz. It can be found under this directory.             *
*****************************************************************************


1. Introduction

This package contains a program that augments an HDF-EOS5 file so that the 
netCDF-4 library may access the augmented file by following the netCDF 
enhanced data model. This program adds HDF5 dimension scales to the HDF-EOS5
files by following the HDF5 dimension scale specification. The netCDF-4
library can then correctly obtain the dimension information of a variable. 

2. Installations

For detailed information, check section 2 of HDFEOS5AugToolUsersGuide.pdf. 

The following is a simple note on how to quickly install the package.
You need to have HDF-EOS5 and HDF5 C libraries to build the tool.

1) Use autoconf and automake
set CC to be /path/to/hdf5/bin/h5cc
. /configure --with-hdfeos5=/path/to/hdfeos5
make install

2) Use makefile.augment

Change the HDF5 and HDF-EOS5 path of makefile.augment under /src, run
make -f makefile.augment

3. Usage

For detailed information, check section 3 of HDFEOS5AugToolUsersGuide.pdf.
default option: ./aug_eos5 HDF-EOS5_file
file option:    ./aug_eos5 -f mapping_file HDF-EOS5_file
index option    ./aug_eos5 -i HDF-EOS5_file

To test with an example, follow readme under /examples.
	
4. Test

Go to the test directory, run ./test.sh
For other tests, follow the instructions at readme under /test.
 
5. Validation with netCDF-4 APIs

We provide simple validation programs in C and Fortran to verify if the 
augmented file can be accessed by netCDF-4 APIs.

Follow the instructions at readme under /validprog.

6 Tested Products

We have tested the augmentation tool against Aura HIRDLS, MLS, TES, OMI, MOPITT
and NASA MEaSUREs GSSTF products on 32-bit and 64-bit Linux, as well as  Mac.
OS 10.

7 Known Problems

The current HDF-EOS5 library(version HDF-EOS5.1.15) has a few issues that
may affect the use of the augmentation tool. We have been reporting these
issues to the HDF-EOS5 developer and hopefully these issues will be fixed
in the new HDF-EOS5 library release. In the mean time, we prefer users to
use the static utility we provided at http://hdfeos.org/software/aug_eos5.php.
The static utility is built with a modified version of the current HDF-EOS5
library that resolves those issues.

8. Limitations

Check section 4.3 of HDFEOS5AugToolUsersGuide.pdf.