.TH GRIB_COMPARE "1" "April 2009" "grib_compare" "User Commands"

.SH NAME
grib_compare

.SH DESCRIPTION
Compare grib messages contained in two files.
If some differences are found it fails returning an error code.
Floating point values are compared exactly by default, different tolerance can be defined see -P -A -R.
Default behaviour: absolute error=0, bit-by-bit compare, same order in files.

.SH USAGE 
grib_compare [options] grib_file grib_file

.SH OPTIONS
.TP
\fB\-r\fR 	Compare files in which the messages are not in the same order. This option is time expensive.
.TP
\fB\-b\fR key,key,...	
All the keys in this list are skipped in the comparison. Bit-by-bit compare on.
.TP
\fB\-e\fR 	Edition independent compare. It is used to compare grib edition 1 and 2.
.TP
\fB\-c\fR key[:l/d/s/n],key[:l/d/s/n],...	
Only the listed keys or namespaces (:n) are compared. The optional letter after the colon is used 
to force the type in the comparison: l->integer, d->float, s->string, n->namespace.
See -a option. Incompatible with -H option.
.TP
\fB\-S\fR start	First field to be processed.
.TP
\fB\-E\fR end	Last field to be processed.
.TP
\fB\-a\fR 	-c option modifier. The keys listed with the option -c will be added to the list of keys compared without -c.
.TP
\fB\-H\fR 	Compare only message headers. Bit-by-bit compare on. Incompatible with -c option.
.TP
\fB\-R\fR key1=relative_error1,key2=relative_error2,...
Compare floating point values using the relative error as tolerance.
key1=relative_error will compare key1 using relative_error1.
all=relative_error will compare all the floating point keys using relative_error. Default all=0.
.TP
\fB\-A\fR absolute error
Compare floating point values using the absolute error as tolerance.
Default is absolute error=0
.TP
\fB\-P\fR 	Compare data values using the packing error as tolerance.
.TP
\fB\-T\fR factor	Compare data values using factor multiplied by the tolerance specified in options -P -R -A.
.TP
\fB\-w\fR key[:{s/d/l}]{=/!=}value,key[:{s/d/l}]{=/!=}value,...	
Where clause.
Grib messages are processed only if they match all the key/value constraints.
A valid constraint is of type key=value or key!=value.
For each key a string (key:s) or a double (key:d) or a long (key:l)
type can be specified. Default type is string.
.TP
\fB\-f\fR 	Force. Force the execution not to fail on error.
.TP
\fB\-V\fR 	Version.
.TP
\fB\-7\fR 	Does not fail when the message has wrong length
.TP
\fB\-v\fR 	Verbose.


.SH AUTHOR
This manpage has been autogenerated by Enrico Zini <enrico@debian.org>from the command line help of grib_compare.