Page History

DESCRIPTION

List content of GRIB files printing values of some keys. It does not fail when a key is not found.

USAGE

grib_ls [options] grib_file grib_file ...

OPTIONS

Declaration of keys to print. For each key a string (key:s), a double (key:d) or an integer (key:i) type can be requested. Default type is string.

C style format for floating-point values.

As -p adding the declared keys to the default list.

Where clause. 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), a double (key:d) or an integer (key:i) type can be specified. Default type is string. In the value you can also use the forward-slash character '/' to specify an OR condition (i.e. a logical disjunction) Note: only one -w clause is allowed.

json output

Order by. The output will be ordered according to the order by directive. Order by example: "step:i asc, centre desc" (step numeric ascending and centre descending)

Value close to the point of a Latitude/Longitude. Allowed values for MODE are: 4 (4 values in the nearest points are printed) Default 1 (the value at the nearest point is printed) file (file is used as mask. The closer point with mask value>=0.5 is printed)

Key/values to set. For each key a string (key:s), a double (key:d) or an integer (key:i) type can be defined. By default the native type is set.

Data value corresponding to the given index is printed.

All the keys belonging to namespace are printed.

Mars keys are printed.

Version.

Minimum width of each column in output. Default is 10.

Multi-field support off. Turn off support for multiple fields in single GRIB message.

Copy GTS header.

Message type. T->GTS, B->BUFR, M->METAR (Experimental),A->Any (Experimental). The input file is interpreted according to the message type.

Does not fail when the message has wrong length

Input file offset in bytes. Processing of the input file will start from "offset".

Fast parsing option, only headers are loaded.

grib_ls examples

1. Without options a default list of keys is printed. The default list is different depending on the type of grib message.

   Code Block
   > grib_ls ../data/reduced*.grib1 ../data/regular*.grib1 ../data/reduced*.grib2




2. To print offset and count number in file use the keys offset and count Also the total count in a set of files is available as countTotal

   Code Block
   > grib_ls -p offset,count,countTotal ../data/reduced*.grib1




3. To list only a subset of messages use the -w (where option). Only the pressure levels are listed with the following line.

   Code Block
   > grib_ls -w levelType=pl ../tigge_pf_ecmwf.grib2




4. All the grib messages not on pressure levels are listed as follows:

   Code Block
   > grib_ls -w levelType!=pl ../tigge_pf_ecmwf.grib2




5. To get the closest grid point to a latitude/longitude.

   Code Block

   > grib_ls -l 51.46,-1.33,1 -p paramId,name ../data/reduced_gaussian_surface.grib2 ../data/reduced_gaussian_surface.grib2 paramId shortName value 167 2t 282.002 1 of 1 messages in ../data/reduced_gaussian_surface.grib2 1 of 1 total messages in 1 files Input Point: latitude=51.46 longitude=-1.33 Grid Point chosen #3 index=749 latitude=51.63 longitude=0.00 distance=93.81 (Km) Other grid Points <ul><li>1 - index=845 latitude=48.84 longitude=0.00 distance=306.86 (Km) </li><li>2 - index=944 latitude=48.84 longitude=356.40 distance=333.66 (Km) </li><li>3 - index=749 latitude=51.63 longitude=0.00 distance=93.81 (Km) </li><li>4 - index=844 latitude=51.63 longitude=356.25 distance=168.37 (Km)




6. To get a list ordered by the 'level' key (ascending order).

   Code Block
   > grib_ls -B 'level:i asc' tigge_af_ecmwf.grib2

   Note: we need to specify the ':i' to get a numerical sort. By default values are sorted as strings so a level of 100 would come before 20!