1GRIB_LS(1) User Commands GRIB_LS(1)
2
6 grib_ls - manual page for grib_ls
7
9 NAME grib_ls
10 DESCRIPTION
12 List content of GRIB files printing values of some keys. It
14 does not fail when a key is not found.
15 USAGE
17 grib_ls [options] grib_file grib_file ...
19 OPTIONS
21 -p key[:{s|d|i}],key[:{s|d|i}],...
23 Declaration of keys to print. For each key a string (key:s), a
25 double (key:d) or an integer (key:i) type can be requested. De‐
26 fault type is string.
27 -F format
29 C style format for floating-point values.
31 -P key[:{s|d|i}],key[:{s|d|i}],...
33 As -p adding the declared keys to the default list.
35 -w key[:{s|d|i}]{=|!=}value,key[:{s|d|i}]{=|!=}value,...
37 Where clause. Messages are processed only if they match all the
39 key/value constraints. A valid constraint is of type key=value
40 or key!=value. For each key a string (key:s), a double (key:d)
41 or an integer (key:i) type can be specified. Default type is
42 string. In the value you can also use the forward-slash charac‐
43 ter '/' to specify an OR condition (i.e. a logical disjunction)
44 Note: only one -w clause is allowed.
45 -j JSON output
47 -B 'order by' directive
49 Order by. The output will be ordered according to the 'order by'
51 directive. Example: "step:i asc, centre desc" (step numeric as‐
52 cending and centre descending) Default sort mode is 'asc'
53 -l latitude,longitude[,MODE,file]
55 Value close to the point of a latitude,longitude (nearest neigh‐
57 bour). Allowed values for MODE are:
58 4 (4 values in the nearest points are printed) Default 1 (the
60 value at the nearest point is printed)
61 file (file is used as mask. The closer point with mask
63 value>=0.5 is printed)
64 -s key[:{s|d|i}]=value,key[:{s|d|i}]=value,...
66 Key/values to set. For each key a string (key:s), a double
68 (key:d) or an integer (key:i) type can be defined. By default
69 the native type is set.
70 -i index
72 Data value corresponding to the given index is printed.
74 -n namespace
76 All the keys belonging to the given namespace are printed.
78 -m Mars keys are printed.
80 -V Version.
82 -W width
84 Minimum width of each column in output. Default is 10.
86 -M Multi-field support off. Turn off support for multiple fields in
88 a single GRIB message.
89 -g Copy GTS header.
91 -T T | B | M | A
93 Message type. T->GTS, B->BUFR, M->METAR (Experimental), A->Any
94 (Experimental). The input file is interpreted according to the
95 message type.
96 -7 Does not fail when the message has wrong length
98 -X offset
100 Input file offset in bytes. Processing of the input file will
102 start from the given offset.
103 -x Fast parsing option, only headers are loaded.
105 SEE ALSO
107 Full documentation and examples at: <https://conflu‐
109 ence.ecmwf.int/display/ECC/grib_ls>
110 NAME grib_ls
112 DESCRIPTION
114 List content of GRIB files printing values of some keys. It
116 does not fail when a key is not found.
117 USAGE
119 grib_ls [options] grib_file grib_file ...
121 OPTIONS
123 -p key[:{s|d|i}],key[:{s|d|i}],...
125 Declaration of keys to print. For each key a string (key:s), a
127 double (key:d) or an integer (key:i) type can be requested. De‐
128 fault type is string.
129 -F format
131 C style format for floating-point values.
133 -P key[:{s|d|i}],key[:{s|d|i}],...
135 As -p adding the declared keys to the default list.
137 -w key[:{s|d|i}]{=|!=}value,key[:{s|d|i}]{=|!=}value,...
139 Where clause. Messages are processed only if they match all the
141 key/value constraints. A valid constraint is of type key=value
142 or key!=value. For each key a string (key:s), a double (key:d)
143 or an integer (key:i) type can be specified. Default type is
144 string. In the value you can also use the forward-slash charac‐
145 ter '/' to specify an OR condition (i.e. a logical disjunction)
146 Note: only one -w clause is allowed.
147 -j JSON output
149 -B 'order by' directive
151 Order by. The output will be ordered according to the 'order by'
153 directive. Example: "step:i asc, centre desc" (step numeric as‐
154 cending and centre descending) Default sort mode is 'asc'
155 -l latitude,longitude[,MODE,file]
157 Value close to the point of a latitude,longitude (nearest neigh‐
159 bour). Allowed values for MODE are:
160 4 (4 values in the nearest points are printed) Default 1 (the
162 value at the nearest point is printed)
163 file (file is used as mask. The closer point with mask
165 value>=0.5 is printed)
166 -s key[:{s|d|i}]=value,key[:{s|d|i}]=value,...
168 Key/values to set. For each key a string (key:s), a double
170 (key:d) or an integer (key:i) type can be defined. By default
171 the native type is set.
172 -i index
174 Data value corresponding to the given index is printed.
176 -n namespace
178 All the keys belonging to the given namespace are printed.
180 -m Mars keys are printed.
182 -V Version.
184 -W width
186 Minimum width of each column in output. Default is 10.
188 -M Multi-field support off. Turn off support for multiple fields in
190 a single GRIB message.
191 -g Copy GTS header.
193 -T T | B | M | A
195 Message type. T->GTS, B->BUFR, M->METAR (Experimental), A->Any
196 (Experimental). The input file is interpreted according to the
197 message type.
198 -7 Does not fail when the message has wrong length
200 -X offset
202 Input file offset in bytes. Processing of the input file will
204 start from the given offset.
205 -x Fast parsing option, only headers are loaded.
207 SEE ALSO
209 Full documentation and examples at: <https://conflu‐
211 ence.ecmwf.int/display/ECC/grib_ls>
212grib_ls November 2023 GRIB_LS(1)