2003-05-19 13:12:26 +08:00
#############################
2007-11-14 05:40:23 +08:00
Expected output for 'h5diff -d u h5diff_basic1.h5 h5diff_basic2.h5 g1/dset3 g1/dset4'
2003-05-19 13:12:26 +08:00
#############################
<-d u> is not a valid option
2007-11-14 05:40:23 +08:00
usage: h5diff [OPTIONS] file1 file2 [obj1[obj2]]
2007-11-17 04:15:19 +08:00
file1 File name of the first HDF5 file
file2 File name of the second HDF5 file
[obj1] Name of an HDF5 object, in absolute path
[obj2] Name of an HDF5 object, in absolute path
OPTIONS
-h, --help Print a usage message and exit
-V, --version Print version number and exit
-r, --report Report mode. Print differences
-v, --verbose Verbose mode. Print differences, list of objects
-q, --quiet Quiet mode. Do not do output
-n C, --count=C Print differences up to C number
-d D, --delta=D Print difference when greater than limit D
-p R, --relative=R Print difference when greater than relative limit R
2003-05-19 13:12:26 +08:00
2007-11-17 04:15:19 +08:00
C - is a positive integer
D - is a positive number. Compare criteria is |a - b| > D
R - is a positive number. Compare criteria is |(b-a)/a| > R
2003-05-19 13:12:26 +08:00
2004-07-21 03:21:03 +08:00
h5diff has four modes of output:
Normal mode: print the number of differences found and where they occured
Report mode: print the above plus the differences
Verbose mode: print the above plus a list of objects and warnings
Quiet mode: do not print output (h5diff always returns an exit code of 1 when differences are found)
2003-05-19 13:12:26 +08:00
2004-07-21 03:21:03 +08:00
Examples of use:
2003-05-19 13:12:26 +08:00
2004-07-21 03:21:03 +08:00
1) h5diff file1 file2 /g1/dset1 /g1/dset2
2003-05-19 13:12:26 +08:00
2004-07-21 03:21:03 +08:00
Compares object '/g1/dset1' in file1 with '/g1/dset2' in file2
2003-05-19 13:12:26 +08:00
2004-07-21 03:21:03 +08:00
2) h5diff file1 file2 /g1/dset1
Compares object '/g1/dset1' in both files
2003-05-19 13:12:26 +08:00
3) h5diff file1 file2
Compares all objects in both files
2004-07-21 03:21:03 +08:00
Note) file1 and file2 can be the same file. Use
h5diff file1 file1 /g1/dset1 /g1/dset2
to compare '/g1/dset1' and '/g1/dset2' in the same file
2006-03-23 04:53:05 +08:00
If no objects are specified, h5diff only compares objects with the same absolute path in both files. The compare criteria is: 1) datasets: numerical array differences 2) groups: name string difference 3) datatypes: the return value of H5Tequal 2) links: name string difference of the linked value