mirror of https://github.com/ecmwf/eccodes.git
96 lines
4.1 KiB
HTML
96 lines
4.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
<title>grib_api: grib_ls</title>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
</head><body>
|
|
<!-- Generated by Doxygen 1.5.3 -->
|
|
<div class="tabs">
|
|
<ul>
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
<li><a href="pages.html"><span>Related Pages</span></a></li>
|
|
<li><a href="examples.html"><span>Examples</span></a></li>
|
|
</ul>
|
|
</div>
|
|
<h1><a class="anchor" name="grib_ls">grib_ls</a></h1><h2><a class="anchor" name="DESCRIPTION">
|
|
DESCRIPTION</a></h2>
|
|
List content of grib files printing values of some keys. It does not fail when a key is not found.<h2><a class="anchor" name="USAGE">
|
|
USAGE</a></h2>
|
|
grib_ls [options] grib_file grib_file ...<h2><a class="anchor" name="OPTIONS">
|
|
OPTIONS</a></h2>
|
|
-p key[:{s/d/l}],key[:{s/d/l}],... <br>
|
|
Declaration of keys to print. For each key a string (key:s) or a double (key:d) or a long (key:l) type can be requested. Default type is string. <br>
|
|
<br>
|
|
-F format <br>
|
|
C style format for floating point values. <br>
|
|
<br>
|
|
-P key[:{s/d/l}],key[:{s/d/l}],... <br>
|
|
As -p adding the declared keys to the default list. <br>
|
|
<br>
|
|
-w key[:{s/d/l}]{=/!=}value,key[:{s/d/l}]{=/!=}value,... <br>
|
|
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. <br>
|
|
<br>
|
|
-B order by directive <br>
|
|
Order by. The output will be ordered according the order by directive. Order by example: "step asc, centre desc" (step ascending and centre discending) <br>
|
|
<br>
|
|
-l Latitude,Longitude[,MODE,file] <br>
|
|
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) <br>
|
|
<br>
|
|
-i index <br>
|
|
Data value corresponding to the given index is printed. <br>
|
|
<br>
|
|
-n namespace <br>
|
|
All the keys belonging to namespace are printed. <br>
|
|
<br>
|
|
-m <br>
|
|
Mars keys are printed. <br>
|
|
<br>
|
|
-V <br>
|
|
Version. <br>
|
|
<br>
|
|
-W width <br>
|
|
Minimum width of each column in output. Default is 10. <br>
|
|
<br>
|
|
-M <br>
|
|
Multi-grib support off. Turn off support for multiple fields in single grib message <br>
|
|
<br>
|
|
-g <br>
|
|
Copy GTS header. <br>
|
|
<br>
|
|
-G <br>
|
|
GRIBEX compatibility mode. <br>
|
|
<br>
|
|
-7 <br>
|
|
Does not fail when the message has wrong length <br>
|
|
<br>
|
|
<h2><a class="anchor" name="grib_ls_examples">
|
|
grib_ls examples</a></h2>
|
|
<ol type=1>
|
|
<li>Without options a default list of keys is printed. <br>
|
|
The default list is different depending on the type of grib message. <br>
|
|
<div class="fragment"><pre class="fragment">
|
|
> grib_ls ../data/reduced*.grib1 ../data/regular*.grib1 ../data/reduced*.grib2 \n
|
|
</pre></div><br>
|
|
</li><li>To print offset and count number in file use the keys offset and count<br>
|
|
Also the total count in a set of files is available as countTotal<br>
|
|
<div class="fragment"><pre class="fragment">
|
|
> grib_ls -p offset,count,countTotal ../data/reduced*.grib1
|
|
</pre></div><br>
|
|
</li><li>To list only a subset of messages use the -w (where option).<br>
|
|
Only the pressure levels are listed with the following line.<br>
|
|
<div class="fragment"><pre class="fragment">
|
|
> grib_ls -w levType=pl ../tigge_pf_ecmwf.grib2
|
|
</pre></div><br>
|
|
</li><li>All the grib messages not on pressure levels are listed as follows:<br>
|
|
<div class="fragment"><pre class="fragment">
|
|
> grib_ls -w levType!=pl ../tigge_pf_ecmwf.grib2
|
|
</pre></div><br>
|
|
</li></ol>
|
|
<hr size="1"><address style="text-align: right;"><small>Generated on Tue Sep 22 15:18:22 2009 for grib_api by
|
|
<a href="http://www.doxygen.org/index.html">
|
|
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3 </small></address>
|
|
</body>
|
|
</html>
|