1h5diff(1) General Commands Manual h5diff(1)
2
3
4
6 h5diff - Compares two HDF5 files and reports the differences.
7
9 h5diff file1 file2 [OPTIONS] [object1 [object2 ] ]
10
12 h5diff is a command line tool that compares two HDF5 files, file1 and
13 file2, and reports the differences between them.
14
15 Optionally, h5diff will compare two objects within these files. If only
16 one object, object1, is specified, h5diff will compare object1 in file1
17 with object1 in file2. In two objects, object1 and object2, are speci‐
18 fied, h5diff will compare object1 in file1 with object2 in file2. These
19 objects must be HDF5 datasets.
20
21 object1 and object2 must be expressed as absolute paths from the
22 respective file's root group.
23
24 Additional information, with several sample cases, can be found in the
25 document H5diff Examples.
26
28 file1 file2
29 The HDF5 files to be compared.
30
31 -h Print all differences.
32
33 -r Print only the names of objects that differ; do not print the
34 differences. These objects may be HDF5 datasets, groups, or
35 named datatypes.
36
37 -n count
38 Print difference up to count differences, then stop. count must
39 be a positive integer.
40
41 -d delta
42 Print only differences that are greater than the limit delta.
43 delta must be a positive number. The comparison criterion is
44 whether the absolute value of the difference of two correspond‐
45 ing values is greater than delta (e.g., |a-b| > delta, where a
46 is a value in file1 and b is a value in file2).
47
48 -p relative
49 Print only differences that are greater than a relative error.
50 relative must be a positive number. The comparison criterion is
51 whether the absolute value of the difference 1 and the ratio of
52 two corresponding values is greater than relative (e.g.,
53 |1-(b/a)| > relative where a is a value in file1 and b is a
54 value in file2).
55
56 object1 object2
57 Specific object(s) within the files to be compared.
58
60 The following h5diff call compares the object /a/b in file1 with the
61 object /a/c in file2:
62 h5diff file1 file2 /a/b /a/c
63
64 This h5diff call compares the object /a/b in file1 with the same object
65 in file2:
66 h5diff file1 file2 /a/b
67
68 And this h5diff call compares all objects in both files:
69 h5diff file1 file2
70
72 h5dump(1), h5ls(1), h5repart(1), h5import(1), gif2h5(1), h52gif(1),
73 h5perf(1)
74
75
76
77 h5diff(1)