hdf images hdf images

This web site is no longer maintained (but will remain online).
Please see The HDF Group's new Support Portal for the latest information.

HDF5 Known Problems

Problems Reported as of HDF5 1.8.17

The HDF5 compile scripts (h5cc, h5fc, h5c++, h5pcc, and h5pfc) contained a syntax error when using the options:

  -o <output> -c <source>

The <output> gets dropped, producing "-c -o <source>" which resulted in a compiler error.

If the options are switched there is no error:

   -c <source> -o <output> 

This problem will be fixed in a future release.

Problems Reported as of HDF5 1.8.12

SELECTED_REAL_KIND gives a different result at compile and at run-time

HDF5 currently does not compile with gfortran 4.5 and earlier (on my MacOS X 10.8 installation). This is because in the file,


the call to SELECTED_REAL_KIND gives a different result at compile and at run-time. When running the H5test_kind_SIZEOF program,


gives 16 when i=20, but if one simply writes


and compiles it, the result is -1. Because the call uses (i) at run-time, it succeeds, which makes the HDF5 installer believe that the compiler supports KIND=16, so the H5fortran_detect file contains a KIND=16 case. However, this then fails because the compiler does not *really* support it.

ANSWER: There is a mismatch of the LD_LIBRARY_PATH and the gcc version used to compile the code. See: gnu bug 48404

Problems Reported as of HDF5 1.8.9

On Mac OS X 10.8 (Mountain Lion), HDFView fails to install with an error that the file is damaged and can't be opened

When you run the HDFView installer on Mac Mountain Lion, you may get an error message indicating that the software is damaged and needs to be moved to the trash. The error message is because of the Mac OS X 10.8 GateKeeper that defaults to only running applications that are code-signed. Please use this workaround if you encounter the problem:

We are working on a long-term solution for the problem.

HDF5 Installation Fails using CMake on Linux

The HDF5-1.8.9 installation fails using CMake on Linux. This is due to a misnamed file. (In the top level CMakeLists.txt file the capitalization of a file name does NOT match what is on the file system. It should be "USING_CMake.txt" instead of "Using_CMake.txt".)

To correct this issue please apply the cmake_patch.txt patch in the top directory of the HDF5-1.8.9 source code.

Problems Reported as of HDF5 1.8.8

The h5cc script always uses the static libraries not the shared

The h5cc "script" correctly forms the build options and executes, however, it is using *.a file endings for all of the libraries instead of *.so. If the library was built with --disable-static, there are no static libraries, so h5cc will not find them by default (see workaround below).

The h5cc script checks the environment variable HDF5_USE_SHLIB, and if it is set assigns its value to a variable USE_SHARED_LIB. If USE_SHARED_LIB is not "yes", then h5cc will substitute libhdf5.a for -lhdf5 and /libhdf5_hl.a for -lhdf5_hl.

There are also h5cc command arguments -shlib and -noshlib that will have the same effect as setting the environment variable. For example: h5cc -shlib prog.c

Mac OS X 10.5 support dropped as as of HDF-Java 2.8

As of HDF-Java version 2.8, Mac OS X 10.5 is no longer supported. HDF-Java version 2.7 will work with Mac OS X 10.5, and is still available for use.

Conversion Tests Fail on Ubuntu 11.10 with gcc 4.6.1

The data conversion test dt_arith.c fails in "long double" to integer conversion on Ubuntu 11.10 ( kernal) with GCC 4.6.1 if the library is built with optimization -O3 or -O2. The older GCC (4.5) or newer kernal (3.2.2 on Fedora) does not have the problem. Users should lower the optimization level (-O1 or -O0) by defining CFLAGS in the command line of "configure" like:

      CFLAGS=-O1 ./configure

It will overwrite the library's default optimization level.

Problems Reported as of HDF5 1.8.7

Cannot Read a Variable Length String Attribute with Fortran (F90)

Prior to HDF5-1.8.8, reading and writing of variable length string attributes was not supported in Fortran. Fortran 2003 support was added in HDF5-1.8.8, which enabled this to be supported. For an example of reading a variable length string attribute in Fortran with Fortran 2003, see: vlenatt_F03.f90

Conversion Tests fail on Mac OS X 10.7 and 10.8

Users have reported that when building HDF5, the conversion tests failed (make check) in dt_arith.chk. Users should lower the optimization level to -O0 (oh zero), by adding it to CFLAGS prior to calling configure. For example:

      CFLAGS=-O0 ./configure ...

Problems Reported in HDF5 1.8.6

HDFView: Unsupported fileformat error opening an HDF/HDF5 file on Mac OS X

If you are on Mac OS X and attempt to open an HDF/HDF5 file in HDFView 2.7, and it fails with this error,

  HDF file :"Failed to open file xxx.hdf java.io.IOException: Unsupported fileformat - xxx.hdf"
then you may be running the wrong version of HDFView for your system.

If you get this error with the 64-bit version of HDFView, then try the 32-bit version. If you get this error for the 32-bit version, then try the 64-bit version. See the HDFView Home page to obtain the 32-bit or 64-bit version of HDFView for Mac OS X.

Problem Reading A Collectively Written Dataset In Parallel

While working on the 1.8.6 release of HDF5, a bug was discovered that can occur when reading from a dataset in parallel shortly after it has been written to collectively. The issue was exposed by a new test in the parallel HDF5 test suite, but had existed before that. We believe the problem lies with certain MPI implementations and/or filesystems.

We have provided a pure MPI test program, as well as a standalone HDF5 program, that can be used to determine if this is an issue on your system. They should be run across multiple nodes with a varying number of processes. These programs can be found at:


Although it does not affect the above issue, this is a good time to point out that the HDF5 library does not make any attempt to guarantee sequential consistency of MPI I/O calls. It is the application's responsibility to enforce sequential consistency as needed, as described in section 13.6.1 of the MPI Standard. If sequential consistency is needed, the application should close the file, issue an MPI_Barrier(), then reopen the file before and after each collective write.

It is also possible to guarantee sequential consistency using MPI_File_set_atomicity(), however there is currently no way to do this within HDF5. We are planning to add an API function to allow users to set the atomicity in a future release.

HDF5 1.8.5 Problem Affecting Files with Non-default Addresses

A problem was discovered in HDF5 1.8.5 that affects files with non-default sizes of addresses and lengths as set by H5Pset_sizes(). The problem occurs when (sizeof_addr + 2*sizeof_size) is not a multiple of 8, unless using the new file format (H5Pset_libver_bounds()). Files created under these conditions by 1.8.5 will be readable by 1.8.5 but not by any other version of HDF5. Files created under these conditions by other versions of HDF5 will not be readable by 1.8.5.

We recommend that those who use H5Pset_sizes or may deal with files that use this feature move to the latest snapshot (snap4) of HDF5 1.8.5. If you have files created by 1.8.5 under these conditions that you wish to keep, you can fix this problem by using "h5repack -L" with the 1.8.5 version of h5repack to recreate the file with the new file format. You can then read this file with any version since 1.8.0, and if desired use h5repack (without -L) again to move back to the old file format.

Please see the HDF Downloads page for obtaining HDF5 releases and snapshots.

HDFView 2.6.1 Problem on Some Windows XP Machines

HDFView 2.6.1 works properly on most Windows XP machines. However, on others, HDF5 is greyed out under the Help menu, and HDF5 is not supported. This occurs if a required package is missing on that machine. A user reported that .NET 3.5 Service Pack 1 is the missing package. This can be obtained from here:


HDFView 2.6.1 Does Not Display the User's Guide on Macintosh

On the Macintosh, you cannot access the User's Guide in HDFView 2.6.1 by either selecting it under the Help menu bar or clicking on the small book icon. The workaround is to access the on-line version for now. This is located here:


In HDFView, you can select the Tools -> User Options pull-down menu item, to modify the path to the User's Guide to point to the on-line version. This will work while HDFView is running, but once it is closed, this information will be lost.

Corruption Problem In HDF5 1.8.0 through HDF5 1.8.4

A corruption problem was found in the HDF5 1.8 release, which affects versions 1.8.0 through 1.8.4. The problem has been fixed in HDF5 1.8.4 Patch 1.

What Causes The Problem

Files that have this corruption problem meet all of the following circumstances:

If your data matches these criteria, then you may have generated files that have incorrectly encoded IDs for attributes and shared object header messages.

How To Determine If Your Files Are Corrupted

There is no foolproof way to detect a file with these IDs incorrectly encoded, but if the h5dump tool reports an error message similar to the following when displaying information about the file, it is likely that you have a file with this problem:

      h5dump error: error getting attribute information

For files created with netCDF-4, this message will generally display when dumping information about the root group. If your application is generating an error stack similar to this, it is also likely that the file has this problem:

       #008: ../../hdf5_v1.8/src/H5B2int.c line 1951 in H5B2_iterate_node():
   iterator function failed major: B-Tree node minor: Unable to list node
       #009: ../../hdf5_v1.8/src/H5Adense.c line 1076 in
   H5A_dense_iterate_bt2_cb(): heap op callback failed major: Attribute minor:
   Can't operate on object
       #010: ../../hdf5_v1.8/src/H5HF.c line 680 in H5HF_op(): can't operate on
   object from fractal heap major: Heap minor: Can't operate on object
       #011: ../../hdf5_v1.8/src/H5HFman.c line 462 in H5HF_man_op(): unable to
   operate on heap object major: Heap minor: Can't operate on object
       #012: ../../hdf5_v1.8/src/H5HFman.c line 276 in H5HF_man_op_real():
   fractal heap object offset too large major: Heap minor: Out of range

Fixing The Problem

A tool is being developed that can be run on a corrupted file to correct it.

Please contact the HDF Helpdesk if you are unable to wait for this tool.

Problems Reported in HDF5 1.8.3

HDF5-1.8.3 and HDFView 2.5 always modify an HDF5 file opened in read/write mode

HDF5-1.8.3 and HDFView 2.5 always re-wrote the superblock of an HDF5 file with a later version of the superblock if the file was opened for read-write access. Therefore an HDF5 file would inadvertently be upgraded to a later version of the file format. This issue was fixed in HDF5-1.8.4.

CFLAGS Getting Overwritten by HDF5

A user should be able to set CFLAGS and have those options be used to build HDF5. However, HDF5 sets CFLAGS in the Makefiles when it should not, so a user cannot do this. We are planning on fixing this for the HDF5 1.8.4 release.

Problems Reported in HDF5 1.8.2

The dt_arith conversion test fails with gcc

Optimization does not handle conversion well with gcc 3.* and 4.*.

To get around the problem, turn off optimization. You can do this by editting the ./config/gnu-flags file in the HDF5 source code and setting PROD_CFLAGS from "-O" to "-O0".

Here is the code that needs to be modified:

        # The optimization level is reduced for gcc 3.* and 4.* due to problems
        # with code generation for src/H5Tconv.c with the -O2 & -O3
        # optimization levels (which shows up as failures for various integer
        # types -> long long conversions in the test/dtypes test).  Perhaps
        # later versions of gcc will fix this bug... - QAK - 2003/10/20

HDFView: Dataset Displayed Incorrectly When Viewed As Image

With HDFView 2.5, a dataset that is not an image gets displayed incorrectly when viewed as an image. This does not occur if the dataset is an image to begin with. If you select "Open As" and choose to view a dataset as an image, the resulting image displayed will not have a smooth color scale, and it may look like the palette is recycled midway through.

A patch is available for HDFView to correct this problem. You can download the jar files containing the fix to the problem. Only the jhdfview.jar file is strictly necessary to correct this problem. See the README for other problems fixed with these jar files.

High Level Packet Table APIs and Variable Length Datatypes

Variable length Packet Tables are not supported. There are no tests or examples for using variable length fields in Packet Tables. Please use the HDF5 APIs to work with Variable Length datatypes.

The Linux 32-bit version of HDF-Java 2.5 fails on a Linux 64-bit machine

This problem is known to occur on a machine with gcc 3.4 on it, but may also occur with other versions of gcc. HDF-Java 2.5 was built with gcc 4.2. If you encounter this problem, try upgrading the version of gcc on your machine to gcc 4.2.

The problem also occurs with HDF5.

Building HDF5 1.8.2 w/gfortran 4.3, make fails with undefined reference to__h5global_MOD*

HDF5 1.8.2 was tested with gfortran 4.2. There is a known compiler bug in gfortran 4.3, which causes the HDF5 build to fail with "undefined reference to__h5global_MOD*" errors. This bug has been fixed. See:

   gcc bugzilla #38171

   [Bug fortran/38171] [regression] equivalence and nested modules broken

Building HDF5 1.8.2, error: call to __open_missing_mode declared with attribute error: open with O_CREAT in second argument needs 3 arguments

This problem has been fixed for the next release. A workaround is to edit the ./perform/zip_perf.c file in the source and change line 552 to:

    output = open(filename, O_RDWR | O_CREAT, S_IRWXU);

Problems Reported with HDF5 1.8.1

Tools tests fail when build HDF5 1.8.1 with "make check install"

There is a bug in HDF5 1.8.1 when building the library with "make check install". We will be fixing this bug for the next release.

The workaround is to run each step separately:

If the .out files look good, proceed to the next step.

Building HDF5, the Object Header Test, "Testing message deletion", fails with the error "H5O_mtime_decode(): badly formatted".

This problem is due to an incorrect timestamp, and it will be fixed in HDF5 1.8.2. To ignore this test for now, see this Frequently Asked Question. You can also temporarily change the timezone to resolve the problem.

Here are details on the problem:

This problem can be reproduced by setting the TZ variable to "EET-2EEST", which is the timezone for Eastern Europe. The timestamp which causes this error is encoded as "19700101003321", which represents Jan. 1, 1970 00:33:21. When translating this to UTC time from mktime, 2 hours are subtracted, thus putting it pre-Epoch.

Problems Reported in HDF5 1.6.7

"make check" fails when testing h5dump with the error, "...tail: cannot open '+41'"

This indicates that your system is a new platform that is not supported by The HDF Group yet. It uses the newer Gnu Coreutil syntax. The "tail -n +4" syntax is the newer POSIX syntax that is not recognized by systems that conform to the older POSIX syntax. Changing the command to use this new syntax will not work on some of the current platforms (e.g., SunOS, ...) that we support. Therefore, this change has not been added to the software.

Run the HDF5 "make check" by first setting the environment variable, _POSIX2_VERSION to the value "199209". For example,

setenv _POSIX2_VERSION 199209

This solution is documented in the Gnu coreutils manual page:



Problems Reported in HDF5 1.6.6

Solaris and gcc

HDF5 was not built and tested with the GNU compilers, and users have reported problems. One user was able to build on Solaris by removing the -std=c99 option from CFLAGS in all of the Makefiles.

tar on Solaris

If you encounter a problem untarring the HDF5 distribution using Sun's tar, then use GNU tar.

Problem Reported in HDF5 1.6.2(3)

Building 5-1.6.2(3) using Intel 8.1, get ULLONG_MAX error

- - Last modified: 14 October 2016