/usr/share/doc/libdballe-doc/c_api/msg_8h.html is in libdballe-doc 5.10-1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libdballe: msg.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.4 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libdballe <span id="projectnumber">5.10</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">msg.h File Reference</div> </div>
</div>
<div class="contents">
<p>Abstraction for a weather report message which is independent from the encoding, used to make sense of decoded information and to carry data between the various import and export modules of DB-ALLe.
<a href="#details">More...</a></p>
<div class="textblock"><code>#include <<a class="el" href="var_8h_source.html">dballe/core/var.h</a>></code><br/>
<code>#include <<a class="el" href="defs_8h_source.html">dballe/core/defs.h</a>></code><br/>
<code>#include <dballe/core/matcher.h></code><br/>
<code>#include <<a class="el" href="vars_8h_source.html">dballe/msg/vars.h</a>></code><br/>
<code>#include <stdio.h></code><br/>
<code>#include <vector></code><br/>
<code>#include <memory></code><br/>
<code>#include <iosfwd></code><br/>
<code>#include <dballe/msg/msg-extravars.h></code><br/>
</div>
<p><a href="msg_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classdballe_1_1Msg.html">dballe::Msg</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Storage for related physical data. <a href="classdballe_1_1Msg.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structdballe_1_1MsgConsumer.html">dballe::MsgConsumer</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Consumer interface used to stream messages as they are produced. <a href="structdballe_1_1MsgConsumer.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structdballe_1_1MatchedMsg.html">dballe::MatchedMsg</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Match adapter for <a class="el" href="classdballe_1_1Msg.html" title="Storage for related physical data.">Msg</a>. <a href="structdballe_1_1MatchedMsg.html#details">More...</a><br/></td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><b>MsgType</b> { <br/>
  <a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a07dfb8222dc5e489b766d9a150f2448f">dballe::MSG_GENERIC</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13abcf1d72ea875e91bb2df47384f75c3e1">dballe::MSG_SYNOP</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13ae3418dc0d019f4d29be93d3942b0a3c3">dballe::MSG_PILOT</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a9de243d4cb8ce13a8961affeb275b4d4">dballe::MSG_TEMP</a>,
<br/>
  <a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13aade610261cf4767c2f3f5d8c4754c2b7">dballe::MSG_TEMP_SHIP</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13afcdd543a555031e294738a0a642dbf57">dballe::MSG_AIREP</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a9d17666b62fd46e6b1001df1299552c2">dballe::MSG_AMDAR</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a944db73a463433c7124213d78982e39d">dballe::MSG_ACARS</a>,
<br/>
  <a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a18a88d48708490c361b90daf70eb2f07">dballe::MSG_SHIP</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a8f9443986d8435aa807d7bd16c7c4737">dballe::MSG_BUOY</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a89bf19161b5e76a7d4aeb0451743785f">dballe::MSG_METAR</a>,
<a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13ac3a9723940192d3539865b6919b58b20">dballe::MSG_SAT</a>,
<br/>
  <a class="el" href="namespacedballe.html#a5f30665a6599aeda99b81a1eda439c13a2a3808237588cb777d1d26e182c671d9">dballe::MSG_POLLUTION</a>
<br/>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Source of the data. <br/></td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="namespacedballe.html#ac89531037ee7f4a1545bb461f97538aa">dballe::msg_type_name</a> (MsgType type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return a string with the name of a dba_msg_type. <a href="#ac89531037ee7f4a1545bb461f97538aa"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Abstraction for a weather report message which is independent from the encoding, used to make sense of decoded information and to carry data between the various import and export modules of DB-ALLe. </p>
<p>The internal representation is as connected as possible to physics rather than to observations. dba_msg is a container for related weather information, stored in a nonambiguous way.</p>
<p>To understand what is the difference betwee ::dba_msg and other ways of representing weather data, it is important to keep in mind how a value is usually defined in the various encodings:</p>
<ul>
<li>by previous values and position, as in the AOF encoding </li>
<li>by previous values, data descriptor and sometimes position, as in the BUFR encoding </li>
<li>by measure type and physical coordinates, as in ::dba_msg and the DB-ALLe database</li>
</ul>
<p>::dba_msg contains values as tuples (variable, level layer, time range).</p>
<p>The variable is represented by a dba_var. The dba_varcode of the dba_var refers to a local B table which lists physical measurements unambiguously.</p>
<p>Level layer is a triple (level type, l1, l2) and time range is a triple (pindicator, p1, p2). The values of these two triples follow what is used in the GRIB encoding plus some local extensions, and an explanation of their possible value is found in the document "DB-ALLe Guide of the Fortran API".</p>
<p>Importers and exporters have to implement a mapping between their representation and the unambiguous physical representation. Luckily this is necessarily possible, because the ultimate purpose of the various message encodings is to correctly transmit those physical data.</p>
<p>Since to work with the full physical coordinates one needs to specify a lot of different parameters in order to identify a value (BLocal value, level layer, time range), there is a <a class="el" href="var_8h.html" title="Implement ::dba_var, an encapsulation of a measured variable.">var.h</a> module available with shortcut functions to the values that are used more commonly. </p>
</div></div>
<hr class="footer"/><address class="footer"><small>Generated on Fri Nov 18 2011 13:18:10 for libdballe by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address>
</body>
</html>
|