h5repack - Copy an HDF5 file to a new file with or without compression/chunking
Contents
Description
h5repack is a command line tool that applies HDF5 filters to a input file file1, saving the output in a
new file, file2.
´filter´ is a string with the format <list of objects> : <name of filter> = <filter parameters>.
<listofobjects> is a comma separated list of object names meaning apply compression only to those
objects. If no object names are specified, the filter is applied to all objects.
<nameoffilter> can be:
GZIP, to apply the HDF5 GZIP filter (GZIP compression)
SZIP, to apply the HDF5 SZIP filter (SZIP compression)
SHUF, to apply the HDF5 shuffle filter
FLET, to apply the HDF5 checksum filter
NONE, to remove the filter
<filterparameters> contains the optional compression information:
SHUF (no parameter)
FLET (no parameter)
GZIP=<deflation level> from 1-9
SZIP=<pixels per block,coding> (pixels per block is a even number in 2-32 and coding method is 'EC'
or 'NN')
´layout´isastringwiththeformat
<list of objects> : <layout type>
<listofobjects> is a comma separated list of object names, meaning that layout information is supplied
for those objects. If no object names are specified, the layout is applied to all objects.
<layouttype> can be:
CHUNK, to apply chunking layout
COMPA, to apply compact layout
CONTI, to apply continuous layout
<layoutparameters> is present for the chunk case only it is the chunk size of each dimension: <dim_1xdim_2x...dim_n>Examples
Apply GZIP compression to all objects in file1 and save the output in file2:
h5repack -i file1 -o file2 -f GZIP=1 -v
Apply SZIP compression only to object ´dset1´:
h5repack -i file1 -o file2 -f dset1:SZIP=8,NN -v
Apply a chunked layout to objects ´dset1´ and ´dset2´:
h5repack -i file1 -o file2 -l dset1,dset2:CHUNK=20x10 -v
Name
h5repack - Copy an HDF5 file to a new file with or without compression/chunking
Options
file1,file2
The input and output HDF5 files
-h Print a help message
-ffilter
Filter type
-llayout
Layout type
-v Verbose mode. Print output (list of objects in the file, filters and layout applied).
-efile
File with the -f and -l options (only filter and layout flags)
-ddelta
Print only differences that are greater than the limit delta. delta must be a positive number.
The comparison criterion is whether the absolute value of the difference of two corresponding
values is greater than delta (e.g., |a-b| > delta, where a is a value in file1 and b is a value in
file2).
-mnumber
Do not apply the filter to objects which size in bytes is smaller than number. If no size is
specified a minimum of 1024 bytes is assumed.
See Also
h5dump(1), h5ls(1), h5diff(1), h5import(1), gif2h5(1), h52gif(1), h5perf(1), h5repart(1). h5repack(1)
Synopsis
h5repack-ifile1-ofile2 [-h] [-v] [-f´filter´] [-l´layout´] [-mnumber] [-efile]
