1GRIB_COMPARE(1) User Commands GRIB_COMPARE(1)
2
6 grib_compare - manual page for grib_compare
7
9 NAME grib_compare
10 DESCRIPTION
12 Compare GRIB messages contained in two files. If some differ‐
14 ences are found it fails returning an error code. Float‐
15 ing-point values are compared exactly by default, different tol‐
16 erances can be defined (see -P -A -R). Default behaviour: abso‐
17 lute error=0, bit-by-bit compare, same order in files.
18 USAGE
20 grib_compare [options] grib_file1 grib_file2
22 OPTIONS
24 -r Compare files in which the messages are not in the same order.
26 This option is time expensive.
27 -b key,key,...
29 All the keys in this list are skipped in the comparison.
31 Bit-by-bit compare on.
32 -d Write different messages on files.
34 -e Edition independent compare. It is used to compare GRIB edition
36 1 and 2.
37 -2 Enable two-way comparison.
39 -c key[:i|d|s|n],key[:i|d|s|n],...
41 Only the listed keys or namespaces (:n) are compared. The op‐
43 tional letter after the colon is used to force the type in the
44 comparison: i->integer, d->float, s->string, n->namespace. See
45 -a option. Incompatible with -H option.
46 -S start
48 First field to be processed.
49 -E end Last field to be processed.
51 -a -c option modifier. The keys listed with the option -c will be
53 added to the list of keys compared without -c.
54 -H Compare only message headers (everything except data and bit‐
56 map). Bit-by-bit compare on. Incompatible with -c option.
57 -R key1=relative_error1,key2=relative_error2,...
59 Compare floating-point values using the relative error as toler‐
61 ance. key1=relative_error1 will compare key1 using relative_er‐
62 ror1. all=relative_error will compare all the floating-point
63 keys using relative_error. Default all=0.
64 -A absolute error
66 Compare floating-point values using the absolute error as toler‐
68 ance. Default is absolute error=0
69 -P Compare data values using the packing error as tolerance.
71 -T factor
73 Compare data values using factor multiplied by the tolerance
74 specified in options -P -R -A.
75 -w key[:{s|d|i}]{=|!=}value,key[:{s|d|i}]{=|!=}value,...
77 Where clause. Messages are processed only if they match all the
79 key/value constraints. A valid constraint is of type key=value
80 or key!=value. For each key a string (key:s), a double (key:d)
81 or an integer (key:i) type can be specified. Default type is
82 string. In the value you can also use the forward-slash charac‐
83 ter '/' to specify an OR condition (i.e. a logical disjunction)
84 Note: only one -w clause is allowed.
85 -f Force. Force the execution not to fail on error.
87 -V Version.
89 -7 Does not fail when the message has wrong length
91 -v Verbose.
93 SEE ALSO
95 Full documentation and examples at: <https://conflu‐
97 ence.ecmwf.int/display/ECC/grib_compare>
98 NAME grib_compare
100 DESCRIPTION
102 Compare GRIB messages contained in two files. If some differ‐
104 ences are found it fails returning an error code. Float‐
105 ing-point values are compared exactly by default, different tol‐
106 erances can be defined (see -P -A -R). Default behaviour: abso‐
107 lute error=0, bit-by-bit compare, same order in files.
108 USAGE
110 grib_compare [options] grib_file1 grib_file2
112 OPTIONS
114 -r Compare files in which the messages are not in the same order.
116 This option is time expensive.
117 -b key,key,...
119 All the keys in this list are skipped in the comparison.
121 Bit-by-bit compare on.
122 -d Write different messages on files.
124 -e Edition independent compare. It is used to compare GRIB edition
126 1 and 2.
127 -2 Enable two-way comparison.
129 -c key[:i|d|s|n],key[:i|d|s|n],...
131 Only the listed keys or namespaces (:n) are compared. The op‐
133 tional letter after the colon is used to force the type in the
134 comparison: i->integer, d->float, s->string, n->namespace. See
135 -a option. Incompatible with -H option.
136 -S start
138 First field to be processed.
139 -E end Last field to be processed.
141 -a -c option modifier. The keys listed with the option -c will be
143 added to the list of keys compared without -c.
144 -H Compare only message headers (everything except data and bit‐
146 map). Bit-by-bit compare on. Incompatible with -c option.
147 -R key1=relative_error1,key2=relative_error2,...
149 Compare floating-point values using the relative error as toler‐
151 ance. key1=relative_error1 will compare key1 using relative_er‐
152 ror1. all=relative_error will compare all the floating-point
153 keys using relative_error. Default all=0.
154 -A absolute error
156 Compare floating-point values using the absolute error as toler‐
158 ance. Default is absolute error=0
159 -P Compare data values using the packing error as tolerance.
161 -T factor
163 Compare data values using factor multiplied by the tolerance
164 specified in options -P -R -A.
165 -w key[:{s|d|i}]{=|!=}value,key[:{s|d|i}]{=|!=}value,...
167 Where clause. Messages are processed only if they match all the
169 key/value constraints. A valid constraint is of type key=value
170 or key!=value. For each key a string (key:s), a double (key:d)
171 or an integer (key:i) type can be specified. Default type is
172 string. In the value you can also use the forward-slash charac‐
173 ter '/' to specify an OR condition (i.e. a logical disjunction)
174 Note: only one -w clause is allowed.
175 -f Force. Force the execution not to fail on error.
177 -V Version.
179 -7 Does not fail when the message has wrong length
181 -v Verbose.
183 SEE ALSO
185 Full documentation and examples at: <https://conflu‐
187 ence.ecmwf.int/display/ECC/grib_compare>
188grib_compare November 2023 GRIB_COMPARE(1)