root/doc/html/classPF.html @ 219

Revision 219, 19.1 kB (checked in by smidl, 16 years ago)

doc

Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3<title>mixpp: PF Class Reference</title>
4<link href="doxygen.css" rel="stylesheet" type="text/css">
5<link href="tabs.css" rel="stylesheet" type="text/css">
6</head><body>
7<!-- Generated by Doxygen 1.5.6 -->
8<div class="navigation" id="top">
9  <div class="tabs">
10    <ul>
11      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
12      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
13      <li><a href="modules.html"><span>Modules</span></a></li>
14      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
15      <li><a href="files.html"><span>Files</span></a></li>
16    </ul>
17  </div>
18  <div class="tabs">
19    <ul>
20      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
21      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
22      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
23    </ul>
24  </div>
25</div>
26<div class="contents">
27<h1>PF Class Reference</h1><!-- doxytag: class="PF" --><!-- doxytag: inherits="BM" -->Trivial particle filter with proposal density equal to parameter evolution model. 
28<a href="#_details">More...</a>
29<p>
30<code>#include &lt;<a class="el" href="libPF_8h-source.html">libPF.h</a>&gt;</code>
31<p>
32<div class="dynheader">
33Inheritance diagram for PF:</div>
34<div class="dynsection">
35<p><center><img src="classPF__inherit__graph.png" border="0" usemap="#PF__inherit__map" alt="Inheritance graph"></center>
36<map name="PF__inherit__map">
37<area shape="rect" href="classMPF.html" title="Marginalized Particle filter." alt="" coords="5,156,112,180"><area shape="rect" href="classBM.html" title="Bayesian Model of the world, i.e. all uncertainty is modeled by probabilities." alt="" coords="39,7,79,31"></map>
38<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
39<div class="dynheader">
40Collaboration diagram for PF:</div>
41<div class="dynsection">
42<p><center><img src="classPF__coll__graph.png" border="0" usemap="#PF__coll__map" alt="Collaboration graph"></center>
43<map name="PF__coll__map">
44<area shape="rect" href="classBM.html" title="Bayesian Model of the world, i.e. all uncertainty is modeled by probabilities." alt="" coords="5,148,45,172"><area shape="rect" href="classRV.html" title="Class representing variables, most often random variables." alt="" coords="68,6,105,30"><area shape="rect" href="classmpdf.html" title="Conditional probability density, e.g. modeling some dependencies." alt="" coords="63,198,113,222"><area shape="rect" href="classepdf.html" title="Probability density function with numerical statistics, e.g. posterior density." alt="" coords="128,96,173,120"><area shape="rect" href="classeEmp.html" title="Weighted empirical density." alt="" coords="137,198,193,222"></map>
45<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
46
47<p>
48<a href="classPF-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
49<tr><td></td></tr>
50<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
51<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e99f0d866721405dd281e315ecb690aa"></a><!-- doxytag: member="PF::PF" ref="e99f0d866721405dd281e315ecb690aa" args="(const RV &amp;rv0, mpdf &amp;par0, mpdf &amp;obs0, int n0)" -->
52&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#e99f0d866721405dd281e315ecb690aa">PF</a> (const <a class="el" href="classRV.html">RV</a> &amp;rv0, <a class="el" href="classmpdf.html">mpdf</a> &amp;par0, <a class="el" href="classmpdf.html">mpdf</a> &amp;obs0, int n0)</td></tr>
53
54<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Default constructor. <br></td></tr>
55<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="04d38fbcc0348b558212f530d9ec183e"></a><!-- doxytag: member="PF::set_est" ref="04d38fbcc0348b558212f530d9ec183e" args="(const epdf &amp;epdf0)" -->
56void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#04d38fbcc0348b558212f530d9ec183e">set_est</a> (const <a class="el" href="classepdf.html">epdf</a> &amp;epdf0)</td></tr>
57
58<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set posterior density by sampling from epdf0. <br></td></tr>
59<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#64f636bbd63bea9efd778214e6b631d3">bayes</a> (const vec &amp;dt)</td></tr>
60
61<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Incremental Bayes rule.  <a href="#64f636bbd63bea9efd778214e6b631d3"></a><br></td></tr>
62<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0186270f75189677f390fe088a9947e9"></a><!-- doxytag: member="PF::bayesB" ref="0186270f75189677f390fe088a9947e9" args="(const mat &amp;Dt)" -->
63virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#0186270f75189677f390fe088a9947e9">bayesB</a> (const mat &amp;Dt)</td></tr>
64
65<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Batch Bayes rule (columns of Dt are observations). <br></td></tr>
66<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8554809fec160bee279bcd5fa14ead5c"></a><!-- doxytag: member="PF::_epdf" ref="8554809fec160bee279bcd5fa14ead5c" args="() const =0" -->
67virtual const <a class="el" href="classepdf.html">epdf</a> &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#8554809fec160bee279bcd5fa14ead5c">_epdf</a> () const =0</td></tr>
68
69<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns a reference to the <a class="el" href="classepdf.html" title="Probability density function with numerical statistics, e.g. posterior density.">epdf</a> representing posterior density on parameters. <br></td></tr>
70<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="db500c4836f883c175a3cf3ab5a3ce24"></a><!-- doxytag: member="PF::_e" ref="db500c4836f883c175a3cf3ab5a3ce24" args="() const =0" -->
71virtual const <a class="el" href="classepdf.html">epdf</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#db500c4836f883c175a3cf3ab5a3ce24">_e</a> () const =0</td></tr>
72
73<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns a pointer to the <a class="el" href="classepdf.html" title="Probability density function with numerical statistics, e.g. posterior density.">epdf</a> representing posterior density on parameters. Use with care! <br></td></tr>
74<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual double&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#8a8ce6df431689964c41cc6c849cfd06">logpred</a> (const vec &amp;dt) const </td></tr>
75
76<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="cd0660f2a1a344b56ac39802708ff165"></a><!-- doxytag: member="PF::logpred_m" ref="cd0660f2a1a344b56ac39802708ff165" args="(const mat &amp;dt) const " -->
77vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#cd0660f2a1a344b56ac39802708ff165">logpred_m</a> (const mat &amp;dt) const </td></tr>
78
79<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Matrix version of logpred. <br></td></tr>
80<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5594d68ee9aa6fc8c1e79019da5c9d56"></a><!-- doxytag: member="PF::predictor" ref="5594d68ee9aa6fc8c1e79019da5c9d56" args="(const RV &amp;rv) const " -->
81virtual <a class="el" href="classepdf.html">epdf</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#5594d68ee9aa6fc8c1e79019da5c9d56">predictor</a> (const <a class="el" href="classRV.html">RV</a> &amp;<a class="el" href="classBM.html#af00f0612fabe66241dd507188cdbf88">rv</a>) const </td></tr>
82
83<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Constructs a predictive density (marginal density on data). <br></td></tr>
84<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="126bd2595c48e311fc2a7ab72876092a"></a><!-- doxytag: member="PF::_rv" ref="126bd2595c48e311fc2a7ab72876092a" args="() const " -->
85const <a class="el" href="classRV.html">RV</a> &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#126bd2595c48e311fc2a7ab72876092a">_rv</a> () const </td></tr>
86
87<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">access function <br></td></tr>
88<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="87f4a547d2c29180be88175e5eab9c88"></a><!-- doxytag: member="PF::_ll" ref="87f4a547d2c29180be88175e5eab9c88" args="() const " -->
89double&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#87f4a547d2c29180be88175e5eab9c88">_ll</a> () const </td></tr>
90
91<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">access function <br></td></tr>
92<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="1ffa9f23669aabecc3760c06c6987522"></a><!-- doxytag: member="PF::set_evalll" ref="1ffa9f23669aabecc3760c06c6987522" args="(bool evl0)" -->
93void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#1ffa9f23669aabecc3760c06c6987522">set_evalll</a> (bool evl0)</td></tr>
94
95<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">access function <br></td></tr>
96<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classBM.html">BM</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#eb58c81d6a7b75b05fc6f276eed78887">_copy_</a> (bool changerv=false)</td></tr>
97
98<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
99<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2c2f44ed7a4eaa42e07bdb58d503f280"></a><!-- doxytag: member="PF::n" ref="2c2f44ed7a4eaa42e07bdb58d503f280" args="" -->
100int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#2c2f44ed7a4eaa42e07bdb58d503f280">n</a></td></tr>
101
102<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">number of particles; <br></td></tr>
103<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="1a0a09e309da997f63ae8e30d1e9806b"></a><!-- doxytag: member="PF::est" ref="1a0a09e309da997f63ae8e30d1e9806b" args="" -->
104<a class="el" href="classeEmp.html">eEmp</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#1a0a09e309da997f63ae8e30d1e9806b">est</a></td></tr>
105
106<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">posterior density <br></td></tr>
107<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5c87aba508df321ff26536ced64dbb3a"></a><!-- doxytag: member="PF::_w" ref="5c87aba508df321ff26536ced64dbb3a" args="" -->
108vec &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#5c87aba508df321ff26536ced64dbb3a">_w</a></td></tr>
109
110<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">pointer into <code><a class="el" href="classeEmp.html" title="Weighted empirical density.">eEmp</a></code> <br></td></tr>
111<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="cf7dad75e31215780a746c30e71ad9c5"></a><!-- doxytag: member="PF::_samples" ref="cf7dad75e31215780a746c30e71ad9c5" args="" -->
112Array&lt; vec &gt; &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#cf7dad75e31215780a746c30e71ad9c5">_samples</a></td></tr>
113
114<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">pointer into <code><a class="el" href="classeEmp.html" title="Weighted empirical density.">eEmp</a></code> <br></td></tr>
115<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d92ac103f88f8c21e197e90af5695a09"></a><!-- doxytag: member="PF::par" ref="d92ac103f88f8c21e197e90af5695a09" args="" -->
116<a class="el" href="classmpdf.html">mpdf</a> &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#d92ac103f88f8c21e197e90af5695a09">par</a></td></tr>
117
118<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Parameter evolution model. <br></td></tr>
119<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="dd0a687a4515333d6809147335854e77"></a><!-- doxytag: member="PF::obs" ref="dd0a687a4515333d6809147335854e77" args="" -->
120<a class="el" href="classmpdf.html">mpdf</a> &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#dd0a687a4515333d6809147335854e77">obs</a></td></tr>
121
122<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Observation model. <br></td></tr>
123<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="af00f0612fabe66241dd507188cdbf88"></a><!-- doxytag: member="PF::rv" ref="af00f0612fabe66241dd507188cdbf88" args="" -->
124<a class="el" href="classRV.html">RV</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#af00f0612fabe66241dd507188cdbf88">rv</a></td></tr>
125
126<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Random variable of the posterior. <br></td></tr>
127<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5623fef6572a08c2b53b8c87b82dc979"></a><!-- doxytag: member="PF::ll" ref="5623fef6572a08c2b53b8c87b82dc979" args="" -->
128double&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#5623fef6572a08c2b53b8c87b82dc979">ll</a></td></tr>
129
130<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Logarithm of marginalized data likelihood. <br></td></tr>
131<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="bf6fb59b30141074f8ee1e2f43d03129"></a><!-- doxytag: member="PF::evalll" ref="bf6fb59b30141074f8ee1e2f43d03129" args="" -->
132bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#bf6fb59b30141074f8ee1e2f43d03129">evalll</a></td></tr>
133
134<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">If true, the filter will compute likelihood of the data record and store it in <code>ll</code> . Set to false if you want to save computational time. <br></td></tr>
135</table>
136<hr><a name="_details"></a><h2>Detailed Description</h2>
137Trivial particle filter with proposal density equal to parameter evolution model.
138<p>
139Posterior density is represented by a weighted empirical density (<code><a class="el" href="classeEmp.html" title="Weighted empirical density.">eEmp</a></code> ). <hr><h2>Member Function Documentation</h2>
140<a class="anchor" name="64f636bbd63bea9efd778214e6b631d3"></a><!-- doxytag: member="PF::bayes" ref="64f636bbd63bea9efd778214e6b631d3" args="(const vec &amp;dt)" -->
141<div class="memitem">
142<div class="memproto">
143      <table class="memname">
144        <tr>
145          <td class="memname">void PF::bayes           </td>
146          <td>(</td>
147          <td class="paramtype">const vec &amp;&nbsp;</td>
148          <td class="paramname"> <em>dt</em>          </td>
149          <td>&nbsp;)&nbsp;</td>
150          <td><code> [virtual]</code></td>
151        </tr>
152      </table>
153</div>
154<div class="memdoc">
155
156<p>
157Incremental Bayes rule.
158<p>
159<dl compact><dt><b>Parameters:</b></dt><dd>
160  <table border="0" cellspacing="2" cellpadding="0">
161    <tr><td valign="top"></td><td valign="top"><em>dt</em>&nbsp;</td><td>vector of input data </td></tr>
162  </table>
163</dl>
164
165<p>Implements <a class="el" href="classBM.html#a892eff438aab2dd1a9e2efcb7fb5bdf">BM</a>.</p>
166
167<p>Reimplemented in <a class="el" href="classMPF.html#55daf8e4b6553dd9f47c692de7931623">MPF&lt; BM_T &gt;</a>.</p>
168
169<p>References <a class="el" href="libPF_8h-source.html#l00040">_samples</a>, <a class="el" href="libPF_8h-source.html#l00038">_w</a>, <a class="el" href="libPF_8h-source.html#l00036">est</a>, <a class="el" href="libBM_8h-source.html#l00238">mpdf::evallogcond()</a>, <a class="el" href="libPF_8h-source.html#l00034">n</a>, <a class="el" href="libPF_8h-source.html#l00044">obs</a>, <a class="el" href="libPF_8h-source.html#l00042">par</a>, <a class="el" href="libEF_8cpp-source.html#l00162">eEmp::resample()</a>, and <a class="el" href="libBM_8h-source.html#l00222">mpdf::samplecond()</a>.</p>
170
171</div>
172</div><p>
173<a class="anchor" name="8a8ce6df431689964c41cc6c849cfd06"></a><!-- doxytag: member="PF::logpred" ref="8a8ce6df431689964c41cc6c849cfd06" args="(const vec &amp;dt) const " -->
174<div class="memitem">
175<div class="memproto">
176      <table class="memname">
177        <tr>
178          <td class="memname">virtual double BM::logpred           </td>
179          <td>(</td>
180          <td class="paramtype">const vec &amp;&nbsp;</td>
181          <td class="paramname"> <em>dt</em>          </td>
182          <td>&nbsp;)&nbsp;</td>
183          <td> const<code> [inline, virtual, inherited]</code></td>
184        </tr>
185      </table>
186</div>
187<div class="memdoc">
188
189<p>
190Evaluates predictive log-likelihood of the given data record I.e. marginal likelihood of the data with the posterior integrated out.
191<p>Reimplemented in <a class="el" href="classARX.html#e7f9e7823aec9bf7ddc3b42d9b3304c4">ARX</a>, <a class="el" href="classMixEF.html#424ca64f36d4e41de7a7e7ae921d35ea">MixEF</a>, and <a class="el" href="classmultiBM.html#13e26a61757278981fd8cac9a7ef91eb">multiBM</a>.</p>
192
193<p>Referenced by <a class="el" href="libBM_8h-source.html#l00436">BM::logpred_m()</a>.</p>
194
195</div>
196</div><p>
197<a class="anchor" name="eb58c81d6a7b75b05fc6f276eed78887"></a><!-- doxytag: member="PF::_copy_" ref="eb58c81d6a7b75b05fc6f276eed78887" args="(bool changerv=false)" -->
198<div class="memitem">
199<div class="memproto">
200      <table class="memname">
201        <tr>
202          <td class="memname">virtual <a class="el" href="classBM.html">BM</a>* BM::_copy_           </td>
203          <td>(</td>
204          <td class="paramtype">bool&nbsp;</td>
205          <td class="paramname"> <em>changerv</em> = <code>false</code>          </td>
206          <td>&nbsp;)&nbsp;</td>
207          <td><code> [inline, virtual, inherited]</code></td>
208        </tr>
209      </table>
210</div>
211<div class="memdoc">
212
213<p>
214Copy function required in vectors, Arrays of <a class="el" href="classBM.html" title="Bayesian Model of the world, i.e. all uncertainty is modeled by probabilities.">BM</a> etc. Have to be DELETED manually! Prototype: BM* <a class="el" href="classBM.html#eb58c81d6a7b75b05fc6f276eed78887">_copy_()</a>{<a class="el" href="classBM.html" title="Bayesian Model of the world, i.e. all uncertainty is modeled by probabilities.">BM</a> Tmp*=new Tmp(this*); return Tmp; }
215<p>Reimplemented in <a class="el" href="classARX.html#5de61fbd4f97fa3216760b1f733f5af0">ARX</a>, and <a class="el" href="classBMEF.html#97f5312efe4a5bedb86d2daec59d8651">BMEF</a>.</p>
216
217</div>
218</div><p>
219<hr>The documentation for this class was generated from the following files:<ul>
220<li>work/git/mixpp/bdm/estim/<a class="el" href="libPF_8h-source.html">libPF.h</a><li>work/git/mixpp/bdm/estim/libPF.cpp</ul>
221</div>
222<hr size="1"><address style="text-align: right;"><small>Generated on Thu Dec 4 14:42:27 2008 for mixpp by&nbsp;
223<a href="http://www.doxygen.org/index.html">
224<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
225</body>
226</html>
Note: See TracBrowser for help on using the browser.