Several changes has been made to the H5hut C and Fortran API:
Versions newer than 0.99.13 provide an improved API to open H5hut files. Existing code must be adapted accordingly.
A more complete set of functions to query datasets and attributes has been implemented.
Starting with version 0.99.11 the C-API is implemented with inline functions. This does not require changes in the source code but for linking - the library libh5hutC has been removed.
The compiler wrapper h5hutcc is obsolete and not available any more.
The Fortran API has been reviewed and partially rewritten.
More and better examples has been added some old examples removed.
Changes in API
The API function to open a H5hut file are more general and more flexible making it simpler to add new features. Like in HDF5 you can define properties of a file and pass this properties to the open call. Adapting old code is easy and straight forward.
The return type was a pointer to a structure. With the argument flags the access mode of the file and the virtual file driver was selected. In the parallel version comm was used to pass the MPI communicator. In the serial version this argument was ignored.
In old H5hut version several open function were implemented, for example different versions for opening a file for serial or parallel I/O. Now one function covers all cases. With property list we adopt a feature known from HDF5.
Creating a property list
If you want/have to set special properties to a file, you have to create a file property list first.
Closing a property list
After using a file property list, you have to close it.
In the following section we give a short overview over the properties you can set for a H5hut file. For more details please read the H5hut API documentation.
Set property for collective I/O and pass MPI communicator to the H5hut library.
Note: Collective I/O is the default.
Set property for independent I/O and pass MPI communicator to the H5hut library.
Set property for MPI Posix I/O and pass MPI communicator to the H5hut library.
Note: This property is only available if you compile H5hut with HDF5 1.8.12 or older.