root/doc/html/classPF.html @ 210

Revision 210, 19.0 kB (checked in by smidl, 16 years ago)

dokumentace

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 class="current"><a href="annotated.html"><span>Classes</span></a></li>
14      <li><a href="files.html"><span>Files</span></a></li>
15    </ul>
16  </div>
17  <div class="tabs">
18    <ul>
19      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
20      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
21      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
22    </ul>
23  </div>
24</div>
25<div class="contents">
26<h1>PF Class Reference</h1><!-- doxytag: class="PF" --><!-- doxytag: inherits="BM" -->Trivial particle filter with proposal density equal to parameter evolution model. 
27<a href="#_details">More...</a>
28<p>
29<code>#include &lt;<a class="el" href="libPF_8h-source.html">libPF.h</a>&gt;</code>
30<p>
31<div class="dynheader">
32Inheritance diagram for PF:</div>
33<div class="dynsection">
34<p><center><img src="classPF__inherit__graph.png" border="0" usemap="#PF__inherit__map" alt="Inheritance graph"></center>
35<map name="PF__inherit__map">
36<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>
37<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
38<div class="dynheader">
39Collaboration diagram for PF:</div>
40<div class="dynsection">
41<p><center><img src="classPF__coll__graph.png" border="0" usemap="#PF__coll__map" alt="Collaboration graph"></center>
42<map name="PF__coll__map">
43<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>
44<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
45
46<p>
47<a href="classPF-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
48<tr><td></td></tr>
49<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
50<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)" -->
51&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>
52
53<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Default constructor. <br></td></tr>
54<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)" -->
55void&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>
56
57<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set posterior density by sampling from epdf0. <br></td></tr>
58<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>
59
60<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Incremental Bayes rule.  <a href="#64f636bbd63bea9efd778214e6b631d3"></a><br></td></tr>
61<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)" -->
62virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#0186270f75189677f390fe088a9947e9">bayesB</a> (const mat &amp;Dt)</td></tr>
63
64<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Batch Bayes rule (columns of Dt are observations). <br></td></tr>
65<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8554809fec160bee279bcd5fa14ead5c"></a><!-- doxytag: member="PF::_epdf" ref="8554809fec160bee279bcd5fa14ead5c" args="() const =0" -->
66virtual 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>
67
68<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>
69<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="db500c4836f883c175a3cf3ab5a3ce24"></a><!-- doxytag: member="PF::_e" ref="db500c4836f883c175a3cf3ab5a3ce24" args="() const =0" -->
70virtual 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>
71
72<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>
73<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>
74
75<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 " -->
76vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#cd0660f2a1a344b56ac39802708ff165">logpred_m</a> (const mat &amp;dt) const </td></tr>
77
78<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Matrix version of logpred. <br></td></tr>
79<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 " -->
80virtual <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>
81
82<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Constructs a predictive density (marginal density on data). <br></td></tr>
83<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="126bd2595c48e311fc2a7ab72876092a"></a><!-- doxytag: member="PF::_rv" ref="126bd2595c48e311fc2a7ab72876092a" args="() const " -->
84const <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>
85
86<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">access function <br></td></tr>
87<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="87f4a547d2c29180be88175e5eab9c88"></a><!-- doxytag: member="PF::_ll" ref="87f4a547d2c29180be88175e5eab9c88" args="() const " -->
88double&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#87f4a547d2c29180be88175e5eab9c88">_ll</a> () const </td></tr>
89
90<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">access function <br></td></tr>
91<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)" -->
92void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#1ffa9f23669aabecc3760c06c6987522">set_evalll</a> (bool evl0)</td></tr>
93
94<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">access function <br></td></tr>
95<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>
96
97<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
98<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2c2f44ed7a4eaa42e07bdb58d503f280"></a><!-- doxytag: member="PF::n" ref="2c2f44ed7a4eaa42e07bdb58d503f280" args="" -->
99int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#2c2f44ed7a4eaa42e07bdb58d503f280">n</a></td></tr>
100
101<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">number of particles; <br></td></tr>
102<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="1a0a09e309da997f63ae8e30d1e9806b"></a><!-- doxytag: member="PF::est" ref="1a0a09e309da997f63ae8e30d1e9806b" args="" -->
103<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>
104
105<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">posterior density <br></td></tr>
106<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5c87aba508df321ff26536ced64dbb3a"></a><!-- doxytag: member="PF::_w" ref="5c87aba508df321ff26536ced64dbb3a" args="" -->
107vec &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#5c87aba508df321ff26536ced64dbb3a">_w</a></td></tr>
108
109<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>
110<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="cf7dad75e31215780a746c30e71ad9c5"></a><!-- doxytag: member="PF::_samples" ref="cf7dad75e31215780a746c30e71ad9c5" args="" -->
111Array&lt; vec &gt; &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPF.html#cf7dad75e31215780a746c30e71ad9c5">_samples</a></td></tr>
112
113<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>
114<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d92ac103f88f8c21e197e90af5695a09"></a><!-- doxytag: member="PF::par" ref="d92ac103f88f8c21e197e90af5695a09" args="" -->
115<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>
116
117<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Parameter evolution model. <br></td></tr>
118<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="dd0a687a4515333d6809147335854e77"></a><!-- doxytag: member="PF::obs" ref="dd0a687a4515333d6809147335854e77" args="" -->
119<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>
120
121<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Observation model. <br></td></tr>
122<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="af00f0612fabe66241dd507188cdbf88"></a><!-- doxytag: member="PF::rv" ref="af00f0612fabe66241dd507188cdbf88" args="" -->
123<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>
124
125<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Random variable of the posterior. <br></td></tr>
126<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5623fef6572a08c2b53b8c87b82dc979"></a><!-- doxytag: member="PF::ll" ref="5623fef6572a08c2b53b8c87b82dc979" args="" -->
127double&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#5623fef6572a08c2b53b8c87b82dc979">ll</a></td></tr>
128
129<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Logarithm of marginalized data likelihood. <br></td></tr>
130<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="bf6fb59b30141074f8ee1e2f43d03129"></a><!-- doxytag: member="PF::evalll" ref="bf6fb59b30141074f8ee1e2f43d03129" args="" -->
131bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classBM.html#bf6fb59b30141074f8ee1e2f43d03129">evalll</a></td></tr>
132
133<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>
134</table>
135<hr><a name="_details"></a><h2>Detailed Description</h2>
136Trivial particle filter with proposal density equal to parameter evolution model.
137<p>
138Posterior 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>
139<a class="anchor" name="64f636bbd63bea9efd778214e6b631d3"></a><!-- doxytag: member="PF::bayes" ref="64f636bbd63bea9efd778214e6b631d3" args="(const vec &amp;dt)" -->
140<div class="memitem">
141<div class="memproto">
142      <table class="memname">
143        <tr>
144          <td class="memname">void PF::bayes           </td>
145          <td>(</td>
146          <td class="paramtype">const vec &amp;&nbsp;</td>
147          <td class="paramname"> <em>dt</em>          </td>
148          <td>&nbsp;)&nbsp;</td>
149          <td><code> [virtual]</code></td>
150        </tr>
151      </table>
152</div>
153<div class="memdoc">
154
155<p>
156Incremental Bayes rule.
157<p>
158<dl compact><dt><b>Parameters:</b></dt><dd>
159  <table border="0" cellspacing="2" cellpadding="0">
160    <tr><td valign="top"></td><td valign="top"><em>dt</em>&nbsp;</td><td>vector of input data </td></tr>
161  </table>
162</dl>
163
164<p>Implements <a class="el" href="classBM.html#a892eff438aab2dd1a9e2efcb7fb5bdf">BM</a>.</p>
165
166<p>Reimplemented in <a class="el" href="classMPF.html#55daf8e4b6553dd9f47c692de7931623">MPF&lt; BM_T &gt;</a>.</p>
167
168<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#l00232">mpdf::evalcond()</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#l00161">eEmp::resample()</a>, and <a class="el" href="libBM_8h-source.html#l00216">mpdf::samplecond()</a>.</p>
169
170</div>
171</div><p>
172<a class="anchor" name="8a8ce6df431689964c41cc6c849cfd06"></a><!-- doxytag: member="PF::logpred" ref="8a8ce6df431689964c41cc6c849cfd06" args="(const vec &amp;dt) const " -->
173<div class="memitem">
174<div class="memproto">
175      <table class="memname">
176        <tr>
177          <td class="memname">virtual double BM::logpred           </td>
178          <td>(</td>
179          <td class="paramtype">const vec &amp;&nbsp;</td>
180          <td class="paramname"> <em>dt</em>          </td>
181          <td>&nbsp;)&nbsp;</td>
182          <td> const<code> [inline, virtual, inherited]</code></td>
183        </tr>
184      </table>
185</div>
186<div class="memdoc">
187
188<p>
189Evaluates predictive log-likelihood of the given data record I.e. marginal likelihood of the data with the posterior integrated out.
190<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>
191
192<p>Referenced by <a class="el" href="libBM_8h-source.html#l00428">BM::logpred_m()</a>.</p>
193
194</div>
195</div><p>
196<a class="anchor" name="eb58c81d6a7b75b05fc6f276eed78887"></a><!-- doxytag: member="PF::_copy_" ref="eb58c81d6a7b75b05fc6f276eed78887" args="(bool changerv=false)" -->
197<div class="memitem">
198<div class="memproto">
199      <table class="memname">
200        <tr>
201          <td class="memname">virtual <a class="el" href="classBM.html">BM</a>* BM::_copy_           </td>
202          <td>(</td>
203          <td class="paramtype">bool&nbsp;</td>
204          <td class="paramname"> <em>changerv</em> = <code>false</code>          </td>
205          <td>&nbsp;)&nbsp;</td>
206          <td><code> [inline, virtual, inherited]</code></td>
207        </tr>
208      </table>
209</div>
210<div class="memdoc">
211
212<p>
213Copy 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; }
214<p>Reimplemented in <a class="el" href="classARX.html#5de61fbd4f97fa3216760b1f733f5af0">ARX</a>, and <a class="el" href="classBMEF.html#97f5312efe4a5bedb86d2daec59d8651">BMEF</a>.</p>
215
216</div>
217</div><p>
218<hr>The documentation for this class was generated from the following files:<ul>
219<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>
220</div>
221<hr size="1"><address style="text-align: right;"><small>Generated on Wed Nov 12 19:18:56 2008 for mixpp by&nbsp;
222<a href="http://www.doxygen.org/index.html">
223<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
224</body>
225</html>
Note: See TracBrowser for help on using the browser.