root/doc/latex/classbdm_1_1eEmp.tex @ 271

Revision 271, 11.0 kB (checked in by smidl, 16 years ago)

Next major revision

RevLine 
[261]1\hypertarget{classbdm_1_1eEmp}{
2\section{bdm::eEmp Class Reference}
3\label{classbdm_1_1eEmp}\index{bdm::eEmp@{bdm::eEmp}}
4}
5{\tt \#include $<$libEF.h$>$}
6
[271]7Inheritance diagram for bdm::eEmp::\begin{figure}[H]
[261]8\begin{center}
9\leavevmode
[271]10\includegraphics[height=3cm]{classbdm_1_1eEmp}
[261]11\end{center}
12\end{figure}
[270]13
14
15\subsection{Detailed Description}
16Weighted empirical density.
17
18Used e.g. in particle filters. \subsection*{Public Member Functions}
[261]19\begin{CompactItemize}
20\item 
21\hypertarget{classbdm_1_1eEmp_82320074a9b0ad7e1bb33a6e885b65d7}{
22void \hyperlink{classbdm_1_1eEmp_82320074a9b0ad7e1bb33a6e885b65d7}{set\_\-parameters} (const vec \&w0, const \hyperlink{classbdm_1_1epdf}{epdf} $\ast$pdf0)}
23\label{classbdm_1_1eEmp_82320074a9b0ad7e1bb33a6e885b65d7}
24
25\begin{CompactList}\small\item\em Set samples and weights. \item\end{CompactList}\item 
26\hypertarget{classbdm_1_1eEmp_b62d802b8ef39f7c4dcbeb366c90951a}{
27void \hyperlink{classbdm_1_1eEmp_b62d802b8ef39f7c4dcbeb366c90951a}{set\_\-samples} (const \hyperlink{classbdm_1_1epdf}{epdf} $\ast$pdf0)}
28\label{classbdm_1_1eEmp_b62d802b8ef39f7c4dcbeb366c90951a}
29
30\begin{CompactList}\small\item\em Set sample. \item\end{CompactList}\item 
31\hypertarget{classbdm_1_1eEmp_dccd02eaa4c45e858a6351723686ac85}{
32void \hyperlink{classbdm_1_1eEmp_dccd02eaa4c45e858a6351723686ac85}{set\_\-n} (int n0, bool copy=true)}
33\label{classbdm_1_1eEmp_dccd02eaa4c45e858a6351723686ac85}
34
35\begin{CompactList}\small\item\em Set sample. \item\end{CompactList}\item 
36\hypertarget{classbdm_1_1eEmp_d7f83cc0415cd44ae7cc8b4bdad93aef}{
37vec \& \hyperlink{classbdm_1_1eEmp_d7f83cc0415cd44ae7cc8b4bdad93aef}{\_\-w} ()}
38\label{classbdm_1_1eEmp_d7f83cc0415cd44ae7cc8b4bdad93aef}
39
40\begin{CompactList}\small\item\em Potentially dangerous, use with care. \item\end{CompactList}\item 
41\hypertarget{classbdm_1_1eEmp_b7d7106f486e3fad38590914a693d714}{
42const vec \& \hyperlink{classbdm_1_1eEmp_b7d7106f486e3fad38590914a693d714}{\_\-w} () const }
43\label{classbdm_1_1eEmp_b7d7106f486e3fad38590914a693d714}
44
45\begin{CompactList}\small\item\em Potentially dangerous, use with care. \item\end{CompactList}\item 
46\hypertarget{classbdm_1_1eEmp_c24966b0aaeb767bc8a6b4fd60931be2}{
47Array$<$ vec $>$ \& \hyperlink{classbdm_1_1eEmp_c24966b0aaeb767bc8a6b4fd60931be2}{\_\-samples} ()}
48\label{classbdm_1_1eEmp_c24966b0aaeb767bc8a6b4fd60931be2}
49
50\begin{CompactList}\small\item\em access function \item\end{CompactList}\item 
51\hypertarget{classbdm_1_1eEmp_b59af0efdb009d98ea8ebfa965e74ae2}{
52const Array$<$ vec $>$ \& \hyperlink{classbdm_1_1eEmp_b59af0efdb009d98ea8ebfa965e74ae2}{\_\-samples} () const }
53\label{classbdm_1_1eEmp_b59af0efdb009d98ea8ebfa965e74ae2}
54
55\begin{CompactList}\small\item\em access function \item\end{CompactList}\item 
56\hypertarget{classbdm_1_1eEmp_f06ce255de5dbb2313f52ee51f82ba3d}{
[271]57ivec \hyperlink{classbdm_1_1eEmp_f06ce255de5dbb2313f52ee51f82ba3d}{resample} (RESAMPLING\_\-METHOD method=SYSTEMATIC)}
[261]58\label{classbdm_1_1eEmp_f06ce255de5dbb2313f52ee51f82ba3d}
59
60\begin{CompactList}\small\item\em Function performs resampling, i.e. removal of low-weight samples and duplication of high-weight samples such that the new samples represent the same density. \item\end{CompactList}\item 
61\hypertarget{classbdm_1_1eEmp_97f1e07b5ae6eebc91c7365f0f88d270}{
62vec \hyperlink{classbdm_1_1eEmp_97f1e07b5ae6eebc91c7365f0f88d270}{sample} () const }
63\label{classbdm_1_1eEmp_97f1e07b5ae6eebc91c7365f0f88d270}
64
65\begin{CompactList}\small\item\em inherited operation : NOT implemneted \item\end{CompactList}\item 
66\hypertarget{classbdm_1_1eEmp_01654c014d3aa068f8d4ecba4be86d09}{
67double \hyperlink{classbdm_1_1eEmp_01654c014d3aa068f8d4ecba4be86d09}{evallog} (const vec \&val) const }
68\label{classbdm_1_1eEmp_01654c014d3aa068f8d4ecba4be86d09}
69
70\begin{CompactList}\small\item\em inherited operation : NOT implemneted \item\end{CompactList}\item 
71\hypertarget{classbdm_1_1eEmp_bbfcb4f868c7381298c281a256d8c4b9}{
72vec \hyperlink{classbdm_1_1eEmp_bbfcb4f868c7381298c281a256d8c4b9}{mean} () const }
73\label{classbdm_1_1eEmp_bbfcb4f868c7381298c281a256d8c4b9}
74
75\begin{CompactList}\small\item\em return expected value \item\end{CompactList}\item 
76\hypertarget{classbdm_1_1eEmp_05e9ebf467ede737cb6a3621d7fd3c87}{
77vec \hyperlink{classbdm_1_1eEmp_05e9ebf467ede737cb6a3621d7fd3c87}{variance} () const }
78\label{classbdm_1_1eEmp_05e9ebf467ede737cb6a3621d7fd3c87}
79
[270]80\begin{CompactList}\small\item\em return expected variance (not covariance!) \item\end{CompactList}\end{CompactItemize}
[271]81\begin{Indent}{\bf Constructors}\par
82\begin{CompactItemize}
83\item 
84\hypertarget{classbdm_1_1eEmp_dc232a73b38c9f9688bc4f981eaa0312}{
85\textbf{eEmp} ()}
86\label{classbdm_1_1eEmp_dc232a73b38c9f9688bc4f981eaa0312}
87
88\item 
89\hypertarget{classbdm_1_1eEmp_a3daf6363455af099921715e1233c076}{
90\textbf{eEmp} (const \hyperlink{classbdm_1_1eEmp}{eEmp} \&e)}
91\label{classbdm_1_1eEmp_a3daf6363455af099921715e1233c076}
92
93\end{CompactItemize}
94\end{Indent}
95\begin{Indent}{\bf Constructors}\par
96{\em Construction of each \hyperlink{classbdm_1_1epdf}{epdf} should support two types of constructors: \begin{itemize}
97\item empty constructor, \item copy constructor,\end{itemize}
98The following constructors should be supported for convenience: \begin{itemize}
99\item constructor followed by calling {\tt \hyperlink{classbdm_1_1eEmp_82320074a9b0ad7e1bb33a6e885b65d7}{set\_\-parameters()}} \item constructor accepting random variables calling {\tt \hyperlink{classbdm_1_1epdf_f423e28448dbb69ef4905295ec8de8ff}{set\_\-rv()}} \end{itemize}
100All internal data structures are constructed as empty. Their values (including sizes) will be set by method {\tt \hyperlink{classbdm_1_1eEmp_82320074a9b0ad7e1bb33a6e885b65d7}{set\_\-parameters()}}. This way references can be initialized in constructors. }\begin{CompactItemize}
101\item 
102\hypertarget{classbdm_1_1epdf_840de94aa33cf4f2ebd2427f45a165d8}{
103void \textbf{set\_\-parameters} (int dim0)}
104\label{classbdm_1_1epdf_840de94aa33cf4f2ebd2427f45a165d8}
105
106\end{CompactItemize}
107\end{Indent}
[270]108\begin{Indent}{\bf Matematical Operations}\par
109\begin{CompactItemize}
110\item 
[261]111\hypertarget{classbdm_1_1epdf_b4cf45fd83cc7573ede9fe1215256058}{
112virtual mat \hyperlink{classbdm_1_1epdf_b4cf45fd83cc7573ede9fe1215256058}{sample\_\-m} (int N) const }
113\label{classbdm_1_1epdf_b4cf45fd83cc7573ede9fe1215256058}
114
[270]115\begin{CompactList}\small\item\em Returns N samples, $ [x_1 , x_2 , \ldots \ $ from density $ f_x(rv)$. \item\end{CompactList}\item 
[261]116\hypertarget{classbdm_1_1epdf_34956d4dd3176eeb5937cf48a1546b62}{
117virtual vec \hyperlink{classbdm_1_1epdf_34956d4dd3176eeb5937cf48a1546b62}{evallog\_\-m} (const mat \&Val) const }
118\label{classbdm_1_1epdf_34956d4dd3176eeb5937cf48a1546b62}
119
120\begin{CompactList}\small\item\em Compute log-probability of multiple values argument {\tt val}. \item\end{CompactList}\item 
121\hypertarget{classbdm_1_1epdf_e584eac5579c1b6384947ecf66166c77}{
122virtual \hyperlink{classbdm_1_1mpdf}{mpdf} $\ast$ \hyperlink{classbdm_1_1epdf_e584eac5579c1b6384947ecf66166c77}{condition} (const \hyperlink{classbdm_1_1RV}{RV} \&\hyperlink{classbdm_1_1epdf_62c5b8ff71d9ebe6cd58d3c342eb1dc8}{rv}) const }
123\label{classbdm_1_1epdf_e584eac5579c1b6384947ecf66166c77}
124
125\begin{CompactList}\small\item\em Return conditional density on the given \hyperlink{classbdm_1_1RV}{RV}, the remaining rvs will be in conditioning. \item\end{CompactList}\item 
126\hypertarget{classbdm_1_1epdf_3fb2ece54f720b62ad325e61214fa0a1}{
127virtual \hyperlink{classbdm_1_1epdf}{epdf} $\ast$ \hyperlink{classbdm_1_1epdf_3fb2ece54f720b62ad325e61214fa0a1}{marginal} (const \hyperlink{classbdm_1_1RV}{RV} \&\hyperlink{classbdm_1_1epdf_62c5b8ff71d9ebe6cd58d3c342eb1dc8}{rv}) const }
128\label{classbdm_1_1epdf_3fb2ece54f720b62ad325e61214fa0a1}
129
[270]130\begin{CompactList}\small\item\em Return marginal density on the given \hyperlink{classbdm_1_1RV}{RV}, the remainig rvs are intergrated out. \item\end{CompactList}\end{CompactItemize}
131\end{Indent}
132\begin{Indent}{\bf Connection to other classes}\par
133{\em Description of the random quantity via attribute {\tt rv} is optional. For operations such as sampling {\tt rv} does not need to be set. However, for {\tt marginalization} and {\tt conditioning} {\tt rv} has to be set. NB: }\begin{CompactItemize}
134\item 
135\hypertarget{classbdm_1_1epdf_f423e28448dbb69ef4905295ec8de8ff}{
136void \hyperlink{classbdm_1_1epdf_f423e28448dbb69ef4905295ec8de8ff}{set\_\-rv} (const \hyperlink{classbdm_1_1RV}{RV} \&rv0)}
137\label{classbdm_1_1epdf_f423e28448dbb69ef4905295ec8de8ff}
138
139\begin{CompactList}\small\item\em Name its rv. \item\end{CompactList}\item 
140\hypertarget{classbdm_1_1epdf_c4b863ff84c7a4882fb3ad18556027f9}{
141bool \hyperlink{classbdm_1_1epdf_c4b863ff84c7a4882fb3ad18556027f9}{isnamed} () const }
142\label{classbdm_1_1epdf_c4b863ff84c7a4882fb3ad18556027f9}
143
144\begin{CompactList}\small\item\em True if rv is assigned. \item\end{CompactList}\item 
[261]145\hypertarget{classbdm_1_1epdf_a4ab378d5e004c3ff3e2d4e64f7bba21}{
146const \hyperlink{classbdm_1_1RV}{RV} \& \hyperlink{classbdm_1_1epdf_a4ab378d5e004c3ff3e2d4e64f7bba21}{\_\-rv} () const }
147\label{classbdm_1_1epdf_a4ab378d5e004c3ff3e2d4e64f7bba21}
148
[270]149\begin{CompactList}\small\item\em Return name (fails when isnamed is false). \item\end{CompactList}\end{CompactItemize}
150\end{Indent}
151\begin{Indent}{\bf Access to attributes}\par
152\begin{CompactItemize}
153\item 
[271]154\hypertarget{classbdm_1_1epdf_7083a65f7b7a0d0d13b2c516bd2ec29c}{
155int \hyperlink{classbdm_1_1epdf_7083a65f7b7a0d0d13b2c516bd2ec29c}{dimension} () const }
156\label{classbdm_1_1epdf_7083a65f7b7a0d0d13b2c516bd2ec29c}
[261]157
[270]158\begin{CompactList}\small\item\em Size of the random variable. \item\end{CompactList}\end{CompactItemize}
159\end{Indent}
[261]160\subsection*{Protected Attributes}
161\begin{CompactItemize}
162\item 
163\hypertarget{classbdm_1_1eEmp_9798006271ca77629855113f1283a031}{
164int \hyperlink{classbdm_1_1eEmp_9798006271ca77629855113f1283a031}{n}}
165\label{classbdm_1_1eEmp_9798006271ca77629855113f1283a031}
166
167\begin{CompactList}\small\item\em Number of particles. \item\end{CompactList}\item 
168\hypertarget{classbdm_1_1eEmp_9d39241aab7c4bbeb07c6d516421c67d}{
169vec \hyperlink{classbdm_1_1eEmp_9d39241aab7c4bbeb07c6d516421c67d}{w}}
170\label{classbdm_1_1eEmp_9d39241aab7c4bbeb07c6d516421c67d}
171
172\begin{CompactList}\small\item\em Sample weights $w$. \item\end{CompactList}\item 
173\hypertarget{classbdm_1_1eEmp_73d819553a0f268b055a087d2d4486f3}{
174Array$<$ vec $>$ \hyperlink{classbdm_1_1eEmp_73d819553a0f268b055a087d2d4486f3}{samples}}
175\label{classbdm_1_1eEmp_73d819553a0f268b055a087d2d4486f3}
176
177\begin{CompactList}\small\item\em Samples $x^{(i)}, i=1..n$. \item\end{CompactList}\item 
[270]178\hypertarget{classbdm_1_1epdf_16adac20ec7fe07e1ea0b27d917788ce}{
179int \hyperlink{classbdm_1_1epdf_16adac20ec7fe07e1ea0b27d917788ce}{dim}}
180\label{classbdm_1_1epdf_16adac20ec7fe07e1ea0b27d917788ce}
181
182\begin{CompactList}\small\item\em dimension of the random variable \item\end{CompactList}\item 
[261]183\hypertarget{classbdm_1_1epdf_62c5b8ff71d9ebe6cd58d3c342eb1dc8}{
184\hyperlink{classbdm_1_1RV}{RV} \hyperlink{classbdm_1_1epdf_62c5b8ff71d9ebe6cd58d3c342eb1dc8}{rv}}
185\label{classbdm_1_1epdf_62c5b8ff71d9ebe6cd58d3c342eb1dc8}
186
[270]187\begin{CompactList}\small\item\em Description of the random variable. \item\end{CompactList}\end{CompactItemize}
[261]188
189
190The documentation for this class was generated from the following files:\begin{CompactItemize}
191\item 
192\hyperlink{libEF_8h}{libEF.h}\item 
193libEF.cpp\end{CompactItemize}
Note: See TracBrowser for help on using the browser.