awips2/nativeLib/rary.cots.hdf5/Readme.txt
root 9f19e3f712 Initial revision of AWIPS2 11.9.0-7p5
Former-commit-id: 64fa9254b946eae7e61bbc3f513b7c3696c4f54f
2012-01-06 08:55:05 -06:00

113 lines
2.9 KiB
Text

The hdf-java product has been built and tested on:
32-bit Java 2 SDK
* Linux
* Solaris
* Mac Intel
* Windows (Vista/XP/2000)
64-bit Java 2 SDK
* Linux 64-bit
* Linux 64-bit iitanium
* Solaris 64-bit
* Mac Intel
This code will likely work on most platforms that support HDF and Java,
although the configure and Makefile may need to be adjusted.
This code does not compile on HP_UX 11, due to limitations in the HP
Java Native Interface.
Unix Build Instructions
=======================
Prerequisites:
1. HDF4 binary distribution (source is not needed)
2. HDF5 binary distribution (source is not needed)
3. Java Development Kit 1.5.x or above
4. Exterenal libraries: szip, zlib, jpeg (for HDF4 only)
Build:
1. Configure
Use the example configure file at Config/config.sh
The configure step must specify the paths to the required software and
where to install.
./configure --prefix=INSTDIR \
--with-hdf5=INC,LIB \
--with-hdf4=INC,LIB --with-jdk=INC,LIB \
--with-libjpeg=$JPEG/include,$JPEG/lib \
--with-libsz=$SZIP/include,$SZIP/lib \
--with-libz=$ZLIB/include,$ZLIB/lib \
Where
--with-hdf5=INC,LIB = path to where the HDF5 include and library are installed,
e.g., /usr/local/include,/usr/local/lib
--with-hdf4=INC,LIB = path to where the HDF4.1r5 include and library are installed,
e.g., /usr/local/include,/usr/local/lib
--with-jdk=INC,LIB = path to where the JDK1.3.1 include and library are installed,
e.g., /usr/local/jdk1.3.1/include,/usr/local/jdk1.3.1/jre/lib
--prefix=INSTDIR = where to install the HDF java products,
e.g., /work/hdf-java
For convenience, Config/config.sh is provided as an example script for configuration.
2. Build
Build with the command 'make'.
To install, use 'make install'
To generate javadocs, 'make javadocs'
Windows Build Instructions
=======================
Prerequisites:
1. HDF4 binary distribution (source is not needed)
2. HDF5 binary distribution (source is not needed)
3. Java Development Kit 1.5.x or above
4. Microsfot Visual C++
Build:
1. Build Java source code
a) configure/modify the batch file, windows/Makefile_java.bat
i) set the %JAVAHOME% in the batch file.
%JAVAHOME% is the home directory of the Java Development Kit,
such as SET JAVAHOME=d:\java\jdk1.5.0
ii) set the %HDFJAVA% in the batch file.
%HDFJAVA% is the directory of this HDF object source code,
such as SET HDFJAVA=D:\work\hdf-java
b) run batch file, windows/Makefile_java.bat
2. Build the HDF4 native C code with Microsfot Visual C++
a) modify make file, windows/jhdf.mak
b) nmake /f jhdf.mak
3. Build the HDF5 native C code with Microsfot Visual C++
a) modify make file, windows/jhdf5.mak
b) nmake /f jhdf5.mak
For More Information:
====================
http://www.hdfgroup.org/hdf-java-html
help@hdfgroup.org