NAME

       h5repack - Copy an HDF5 file to a new file with or without compression/chunking

SYNOPSIS

       h5repack -i file1 -o file2 [-h] [-v] [-f ´filter´] [-l ´layout´] [-m number] [-e file]

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>.

       <list of objects> 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.

       <name of filter> 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

       <filter parameters> 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´ is a string with the format
           <list of objects> : <layout type>

       <list  of  objects>  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.

       <layout type> can be:
           CHUNK, to apply chunking layout
           COMPA, to apply compact layout
           CONTI, to apply continuous layout

       <layout  parameters>  is  present  for  the  chunk  case only it is the chunk size of each
       dimension: <dim_1 x dim_2 x ... dim_n>

OPTIONS

       file1,file2
              The input and output HDF5 files

       -h     Print a help message

       -f filter
              Filter type

       -l layout
              Layout type

       -v     Verbose mode. Print output (list  of  objects  in  the  file,  filters  and  layout
              applied).

       -e file
              File with the -f and -l options (only filter and layout flags)

       -d delta
              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).

       -m number
              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.

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

SEE ALSO

       h5dump(1), h5ls(1), h5diff(1), h5import(1), gif2h5(1), h52gif(1), h5perf(1), h5repart(1).

                                                                                      h5repack(1)