2003-05-19 13:12:26 +08:00
|
|
|
<-n 0x1> 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
|
2010-01-26 06:02:35 +08:00
|
|
|
-l, --link-follow Follow link(s)
|
2009-01-27 03:29:22 +08:00
|
|
|
-c, --compare List objects that are not comparable
|
2009-01-14 00:33:31 +08:00
|
|
|
-N, --nan Avoid NaNs detection
|
2009-09-12 04:09:34 +08:00
|
|
|
-n C, --count=C Print differences up to C number, C is a positive integer.
|
|
|
|
-d D, --delta=D Print difference if (|a-b| > D), D is a positive number.
|
|
|
|
-p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive number.
|
|
|
|
--use-system-epsilon Print difference if (|a-b| > EPSILON),
|
|
|
|
where EPSILON (FLT_EPSILON or FLT_EPSILON) is the system epsilon value.
|
|
|
|
If the system epsilon is not defined, use the value below:
|
|
|
|
FLT_EPSILON = 1.19209E-07 for float
|
|
|
|
DBL_EPSILON = 2.22045E-16 for double
|
|
|
|
-d, -p, and --use-system-epsilon options are used for comparing floating point values.
|
|
|
|
By default, strict equality is used. Use -p or -d to set specific tolerance.
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
Modes of output:
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
Default mode: print the number of differences found and where they occured
|
|
|
|
-r Report mode: print the above plus the differences
|
|
|
|
-v Verbose mode: print the above plus a list of objects and warnings
|
|
|
|
-q Quiet mode: do not print output
|
2008-08-05 05:13:16 +08:00
|
|
|
|
|
|
|
Compare criteria
|
|
|
|
|
|
|
|
If no objects [obj1[obj2]] are specified, h5diff only compares objects
|
2008-10-30 03:29:25 +08:00
|
|
|
with the same absolute path in both files
|
2008-08-05 05:13:16 +08:00
|
|
|
|
|
|
|
The compare criteria is:
|
|
|
|
1) datasets: numerical array differences 2) groups: name string difference
|
2009-02-05 23:24:23 +08:00
|
|
|
3) datatypes: the return value of H5Tequal 4) links: name string difference
|
2008-08-05 05:13:16 +08:00
|
|
|
of the linked value
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
Return exit code:
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2008-10-30 03:29:25 +08:00
|
|
|
1 if differences found, 0 if no differences, 2 if error
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
Examples of use:
|
2004-07-21 03:21:03 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
1) h5diff file1 file2 /g1/dset1 /g1/dset2
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
Compares object '/g1/dset1' in file1 with '/g1/dset2' in file2
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
2) h5diff file1 file2 /g1/dset1
|
2003-05-19 13:12:26 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
Compares object '/g1/dset1' in both files
|
2004-07-21 03:21:03 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
3) h5diff file1 file2
|
2004-07-21 03:21:03 +08:00
|
|
|
|
2007-11-20 03:38:34 +08:00
|
|
|
Compares all objects in both files
|
2006-03-23 04:53:05 +08:00
|
|
|
|
2007-11-20 03:38:34 +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
|
|
|
|
|