1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
<!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>
|
