Purpose:
Add H5Premove_filter
H5Pset_chunk bug fix
Further SZIP revisions
Description:
H5Premove_filter -- added this function, incuding Fortran
H5Pset_chunk -- specified units of chunk size as "dataset elements"
Fixes Bugzilla #110.
H5Pset_szip revisions and clarifications
improved description of bits_per_pixel settings
(at high-level in "Description" with details in "Notes")
clarify meaning of "pixel" in HDF5/SZIP context
describe potential H5Dcreate failure more explicitly
in case of mistaken use of H5Pset_szip
clarify discussion of H5_SZIP_EC_OPTION_MASK versus
H5_SZIP_NN_OPTION_MASK suitability
mention current SZIP setting for maximum number of blocks
per scan line
Platforms tested:
Mozilla
Purpose:
Added notes regarding C++ changes, including mention of the C++ RM.
Entries appear in "New Functions" and "Functions with changed Syntax."
Platforms tested:
Mozilla
Description:
RM_H5Front.html
Add link to new C++ Ref Manual
(and delete link to superseded old C++ Interfaces document)
index.html
Restructure page in attempt to reduce cluttered appearance
Revise "HDF5 User's Guide" section
Rework "HDF5 Ref Manual" and "Foreign Languages" sections,
with particular attention to the new C++ RM
Replace links to two outdated Parallel HDF5 documents with
link to a much more current page on the HDF website
(and move link into the "at NCSA" column)
Add emphasis to "Tools" link
Platforms tested:
Mozilla, Safari
Purpose:
Adding C++ Reference Manual to 1.6 release branch.
This manual is automatically generated
by doxygen from the C++ source code.
Platforms tested:
Mozilla, Safari, IE 5
Purpose:
Adding C++ Reference Manual to 1.6 release branch.
This manual is automatically generated
by doxygen from the C++ source code.
Platforms tested:
Mozilla, Safari, IE 5
Purpose:
In "Intro to HDF5" Example #5, corrected the anticipated output listed in
a code comment.
Fixes Bugzilla entry #112.
Platforms tested:
Mozilla
Purpose:
Removed second versions of h5dread_f and h5dwrite_f, as that version
of the FORTRAN subroutine is no longer required and has been removed
from the API.
This closes Bugzilla entry #92, which complained of a parameter
description error in the second version.
Platforms tested:
Mozilla
Purpose:
H5Pset_szip -- major rewrite
H5Dcreate -- added a note regarding SZIP
Description:
H5Pset_szip -- Rrestructured and rewrote H5Pset_szip Description and
Notes to explain SZIP usage more completely, to capture limitations
and potential pitfalls, to offer a tunign suggestion, and to
segregate discussion of SZIP parameters that may be of interest to
users familiar with SZIP in other environments.
Updated parameter discussion in Description and Parameter sections.
Described ways in which erroneous SZIP setup can cause H5Dcreate
to fail.
H5Dcreate -- Added note to see the H5Pset_szip RM entry if H5Dcreate
fails and SZIP compression is to be used with the dataset.
Platforms tested:
Mozilla
updated documentation and usage message
Description:
updated the html documentation for the new h5diff modes
added a section for h5repack
Solution:
Platforms tested:
linux
Misc. update:
Purpose:
Bug Fix
Description:
If an HDF5 file grows larger than its address space, it dies and is unable to
write any data. This is more likely to happen since users are able to change
the number of bytes used to store addresses in the file.
Solution:
HDF5 now throws an error instead of dying. In addition, it "reserves" address
space for the local heap and for object headers (which do not allocate space
immediately). This ensures that after the error occurs, there is enough address
space left to flush the entire file to disk, so no data is lost.
A more complete explanation is at /doc/html/TechNotes/ReservedFileSpace.html
Platforms tested:
sleipnir, copper (parallel), verbena, arabica, Windows (Visual Studio 7)
Misc. update:
Purpose: Maintenance
Description: H5_SZIP_CHIP_OPTION_MASK was deleted from the list
of the available parameters for the H5Pset_szip function.
Solution: Updated Fortran source, tests and documentation
to reflect this change.
Platforms tested: arabica (too small for h5committest)
Misc. update:
Purpose:
To more carefully describe the behavior of H5Pset_external.
Description:
Add notes that first H5Pset_external call sets the dataset as EXTERNAL
and identifies the first file in the series of external files that
will hold the dataset; subsequent calls identify additional files;
all external files must be declared before the dataset is created;
and the library will create files that don't yet exist on the system
at the time that H5Dwrite is called to write data to that file.
Also a few copy edits.
Platforms tested:
Mozilla
Purpose:
SZIP and general filter updates
Description:
Added SZIP to the introductory paragraphs and as appropriate in
the Fortran subroutine descriptions.
Revised the introductory discussion, which had focussed on
one compression filter, to allow for multiple filters of
different types.
Added list of distributed filters to intro.
Also some copy edits and minor formatting.
Platforms tested:
Mozilla, Safari
Description:
Added "API Changes" section for Release 1.6.3.
Includes templates and an incomplete scattering of initial entries.
Platforms tested:
Mozilla
Purpose:
Bugfix and clarification
Description:
H5Pget_driver -- removed H5FD_DPSS from valid drivers list;
DPSS is long gone.
H5Pset_shuffle -- clarified value and use of shuffle filter.
Platforms tested:
Mozilla
Code optimization & bug fix
Description:
When dimension information is being stored in the storage layout message
on disk, it is stored as 32-bit quantities, possibly truncating the dimension
information, if a dimension is greater than 32-bits in size.
Solution:
Fix the storage layout message problem by revising file format to not store
dimension information, since it is already available in the dataspace.
Also revise the storage layout data structures to be more compartmentalized
for the information for contiguous, chunked and compact storage.
Platforms tested:
FreeBSD 4.9 (sleipnir) w/parallel
Solaris 2.7 (arabica)
h5committest
Purpose:
Bugfixes in H5Gset_comment, h5gget_comment_f, and h5gset_comment_f.
(Follow-on to the H5Gget_comment bugfix of last week.)
Description:
Changed C parameter descriptions to indicate the following:
'loc_id' can be file, group, dataset, or named datatype.
'name' can be '.' if 'loc_id' fully describes the object.
'name' is ignored if 'loc_id' is a dataset or named datatype.
Modified h5gget_comment_f and h5gset_comment_f notes accordingly.
Copy edits in H5Gget/set_comment and h5gget/set_comment_f.
Platforms tested:
Safari
Purpose:
H5Gget_comment bugfix
Description:
H5Gget_comment: Changed "Description" text and "Parameters"
descriptions to indicate the following:
'loc_id' can be file, group, dataset, or named datatype.
'name' can be '.' if 'loc_id' fully describes the object.
'name' is ignored if 'loc_id' is a dataset or nemed datatype.
Also corrected the fact that the 'name' parameter description
referred to setting the comment rather than retriving it.
Platforms tested:
Safari
Purpose:
Bugfix: Bugzilla #66
Solution:
H5Pset_szip -- Corrected the plist parameter description.
Since this property can be set only in the dataset
creation property list, changed the parameter description
from
Dataset creation or dataset transfer property list identifier.
to
Dataset creation property list identifier.
Fixes Bugzilla bug #66.
Platforms tested:
IE 5
Description:
Changed the H5Pset(get)_cache change description in the
Release 1.6.0 "Functions with Changed Syntax" section to
reference the 'rdcc_nbytes' parameter rather than 'rdcc_nelmts'.
The note originally identifed the wrong parameter as having a
changed datatype.
[Closes bug #1053.]
Platforms tested:
IE 5
Purpose:
Update documentation index (hdf5/doc/html/index.html) to say
that it describes Release 1.6.2.
The index file included with the R1.6.2 source tarfile mistakenly
refers to Release 1.6.1; this has been noted on the "Known Problems"
page on the HDF5 website. The corrected file will be included in the
hdf.ncsa.uiuc.edu:/HDF5/doc/ document set and in the
Release 1.6.2 documentation-only tarfile.
Platforms tested:
IE 5, Safari
