| 1 | \section{fsqmat Class Reference} |
|---|
| 2 | \label{classfsqmat}\index{fsqmat@{fsqmat}} |
|---|
| 3 | Fake \doxyref{sqmat}{p.}{classsqmat}. This class maps \doxyref{sqmat}{p.}{classsqmat} operations to operations on full matrix. |
|---|
| 4 | |
|---|
| 5 | |
|---|
| 6 | {\tt \#include $<$libDC.h$>$} |
|---|
| 7 | |
|---|
| 8 | Inheritance diagram for fsqmat:\nopagebreak |
|---|
| 9 | \begin{figure}[H] |
|---|
| 10 | \begin{center} |
|---|
| 11 | \leavevmode |
|---|
| 12 | \includegraphics[width=47pt]{classfsqmat__inherit__graph} |
|---|
| 13 | \end{center} |
|---|
| 14 | \end{figure} |
|---|
| 15 | Collaboration diagram for fsqmat:\nopagebreak |
|---|
| 16 | \begin{figure}[H] |
|---|
| 17 | \begin{center} |
|---|
| 18 | \leavevmode |
|---|
| 19 | \includegraphics[width=47pt]{classfsqmat__coll__graph} |
|---|
| 20 | \end{center} |
|---|
| 21 | \end{figure} |
|---|
| 22 | \subsection*{Public Member Functions} |
|---|
| 23 | \begin{CompactItemize} |
|---|
| 24 | \item |
|---|
| 25 | void {\bf opupdt} (const vec \&v, double w) |
|---|
| 26 | \item |
|---|
| 27 | mat {\bf to\_\-mat} ()\label{classfsqmat_cedf4f048309056f4262c930914dfda8} |
|---|
| 28 | |
|---|
| 29 | \begin{CompactList}\small\item\em Conversion to full matrix. \item\end{CompactList}\item |
|---|
| 30 | void {\bf mult\_\-sym} (const mat \&C) |
|---|
| 31 | \begin{CompactList}\small\item\em Inplace symmetric multiplication by a SQUARE matrix $C$, i.e. $V = C*V*C'$. \item\end{CompactList}\item |
|---|
| 32 | void {\bf mult\_\-sym\_\-t} (const mat \&C) |
|---|
| 33 | \begin{CompactList}\small\item\em Inplace symmetric multiplication by a SQUARE transpose of matrix $C$, i.e. $V = C'*V*C$. \item\end{CompactList}\item |
|---|
| 34 | void {\bf mult\_\-sym} (const mat \&C, {\bf fsqmat} \&U) const \label{classfsqmat_d4eddc3743c8865cc5ed92d14de0e3e3} |
|---|
| 35 | |
|---|
| 36 | \begin{CompactList}\small\item\em store result of {\tt mult\_\-sym} in external matrix $U$ \item\end{CompactList}\item |
|---|
| 37 | void {\bf mult\_\-sym\_\-t} (const mat \&C, {\bf fsqmat} \&U) const \label{classfsqmat_ae4949ad2a32553c7fa04d6d1483770a} |
|---|
| 38 | |
|---|
| 39 | \begin{CompactList}\small\item\em store result of {\tt mult\_\-sym\_\-t} in external matrix $U$ \item\end{CompactList}\item |
|---|
| 40 | void {\bf clear} ()\label{classfsqmat_cfa4c359483d2322f32d1d50050f8ac4} |
|---|
| 41 | |
|---|
| 42 | \begin{CompactList}\small\item\em Clearing matrix so that it corresponds to zeros. \item\end{CompactList}\item |
|---|
| 43 | {\bf fsqmat} ()\label{classfsqmat_79e3f73e0ccd663c7f7e08083d272940} |
|---|
| 44 | |
|---|
| 45 | \begin{CompactList}\small\item\em Default initialization. \item\end{CompactList}\item |
|---|
| 46 | {\bf fsqmat} (const int dim0)\label{classfsqmat_40eae99305e7c7240fa95cfec125b06f} |
|---|
| 47 | |
|---|
| 48 | \begin{CompactList}\small\item\em Default initialization with proper size. \item\end{CompactList}\item |
|---|
| 49 | {\bf fsqmat} (const mat \&{\bf M})\label{classfsqmat_1929fbc9fe375f1d67f979d0d302336f} |
|---|
| 50 | |
|---|
| 51 | \begin{CompactList}\small\item\em Constructor. \item\end{CompactList}\item |
|---|
| 52 | {\bf fsqmat} (const vec \&d)\label{classfsqmat_c01f3e9bb590f2a2921369d672f3ce1e} |
|---|
| 53 | |
|---|
| 54 | \begin{CompactList}\small\item\em Constructor. \item\end{CompactList}\item |
|---|
| 55 | virtual {\bf $\sim$fsqmat} ()\label{classfsqmat_2a8f104e4befbc2aa90d8b11edfedb2e} |
|---|
| 56 | |
|---|
| 57 | \begin{CompactList}\small\item\em Destructor for future use;. \item\end{CompactList}\item |
|---|
| 58 | virtual void {\bf inv} ({\bf fsqmat} \&Inv) |
|---|
| 59 | \begin{CompactList}\small\item\em Matrix inversion preserving the chosen form. \item\end{CompactList}\item |
|---|
| 60 | double {\bf logdet} () const \label{classfsqmat_eb0d1358f536e4453b5f99d0418ca1e5} |
|---|
| 61 | |
|---|
| 62 | \begin{CompactList}\small\item\em Logarithm of a determinant. \item\end{CompactList}\item |
|---|
| 63 | double {\bf qform} (const vec \&v) const \label{classfsqmat_a6c91b0389e73404324b2314b08d6e87} |
|---|
| 64 | |
|---|
| 65 | \begin{CompactList}\small\item\em Evaluates quadratic form $x= v'*V*v$;. \item\end{CompactList}\item |
|---|
| 66 | double {\bf invqform} (const vec \&v) const \label{classfsqmat_58075da64ddadd4df40654c35b928c6f} |
|---|
| 67 | |
|---|
| 68 | \begin{CompactList}\small\item\em Evaluates quadratic form $x= v'*inv(V)*v$;. \item\end{CompactList}\item |
|---|
| 69 | vec {\bf sqrt\_\-mult} (const vec \&v) const |
|---|
| 70 | \begin{CompactList}\small\item\em Multiplies square root of $V$ by vector $x$. \item\end{CompactList}\item |
|---|
| 71 | void {\bf setD} (const vec \&nD)\label{classfsqmat_922f8190c13987cbcdb33ec2bf5cf105} |
|---|
| 72 | |
|---|
| 73 | \begin{CompactList}\small\item\em Access functions. \item\end{CompactList}\item |
|---|
| 74 | vec {\bf getD} ()\label{classfsqmat_bcf837b2956745e8986044f5600dbd6e} |
|---|
| 75 | |
|---|
| 76 | \begin{CompactList}\small\item\em Access functions. \item\end{CompactList}\item |
|---|
| 77 | void {\bf setD} (const vec \&nD, int i)\label{classfsqmat_03a8f49eb4d38a054ecc522be59cd2ad} |
|---|
| 78 | |
|---|
| 79 | \begin{CompactList}\small\item\em Access functions. \item\end{CompactList}\item |
|---|
| 80 | {\bf fsqmat} \& {\bf operator+=} (const {\bf fsqmat} \&A)\label{classfsqmat_514d1fdd8a382dbd6a774f2cf1ebd3de} |
|---|
| 81 | |
|---|
| 82 | \begin{CompactList}\small\item\em add another \doxyref{fsqmat}{p.}{classfsqmat} matrix \item\end{CompactList}\item |
|---|
| 83 | {\bf fsqmat} \& {\bf operator-=} (const {\bf fsqmat} \&A)\label{classfsqmat_e976bc9d899961e1d2087b0630ed33b7} |
|---|
| 84 | |
|---|
| 85 | \begin{CompactList}\small\item\em subtrack another \doxyref{fsqmat}{p.}{classfsqmat} matrix \item\end{CompactList}\item |
|---|
| 86 | {\bf fsqmat} \& {\bf operator $\ast$=} (double x)\label{classfsqmat_8f7ce97628a50e06641281096b2af9b7} |
|---|
| 87 | |
|---|
| 88 | \begin{CompactList}\small\item\em multiply by a scalar \item\end{CompactList}\item |
|---|
| 89 | int {\bf cols} () const \label{classsqmat_ecc2e2540f95a04f4449842588170f5b} |
|---|
| 90 | |
|---|
| 91 | \begin{CompactList}\small\item\em Reimplementing common functions of mat: \doxyref{cols()}{p.}{classsqmat_ecc2e2540f95a04f4449842588170f5b}. \item\end{CompactList}\item |
|---|
| 92 | int {\bf rows} () const \label{classsqmat_071e80ced9cc3b8cbb360fa7462eb646} |
|---|
| 93 | |
|---|
| 94 | \begin{CompactList}\small\item\em Reimplementing common functions of mat: \doxyref{cols()}{p.}{classsqmat_ecc2e2540f95a04f4449842588170f5b}. \item\end{CompactList}\end{CompactItemize} |
|---|
| 95 | \subsection*{Protected Attributes} |
|---|
| 96 | \begin{CompactItemize} |
|---|
| 97 | \item |
|---|
| 98 | mat {\bf M}\label{classfsqmat_a7a1fcb9aae19d1e4daddfc9c22ce453} |
|---|
| 99 | |
|---|
| 100 | \begin{CompactList}\small\item\em Full matrix on which the operations are performed. \item\end{CompactList}\item |
|---|
| 101 | int {\bf dim}\label{classsqmat_0abed904bdc0882373ba9adba919689d} |
|---|
| 102 | |
|---|
| 103 | \begin{CompactList}\small\item\em dimension of the square matrix \item\end{CompactList}\end{CompactItemize} |
|---|
| 104 | \subsection*{Friends} |
|---|
| 105 | \begin{CompactItemize} |
|---|
| 106 | \item |
|---|
| 107 | std::ostream \& {\bf operator$<$$<$} (std::ostream \&os, const {\bf fsqmat} \&sq)\label{classfsqmat_e06aba54d61e807b41bd68b5ee6ac22f} |
|---|
| 108 | |
|---|
| 109 | \begin{CompactList}\small\item\em print full matrix \item\end{CompactList}\end{CompactItemize} |
|---|
| 110 | |
|---|
| 111 | |
|---|
| 112 | \subsection{Detailed Description} |
|---|
| 113 | Fake \doxyref{sqmat}{p.}{classsqmat}. This class maps \doxyref{sqmat}{p.}{classsqmat} operations to operations on full matrix. |
|---|
| 114 | |
|---|
| 115 | This class can be used to compare performance of algorithms using decomposed matrices with perormance of the same algorithms using full matrices; |
|---|
| 116 | |
|---|
| 117 | \subsection{Member Function Documentation} |
|---|
| 118 | \index{fsqmat@{fsqmat}!opupdt@{opupdt}} |
|---|
| 119 | \index{opupdt@{opupdt}!fsqmat@{fsqmat}} |
|---|
| 120 | \subsubsection{\setlength{\rightskip}{0pt plus 5cm}void fsqmat::opupdt (const vec \& {\em v}, double {\em w})\hspace{0.3cm}{\tt [virtual]}}\label{classfsqmat_b36530e155667fe9f1bd58394e50c65a} |
|---|
| 121 | |
|---|
| 122 | |
|---|
| 123 | Perfroms a rank-1 update by outer product of vectors: $V = V + w v v'$. \begin{Desc} |
|---|
| 124 | \item[Parameters:] |
|---|
| 125 | \begin{description} |
|---|
| 126 | \item[{\em v}]Vector forming the outer product to be added \item[{\em w}]weight of updating; can be negative\end{description} |
|---|
| 127 | \end{Desc} |
|---|
| 128 | BLAS-2b operation. |
|---|
| 129 | |
|---|
| 130 | Implements {\bf sqmat} \doxyref{}{p.}{classsqmat_b223484796661f2dadb5607a86ce0581}.\index{fsqmat@{fsqmat}!mult_sym@{mult\_\-sym}} |
|---|
| 131 | \index{mult_sym@{mult\_\-sym}!fsqmat@{fsqmat}} |
|---|
| 132 | \subsubsection{\setlength{\rightskip}{0pt plus 5cm}void fsqmat::mult\_\-sym (const mat \& {\em C})\hspace{0.3cm}{\tt [virtual]}}\label{classfsqmat_5530d2756b5d991de755e6121c9a452e} |
|---|
| 133 | |
|---|
| 134 | |
|---|
| 135 | Inplace symmetric multiplication by a SQUARE matrix $C$, i.e. $V = C*V*C'$. |
|---|
| 136 | |
|---|
| 137 | \begin{Desc} |
|---|
| 138 | \item[Parameters:] |
|---|
| 139 | \begin{description} |
|---|
| 140 | \item[{\em C}]multiplying matrix, \end{description} |
|---|
| 141 | \end{Desc} |
|---|
| 142 | |
|---|
| 143 | |
|---|
| 144 | Implements {\bf sqmat} \doxyref{}{p.}{classsqmat_60fbbfa9e483b8187c135f787ee53afa}.\index{fsqmat@{fsqmat}!mult_sym_t@{mult\_\-sym\_\-t}} |
|---|
| 145 | \index{mult_sym_t@{mult\_\-sym\_\-t}!fsqmat@{fsqmat}} |
|---|
| 146 | \subsubsection{\setlength{\rightskip}{0pt plus 5cm}void fsqmat::mult\_\-sym\_\-t (const mat \& {\em C})\hspace{0.3cm}{\tt [virtual]}}\label{classfsqmat_92052a8adc2054b63e42d1373d145c89} |
|---|
| 147 | |
|---|
| 148 | |
|---|
| 149 | Inplace symmetric multiplication by a SQUARE transpose of matrix $C$, i.e. $V = C'*V*C$. |
|---|
| 150 | |
|---|
| 151 | \begin{Desc} |
|---|
| 152 | \item[Parameters:] |
|---|
| 153 | \begin{description} |
|---|
| 154 | \item[{\em C}]multiplying matrix, \end{description} |
|---|
| 155 | \end{Desc} |
|---|
| 156 | |
|---|
| 157 | |
|---|
| 158 | Implements {\bf sqmat} \doxyref{}{p.}{classsqmat_6909e906da17725b1b80f3cae7cf3325}.\index{fsqmat@{fsqmat}!inv@{inv}} |
|---|
| 159 | \index{inv@{inv}!fsqmat@{fsqmat}} |
|---|
| 160 | \subsubsection{\setlength{\rightskip}{0pt plus 5cm}void fsqmat::inv ({\bf fsqmat} \& {\em Inv})\hspace{0.3cm}{\tt [virtual]}}\label{classfsqmat_9fa853e1ca28f2a1a1c43377e798ecb1} |
|---|
| 161 | |
|---|
| 162 | |
|---|
| 163 | Matrix inversion preserving the chosen form. |
|---|
| 164 | |
|---|
| 165 | \begin{Desc} |
|---|
| 166 | \item[Parameters:] |
|---|
| 167 | \begin{description} |
|---|
| 168 | \item[{\em Inv}]a space where the inverse is stored. \end{description} |
|---|
| 169 | \end{Desc} |
|---|
| 170 | \index{fsqmat@{fsqmat}!sqrt_mult@{sqrt\_\-mult}} |
|---|
| 171 | \index{sqrt_mult@{sqrt\_\-mult}!fsqmat@{fsqmat}} |
|---|
| 172 | \subsubsection{\setlength{\rightskip}{0pt plus 5cm}vec fsqmat::sqrt\_\-mult (const vec \& {\em v}) const\hspace{0.3cm}{\tt [inline, virtual]}}\label{classfsqmat_842a774077ee34ac3c36d180ab33e103} |
|---|
| 173 | |
|---|
| 174 | |
|---|
| 175 | Multiplies square root of $V$ by vector $x$. |
|---|
| 176 | |
|---|
| 177 | Used e.g. in generating normal samples. |
|---|
| 178 | |
|---|
| 179 | Implements {\bf sqmat} \doxyref{}{p.}{classsqmat_6b79438b5d7544a9c8e110a145355d8f}. |
|---|
| 180 | |
|---|
| 181 | The documentation for this class was generated from the following files:\begin{CompactItemize} |
|---|
| 182 | \item |
|---|
| 183 | work/mixpp/bdm/math/{\bf libDC.h}\item |
|---|
| 184 | work/mixpp/bdm/math/libDC.cpp\end{CompactItemize} |
|---|