NAME

       h5diff - Compares two HDF5 files and reports the differences.

SYNOPSIS

       h5diff file1 file2 [OPTIONS] [object1 [object2 ] ]

DESCRIPTION

       h5diff  is  a command line tool that compares two HDF5 files, file1 and file2, and reports
       the differences between them.

       Optionally, h5diff will compare two objects  within  these  files.  If  only  one  object,
       object1,  is specified, h5diff will compare object1 in file1 with object1 in file2. In two
       objects, object1 and object2, are specified, h5diff will compare  object1  in  file1  with
       object2 in file2. These objects must be HDF5 datasets.

       object1  and  object2  must be expressed as absolute paths from the respective file's root
       group.

       Additional information, with several sample cases, can be found  in  the  document  H5diff
       Examples.

OPTIONS

       file1 file2
              The HDF5 files to be compared.

       -h     Print all differences.

       -r     Print  only  the  names of objects that differ; do not print the differences. These
              objects may be HDF5 datasets, groups, or named datatypes.

       -n count
              Print difference up to count differences, then  stop.  count  must  be  a  positive
              integer.

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

       -p relative
              Print only differences that are greater than a relative error. relative must  be  a
              positive  number.  The  comparison  criterion  is whether the absolute value of the
              difference 1 and the ratio of two corresponding values  is  greater  than  relative
              (e.g., |1-(b/a)| > relative where a is a value in file1 and b is a value in file2).

       object1 object2
              Specific object(s) within the files to be compared.

EXAMPLES

       The following h5diff call compares the object /a/b in file1 with the object /a/c in file2:
           h5diff file1 file2 /a/b /a/c

       This h5diff call compares the object /a/b in file1 with the same object in file2:
           h5diff file1 file2 /a/b

       And this h5diff call compares all objects in both files:
           h5diff file1 file2

SEE ALSO

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

                                                                                        h5diff(1)