awips2/nativeLib/rary.cots.hdf5
Matt Nash 21d2361f00 Moving 12.1.1 into ss_sync
Former-commit-id: 66be3bec40 [formerly 66be3bec40 [formerly 2a9569942c48542cf708b6c0b9189146fd954c11]]
Former-commit-id: c83e5ff474
Former-commit-id: 1faae42484
2012-01-19 11:53:12 -06:00
..
bin Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
Config Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
docs Moving 12.1.1 into ss_sync 2012-01-19 11:53:12 -06:00
examples Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
ext Moving 12.1.1 into ss_sync 2012-01-19 11:53:12 -06:00
lib Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
native Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
ncsa/hdf Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
samples Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
test Moving 12.1.1 into ss_sync 2012-01-19 11:53:12 -06:00
windows Moving 12.1.1 into ss_sync 2012-01-19 11:53:12 -06:00
config.log Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
config.status Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
configure Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
configure.in Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
COPYING Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
Makefile Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
Makefile.in Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
Readme.txt Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
runconfig-example.sh Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00
VERSION Initial revision of AWIPS2 11.9.0-7p5 2012-01-06 08:55:05 -06:00

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