Back to home page

Build and install H5hut

Quickstart for the impatient

Requirements
- autotools (libtool, automake, autoconf >= 2.60)
- C compiler supporting C99 (for example GCC >= 4.5)
- MPI for parallel version (for example openmpi)
- HDF5 >= 1.8.x
- (optional) VTK to convert triangle or tetrahedral meshes from legacy VTK format to H5hut’s mesh format
Run autotools
```
 ./autogen.sh
```
Configure
```
For the serial implementation
```
```
 ./configure
```
```
For the parallel implementation configure with
```
```
 ./configure --enable-parallel
```
- If you want to build Fortran bindings, add --enable-fortran to the configure line.
- If you use a MPI implementation which is not in one of the standard directories, specify the installation prefix with --with-mpi=MPI_PREFIX.
- If your HDF5 installation is not installed in one of the standard directories, specify the installation prefix with --with-hdf5=HDF5_PREFIX.
- The default installation prefix is /usr/local. If you want to install H5hut with another prefix, specify it with --prefix=H5HUT_PREFIX.
Build

To build H5hut run
```
make
```
Run Regression Tests (optional)

Run
```
make test
```
Install

To install H5hut, run
```
make install
```

Details for H5hut Configure and Build

Configure Options

--prefix=PREFIX: Install architecture-independent files in PREFIX. Default = /usr/local.
--exec-prefix=EPREFIX: Install architecture-dependent files in EPREFIX. Default = PREFIX.
--enable-debug: Compile with debug flags. Default = no.
--enable-c: Compile the C API. Default = yes.
--enable-fortran: Compile the Fortran API. Default = no.
--enable-parallel: Compile the MPI/IO interface. Default = no.
--with-hdf5: Path to HDF5 installation. Default = "".
--with-mpi: Path to MPI installation. Default = "".
--with-lustre: Path to Lustre user API. Default = "".

Environment Variables for Configure ==

CC: C compiler command
CFLAGS: C compiler flags
LDFLAGS: Linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir>
LIBS: Libraries to pass to the linker, e.g. -l<library>
CPPFLAGS: C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir>
CXX: C++ compiler command
CXXFLAGS: C++ compiler flags
CPP: C preprocessor
CXXCPP: C++ preprocessor
FC: Fortran compiler command
FCFLAGS: Fortran compiler flags