1h5repack(1)                 General Commands Manual                h5repack(1)
2
3
4

NAME

6       h5repack  -  Copy  an  HDF5 file to a new file with or without compres‐
7       sion/chunking
8

SYNOPSIS

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

DESCRIPTION

14       h5repack  is  a  command line tool that applies HDF5 filters to a input
15       file file1, saving the output in a new file, file2.
16
17       ´filter´ is a string with the format      <list of objects> : <name  of
18       filter> = <filter parameters>.
19
20       <list  of  objects>  is  a comma separated list of object names meaning
21       apply compression only to those objects. If no object names are  speci‐
22       fied, the filter is applied to all objects.
23
24       <name of filter> can be:
25           GZIP, to apply the HDF5 GZIP filter (GZIP compression)
26           SZIP, to apply the HDF5 SZIP filter (SZIP compression)
27           SHUF, to apply the HDF5 shuffle filter
28           FLET, to apply the HDF5 checksum filter
29           NONE, to remove the filter
30
31       <filter parameters> contains the optional compression information:
32           SHUF (no parameter)
33           FLET (no parameter)
34           GZIP=<deflation level> from 1-9
35           SZIP=<pixels  per  block,coding> (pixels per block is a even number
36       in 2-32 and coding method is 'EC' or 'NN')
37
38       ´layout´ is a string with the format
39           <list of objects> : <layout type>
40
41       <list of objects> is a comma separated list of  object  names,  meaning
42       that  layout  information  is  supplied for those objects. If no object
43       names are specified, the layout is applied to all objects.
44
45       <layout type> can be:
46           CHUNK, to apply chunking layout
47           COMPA, to apply compact layout
48           CONTI, to apply continuous layout
49
50       <layout parameters> is present for the chunk case only it is the  chunk
51       size of each dimension: <dim_1 x dim_2 x ... dim_n>
52

OPTIONS

54       file1,file2
55              The input and output HDF5 files
56
57       -h     Print a help message
58
59       -f filter
60              Filter type
61
62       -l layout
63              Layout type
64
65       -v     Verbose mode. Print output (list of objects in the file, filters
66              and layout applied).
67
68       -e file
69              File with the -f and -l options (only filter and layout flags)
70
71       -d delta
72              Print only differences that are greater than  the  limit  delta.
73              delta  must  be  a  positive number. The comparison criterion is
74              whether the absolute value of the difference of two  correspond‐
75              ing  values  is greater than delta (e.g., |a-b| > delta, where a
76              is a value in file1 and b is a value in file2).
77
78       -m number
79              Do not apply the filter  to  objects  which  size  in  bytes  is
80              smaller  than  number. If no size is specified a minimum of 1024
81              bytes is assumed.
82

EXAMPLES

84       Apply GZIP compression to all objects in file1 and save the  output  in
85       file2:
86
87            h5repack -i file1 -o file2 -f GZIP=1 -v
88
89       Apply SZIP compression only to object ´dset1´:
90
91            h5repack -i file1 -o file2 -f dset1:SZIP=8,NN -v
92
93       Apply a chunked layout to objects ´dset1´ and ´dset2´:
94
95            h5repack -i file1 -o file2 -l dset1,dset2:CHUNK=20x10 -v
96

SEE ALSO

98       h5dump(1),   h5ls(1),  h5diff(1),  h5import(1),  gif2h5(1),  h52gif(1),
99       h5perf(1), h5repart(1).
100
101
102
103                                                                   h5repack(1)