root/doc/html/classbdm_1_1emix.html @ 270

Revision 270, 18.7 kB (checked in by smidl, 16 years ago)

Changes in the very root classes!
* rv and rvc are no longer compulsory,
* samplecond does not return ll
* BM has drv

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: bdm::emix 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><a href="namespaces.html"><span>Namespaces</span></a></li>
15      <li class="current"><a href="classes.html"><span>Classes</span></a></li>
16      <li><a href="files.html"><span>Files</span></a></li>
17    </ul>
18  </div>
19  <div class="tabs">
20    <ul>
21      <li><a href="classes.html"><span>Alphabetical&nbsp;List</span></a></li>
22      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
23      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
24      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
25    </ul>
26  </div>
27  <div class="navpath"><a class="el" href="namespacebdm.html">bdm</a>::<a class="el" href="classbdm_1_1emix.html">emix</a>
28  </div>
29</div>
30<div class="contents">
31<h1>bdm::emix Class Reference</h1><!-- doxytag: class="bdm::emix" --><!-- doxytag: inherits="bdm::epdf" --><code>#include &lt;<a class="el" href="emix_8h-source.html">emix.h</a>&gt;</code>
32<p>
33<div class="dynheader">
34Inheritance diagram for bdm::emix:</div>
35<div class="dynsection">
36<p><center><img src="classbdm_1_1emix__inherit__graph.png" border="0" usemap="#bdm_1_1emix__inherit__map" alt="Inheritance graph"></center>
37<map name="bdm_1_1emix__inherit__map">
38<area shape="rect" href="classbdm_1_1epdf.html" title="Probability density function with numerical statistics, e.g. posterior density." alt="" coords="19,84,104,111"><area shape="rect" href="classbdm_1_1bdmroot.html" title="Root class of BDM objects." alt="" coords="5,7,117,33"></map>
39<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
40
41<p>
42<a href="classbdm_1_1emix-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
43Mixture of epdfs.
44<p>
45Density function: <p class="formulaDsp">
46<img class="formulaDsp" alt="\[ f(x) = \sum_{i=1}^{n} w_{i} f_i(x), \quad \sum_{i=1}^n w_i = 1. \]" src="form_63.png">
47<p>
48 where <img class="formulaInl" alt="$f_i(x)$" src="form_64.png"> is any density on random variable <img class="formulaInl" alt="$x$" src="form_28.png">, called <em>component</em>, <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="4838f3a376ee0bd3c658bfb8f4ea4a3d"></a><!-- doxytag: member="bdm::emix::emix" ref="4838f3a376ee0bd3c658bfb8f4ea4a3d" args="()" -->
52&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#4838f3a376ee0bd3c658bfb8f4ea4a3d">emix</a> ()</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">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#d8c1aefba8302759836b5f26999ce840">set_parameters</a> (const vec &amp;<a class="el" href="classbdm_1_1emix.html#bb7270345c76da627cd77ddf020bcf46">w</a>, const Array&lt; <a class="el" href="classbdm_1_1epdf.html">epdf</a> * &gt; &amp;<a class="el" href="classbdm_1_1emix.html#e2966a6a44b250e22e55bc9fb6af5c3e">Coms</a>, bool copy=true)</td></tr>
56
57<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e8839dbbb0d1276a8dbe957a67cfe0dc"></a><!-- doxytag: member="bdm::emix::sample" ref="e8839dbbb0d1276a8dbe957a67cfe0dc" args="() const " -->
58vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#e8839dbbb0d1276a8dbe957a67cfe0dc">sample</a> () const </td></tr>
59
60<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns a sample, <img class="formulaInl" alt="$ x $" src="form_106.png"> from density <img class="formulaInl" alt="$ f_x()$" src="form_107.png">. <br></td></tr>
61<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a3a5390bc56e81ef3b0debc0f185fa8a"></a><!-- doxytag: member="bdm::emix::mean" ref="a3a5390bc56e81ef3b0debc0f185fa8a" args="() const " -->
62vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#a3a5390bc56e81ef3b0debc0f185fa8a">mean</a> () const </td></tr>
63
64<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">return expected value <br></td></tr>
65<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e9a627023cdf90c9ffd8eef726595c86"></a><!-- doxytag: member="bdm::emix::variance" ref="e9a627023cdf90c9ffd8eef726595c86" args="() const " -->
66vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#e9a627023cdf90c9ffd8eef726595c86">variance</a> () const </td></tr>
67
68<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">return expected variance (not covariance!) <br></td></tr>
69<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0f3db99f730bde6b7953931594537e8e"></a><!-- doxytag: member="bdm::emix::evallog" ref="0f3db99f730bde6b7953931594537e8e" args="(const vec &amp;val) const " -->
70double&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#0f3db99f730bde6b7953931594537e8e">evallog</a> (const vec &amp;val) const </td></tr>
71
72<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Compute log-probability of argument <code>val</code>. <br></td></tr>
73<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="23af1986e2afcbc8c7e1c30f610e703b"></a><!-- doxytag: member="bdm::emix::evallog_m" ref="23af1986e2afcbc8c7e1c30f610e703b" args="(const mat &amp;Val) const " -->
74vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#23af1986e2afcbc8c7e1c30f610e703b">evallog_m</a> (const mat &amp;Val) const </td></tr>
75
76<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Compute log-probability of multiple values argument <code>val</code>. <br></td></tr>
77<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e64c1d5a73f541e469792e23d4677af2"></a><!-- doxytag: member="bdm::emix::evallog_M" ref="e64c1d5a73f541e469792e23d4677af2" args="(const mat &amp;Val) const " -->
78mat&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#e64c1d5a73f541e469792e23d4677af2">evallog_M</a> (const mat &amp;Val) const </td></tr>
79
80<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Auxiliary function that returns pdflog for each component. <br></td></tr>
81<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f7165371cc4f7be9292024b9f5431646"></a><!-- doxytag: member="bdm::emix::marginal" ref="f7165371cc4f7be9292024b9f5431646" args="(const RV &amp;rv) const " -->
82<a class="el" href="classbdm_1_1emix.html">emix</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#f7165371cc4f7be9292024b9f5431646">marginal</a> (const <a class="el" href="classbdm_1_1RV.html">RV</a> &amp;<a class="el" href="classbdm_1_1epdf.html#62c5b8ff71d9ebe6cd58d3c342eb1dc8">rv</a>) const </td></tr>
83
84<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Return marginal density on the given <a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">RV</a>, the remainig rvs are intergrated out. <br></td></tr>
85<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="fc7772a2972959cf19ba26882feacecf"></a><!-- doxytag: member="bdm::emix::condition" ref="fc7772a2972959cf19ba26882feacecf" args="(const RV &amp;rv) const " -->
86<a class="el" href="classbdm_1_1mratio.html">mratio</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#fc7772a2972959cf19ba26882feacecf">condition</a> (const <a class="el" href="classbdm_1_1RV.html">RV</a> &amp;<a class="el" href="classbdm_1_1epdf.html#62c5b8ff71d9ebe6cd58d3c342eb1dc8">rv</a>) const </td></tr>
87
88<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Return conditional density on the given <a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">RV</a>, the remaining rvs will be in conditioning. <br></td></tr>
89<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d9b584cb5b2471a4250fb127757f28be"></a><!-- doxytag: member="bdm::emix::_w" ref="d9b584cb5b2471a4250fb127757f28be" args="()" -->
90vec &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#d9b584cb5b2471a4250fb127757f28be">_w</a> ()</td></tr>
91
92<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">returns a pointer to the internal mean value. Use with Care! <br></td></tr>
93<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="965fb16669250a3d28bc62cf76276d8e"></a><!-- doxytag: member="bdm::emix::ownComs" ref="965fb16669250a3d28bc62cf76276d8e" args="()" -->
94void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#965fb16669250a3d28bc62cf76276d8e">ownComs</a> ()</td></tr>
95
96<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Auxiliary function for taking ownership of the <a class="el" href="classbdm_1_1emix.html#e2966a6a44b250e22e55bc9fb6af5c3e" title="Component (epdfs).">Coms()</a>. <br></td></tr>
97<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="578616445243674438257be99ba71612"></a><!-- doxytag: member="bdm::emix::_Coms" ref="578616445243674438257be99ba71612" args="(int i)" -->
98<a class="el" href="classbdm_1_1epdf.html">epdf</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#578616445243674438257be99ba71612">_Coms</a> (int i)</td></tr>
99
100<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">access function <br></td></tr>
101<tr><td colspan="2"><div class="groupHeader">Matematical Operations</div></td></tr>
102<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b4cf45fd83cc7573ede9fe1215256058"></a><!-- doxytag: member="bdm::emix::sample_m" ref="b4cf45fd83cc7573ede9fe1215256058" args="(int N) const " -->
103virtual mat&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1epdf.html#b4cf45fd83cc7573ede9fe1215256058">sample_m</a> (int N) const </td></tr>
104
105<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns N samples, <img class="formulaInl" alt="$ [x_1 , x_2 , \ldots \ $" src="form_108.png"> from density <img class="formulaInl" alt="$ f_x(rv)$" src="form_109.png">. <br></td></tr>
106<tr><td colspan="2"><div class="groupHeader">Connection to other classes</div></td></tr>
107<tr><td colspan="2"><div class="groupText">Description of the random quantity via attribute <code>rv</code> is optional. For operations such as sampling <code>rv</code> does not need to be set. However, for <code>marginalization</code> and <code>conditioning</code> <code>rv</code> has to be set. NB: <br><br></div></td></tr>
108<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f423e28448dbb69ef4905295ec8de8ff"></a><!-- doxytag: member="bdm::emix::set_rv" ref="f423e28448dbb69ef4905295ec8de8ff" args="(const RV &amp;rv0)" -->
109void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1epdf.html#f423e28448dbb69ef4905295ec8de8ff">set_rv</a> (const <a class="el" href="classbdm_1_1RV.html">RV</a> &amp;rv0)</td></tr>
110
111<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Name its rv. <br></td></tr>
112<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="c4b863ff84c7a4882fb3ad18556027f9"></a><!-- doxytag: member="bdm::emix::isnamed" ref="c4b863ff84c7a4882fb3ad18556027f9" args="() const " -->
113bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1epdf.html#c4b863ff84c7a4882fb3ad18556027f9">isnamed</a> () const </td></tr>
114
115<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">True if rv is assigned. <br></td></tr>
116<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a4ab378d5e004c3ff3e2d4e64f7bba21"></a><!-- doxytag: member="bdm::emix::_rv" ref="a4ab378d5e004c3ff3e2d4e64f7bba21" args="() const " -->
117const <a class="el" href="classbdm_1_1RV.html">RV</a> &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1epdf.html#a4ab378d5e004c3ff3e2d4e64f7bba21">_rv</a> () const </td></tr>
118
119<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Return name (fails when isnamed is false). <br></td></tr>
120<tr><td colspan="2"><div class="groupHeader">Access to attributes</div></td></tr>
121<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="46dfe100cd621716ee5c7ee25a20f24b"></a><!-- doxytag: member="bdm::emix::dimension" ref="46dfe100cd621716ee5c7ee25a20f24b" args="() const " -->
122bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1epdf.html#46dfe100cd621716ee5c7ee25a20f24b">dimension</a> () const </td></tr>
123
124<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Size of the random variable. <br></td></tr>
125<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
126<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="bb7270345c76da627cd77ddf020bcf46"></a><!-- doxytag: member="bdm::emix::w" ref="bb7270345c76da627cd77ddf020bcf46" args="" -->
127vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#bb7270345c76da627cd77ddf020bcf46">w</a></td></tr>
128
129<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">weights of the components <br></td></tr>
130<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e2966a6a44b250e22e55bc9fb6af5c3e"></a><!-- doxytag: member="bdm::emix::Coms" ref="e2966a6a44b250e22e55bc9fb6af5c3e" args="" -->
131Array&lt; <a class="el" href="classbdm_1_1epdf.html">epdf</a> * &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#e2966a6a44b250e22e55bc9fb6af5c3e">Coms</a></td></tr>
132
133<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Component (epdfs). <br></td></tr>
134<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="47189df41a4616c2fed5972f015743f4"></a><!-- doxytag: member="bdm::emix::destroyComs" ref="47189df41a4616c2fed5972f015743f4" args="" -->
135bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1emix.html#47189df41a4616c2fed5972f015743f4">destroyComs</a></td></tr>
136
137<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Flag if owning Coms. <br></td></tr>
138<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="16adac20ec7fe07e1ea0b27d917788ce"></a><!-- doxytag: member="bdm::emix::dim" ref="16adac20ec7fe07e1ea0b27d917788ce" args="" -->
139int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1epdf.html#16adac20ec7fe07e1ea0b27d917788ce">dim</a></td></tr>
140
141<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">dimension of the random variable <br></td></tr>
142<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="62c5b8ff71d9ebe6cd58d3c342eb1dc8"></a><!-- doxytag: member="bdm::emix::rv" ref="62c5b8ff71d9ebe6cd58d3c342eb1dc8" args="" -->
143<a class="el" href="classbdm_1_1RV.html">RV</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbdm_1_1epdf.html#62c5b8ff71d9ebe6cd58d3c342eb1dc8">rv</a></td></tr>
144
145<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Description of the random variable. <br></td></tr>
146</table>
147<hr><h2>Member Function Documentation</h2>
148<a class="anchor" name="d8c1aefba8302759836b5f26999ce840"></a><!-- doxytag: member="bdm::emix::set_parameters" ref="d8c1aefba8302759836b5f26999ce840" args="(const vec &amp;w, const Array&lt; epdf * &gt; &amp;Coms, bool copy=true)" -->
149<div class="memitem">
150<div class="memproto">
151      <table class="memname">
152        <tr>
153          <td class="memname">void bdm::emix::set_parameters           </td>
154          <td>(</td>
155          <td class="paramtype">const vec &amp;&nbsp;</td>
156          <td class="paramname"> <em>w</em>, </td>
157        </tr>
158        <tr>
159          <td class="paramkey"></td>
160          <td></td>
161          <td class="paramtype">const Array&lt; <a class="el" href="classbdm_1_1epdf.html">epdf</a> * &gt; &amp;&nbsp;</td>
162          <td class="paramname"> <em>Coms</em>, </td>
163        </tr>
164        <tr>
165          <td class="paramkey"></td>
166          <td></td>
167          <td class="paramtype">bool&nbsp;</td>
168          <td class="paramname"> <em>copy</em> = <code>true</code></td><td>&nbsp;</td>
169        </tr>
170        <tr>
171          <td></td>
172          <td>)</td>
173          <td></td><td></td><td></td>
174        </tr>
175      </table>
176</div>
177<div class="memdoc">
178
179<p>
180Set weights <code>w</code> and components <code>Coms</code> By default Coms are copied inside. Parameter <code>copy</code> can be set to false if Coms live externally. Use method <a class="el" href="classbdm_1_1emix.html#965fb16669250a3d28bc62cf76276d8e" title="Auxiliary function for taking ownership of the Coms().">ownComs()</a> if Coms should be destroyed by the destructor.
181<p>References <a class="el" href="libBM_8h-source.html#l00265">bdm::epdf::_rv()</a>, <a class="el" href="emix_8h-source.html#l00093">Coms</a>, <a class="el" href="emix_8h-source.html#l00095">destroyComs</a>, <a class="el" href="libBM_8h-source.html#l00212">bdm::epdf::dim</a>, <a class="el" href="libBM_8cpp-source.html#l00093">bdm::RV::equal()</a>, <a class="el" href="libBM_8h-source.html#l00214">bdm::epdf::rv</a>, and <a class="el" href="emix_8h-source.html#l00091">w</a>.</p>
182
183<p>Referenced by <a class="el" href="mixef_8cpp-source.html#l00134">bdm::MixEF::epredictor()</a>, <a class="el" href="emix_8cpp-source.html#l00037">marginal()</a>, and <a class="el" href="emix_8h-source.html#l00299">bdm::mmix::set_parameters()</a>.</p>
184
185</div>
186</div><p>
187<hr>The documentation for this class was generated from the following files:<ul>
188<li><a class="el" href="emix_8h-source.html">emix.h</a><li>emix.cpp</ul>
189</div>
190<hr size="1"><address style="text-align: right;"><small>Generated on Wed Feb 11 23:34:03 2009 for mixpp by&nbsp;
191<a href="http://www.doxygen.org/index.html">
192<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
193</body>
194</html>
Note: See TracBrowser for help on using the browser.