1GRIB_LS(1)                       User Commands                      GRIB_LS(1)
2
3
4

NAME

6       grib_ls - manual page for grib_ls
7

DESCRIPTION

9       NAME    grib_ls
10
11       DESCRIPTION
12
13              List  content  of  GRIB  files printing values of some keys.  It
14              does not fail when a key is not found.
15
16       USAGE
17
18              grib_ls [options] grib_file grib_file ...
19
20       OPTIONS
21
22       -p key[:{s|d|i}],key[:{s|d|i}],...
23
24              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
28       -F format
29
30              C style format for floating-point values.
31
32       -P key[:{s|d|i}],key[:{s|d|i}],...
33
34              As -p adding the declared keys to the default list.
35
36       -w key[:{s|d|i}]{=|!=}value,key[:{s|d|i}]{=|!=}value,...
37
38              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
46       -j     JSON output
47
48       -B 'order by' directive
49
50              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
54       -l Latitude,Longitude[,MODE,file]
55
56              Value close to the point of a Latitude,Longitude.  Allowed  val‐
57              ues for MODE are:
58
59              4  (4  values  in the nearest points are printed) Default 1 (the
60              value at the nearest point is printed)
61
62              file  (file  is  used  as  mask.  The  closer  point  with  mask
63              value>=0.5 is printed)
64
65       -s key[:{s|d|i}]=value,key[:{s|d|i}]=value,...
66
67              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
71       -i index
72
73              Data value corresponding to the given index is printed.
74
75       -n namespace
76
77              All the keys belonging to namespace are printed.
78
79       -m     Mars keys are printed.
80
81       -V     Version.
82
83       -W width
84
85              Minimum width of each column in output. Default is 10.
86
87       -M     Multi-field support off. Turn off support for multiple fields in
88              single GRIB message.
89
90       -g     Copy GTS header.
91
92       -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
97       -7     Does not fail when the message has wrong length
98
99       -X offset
100
101              Input file offset in bytes. Processing of the  input  file  will
102              start from the given offset.
103
104       -x     Fast parsing option, only headers are loaded.
105
106       NAME    grib_ls
107
108       DESCRIPTION
109
110              List  content  of  GRIB  files printing values of some keys.  It
111              does not fail when a key is not found.
112
113       USAGE
114
115              grib_ls [options] grib_file grib_file ...
116
117       OPTIONS
118
119       -p key[:{s|d|i}],key[:{s|d|i}],...
120
121              Declaration of keys to print.  For each key a string (key:s),  a
122              double  (key:d) or an integer (key:i) type can be requested. De‐
123              fault type is string.
124
125       -F format
126
127              C style format for floating-point values.
128
129       -P key[:{s|d|i}],key[:{s|d|i}],...
130
131              As -p adding the declared keys to the default list.
132
133       -w key[:{s|d|i}]{=|!=}value,key[:{s|d|i}]{=|!=}value,...
134
135              Where clause.  Messages are processed only if they match all the
136              key/value  constraints.  A valid constraint is of type key=value
137              or key!=value.  For each key a string (key:s), a double  (key:d)
138              or  an  integer  (key:i)  type can be specified. Default type is
139              string.  In the value you can also use the forward-slash charac‐
140              ter  '/' to specify an OR condition (i.e. a logical disjunction)
141              Note: only one -w clause is allowed.
142
143       -j     JSON output
144
145       -B 'order by' directive
146
147              Order by. The output will be ordered according to the 'order by'
148              directive.  Example: "step:i asc, centre desc" (step numeric as‐
149              cending and centre descending) Default sort mode is 'asc'
150
151       -l Latitude,Longitude[,MODE,file]
152
153              Value close to the point of a Latitude,Longitude.  Allowed  val‐
154              ues for MODE are:
155
156              4  (4  values  in the nearest points are printed) Default 1 (the
157              value at the nearest point is printed)
158
159              file  (file  is  used  as  mask.  The  closer  point  with  mask
160              value>=0.5 is printed)
161
162       -s key[:{s|d|i}]=value,key[:{s|d|i}]=value,...
163
164              Key/values  to  set.   For  each  key a string (key:s), a double
165              (key:d) or an integer (key:i) type can be  defined.  By  default
166              the native type is set.
167
168       -i index
169
170              Data value corresponding to the given index is printed.
171
172       -n namespace
173
174              All the keys belonging to namespace are printed.
175
176       -m     Mars keys are printed.
177
178       -V     Version.
179
180       -W width
181
182              Minimum width of each column in output. Default is 10.
183
184       -M     Multi-field support off. Turn off support for multiple fields in
185              single GRIB message.
186
187       -g     Copy GTS header.
188
189       -T T | B | M | A
190              Message type. T->GTS, B->BUFR, M->METAR  (Experimental),  A->Any
191              (Experimental).   The input file is interpreted according to the
192              message type.
193
194       -7     Does not fail when the message has wrong length
195
196       -X offset
197
198              Input file offset in bytes. Processing of the  input  file  will
199              start from the given offset.
200
201       -x     Fast parsing option, only headers are loaded.
202
203
204
205grib_ls                          December 2022                      GRIB_LS(1)