Index: library/doc/html/user_guide.html
===================================================================
--- library/doc/html/user_guide.html (revision 641)
+++ library/doc/html/user_guide.html (revision 651)
@@ -1,12 +1,9 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
 <title>mixpp: BDM Use - System, Data, Simulation</title>
-<link href="tabs.css" rel="stylesheet" type="text/css"/>
-<link href="doxygen.css" rel="stylesheet" type="text/css"/>
-</head>
-<body>
-<!-- Generated by Doxygen 1.6.1 -->
+<link href="tabs.css" rel="stylesheet" type="text/css">
+<link href="doxygen.css" rel="stylesheet" type="text/css">
+</head><body>
+<!-- Generated by Doxygen 1.5.9 -->
 <script type="text/javascript">
 <!--
@@ -61,174 +58,125 @@
 </div>
 <div class="contents">
-
-
-<h1><a class="anchor" id="user_guide">BDM Use - System, Data, Simulation </a></h1><p>This section serves as introdustion to the scenario of data simulation. Since it is the simpliest of all scenarios defined in <a class="el" href="user_guide0.html">BDM Use - Introduction</a> it also serves as introduction to configuration of an experiment (see <a class="el" href="ui_page.html">User Infos and their use</a>) and basic decision making objects (<a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">bdm::RV</a> and <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a>).</p>
-<p>All experiments are demonstarted on scenario simulator which can be either standalone application of mex file (simulator.mex**).</p>
-<h2><a class="anchor" id="ug_config">
+<h1><a class="anchor" name="user_guide">BDM Use - System, Data, Simulation </a></h1>This section serves as introdustion to the scenario of data simulation. Since it is the simpliest of all scenarios defined in user_guide0 it also serves as introduction to configuration of an experiment (see <a class="el" href="ui_page.html">User Infos and their use</a>) and basic decision making objects (<a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">bdm::RV</a> and <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a>).<p>
+All experiments are demonstarted on scenario simulator which can be either standalone application or mex file (simulator.mex**).<h2><a class="anchor" name="ug_config">
 Configuration of an experiment</a></h2>
-<p>Configuration file (or config structure) is organized as a tree of information. High levels represent complex structures, leafs of the tree are basic data elements such as strings, numbers or vectors.</p>
-<p>Specific treatment was developed for objects. Since BDM is designed as object oriented library, the configuration was designed to honor the rule of inheritance. That is, offspring of a class can be used in place of its predecessor. Hence, objects (instances of classes) are configured by a structure with compulsory field <code>class</code>. This is a string variable corresponding to the name of the class to be used.</p>
-<p>The configuration has two possible options:</p>
-<ul>
-<li>configuration file using syntax of libconfig (see <a class="el" href="ui_page.html">User Infos and their use</a>),</li>
-<li>matlab structure. For the purpose of tutorial, we will use the matlab notation. These two options can be mutually converted from one to another using prepared mex files: config2mxstruct.mex and mxstruct2config.mex. Naturally, these scripts require matlab to run. If it is not available, manual conversion is relatively trivial, the major difference is in using different types of brackets (<a class="el" href="ui_page.html">User Infos and their use</a>)</li>
-</ul>
-<h3><a class="anchor" id="ug_first">
+Configuration file (or config structure) is organized as a tree of information. High levels represent complex structures, leafs of the tree are basic data elements such as strings, numbers or vectors.<p>
+Specific treatment was developed for objects. Since BDM is designed as object oriented library, the configuration was designed to honor the rule of inheritance. That is, offspring of a class can be used in place of its predecessor. Hence, objects (instances of classes) are configured by a structure with compulsory field <code>class</code>. This is a string variable corresponding to the name of the class to be used.<p>
+The configuration has two possible options:<ul>
+<li>configuration file using syntax of libconfig (see <a class="el" href="ui_page.html">User Infos and their use</a>),</li><li>matlab structure. For the purpose of tutorial, we will use the matlab notation. These two options can be mutually converted from one to another using prepared mex files: config2mxstruct.mex and mxstruct2config.mex. Naturally, these scripts require matlab to run. If it is not available, manual conversion is relatively trivial, the major difference is in using different types of brackets (<a class="el" href="ui_page.html">User Infos and their use</a>)</li></ul>
+<h3><a class="anchor" name="ug_first">
 First experiment</a></h3>
-<p>The first experiment that can be performed is: </p>
-<div class="fragment"><pre class="fragment">DS.class=<span class="stringliteral">&apos;MemDS&apos;</span>;
+The first experiment that can be performed is: <div class="fragment"><pre class="fragment">DS.class=<span class="stringliteral">'MemDS'</span>;
 DS.Data =[1 2 3 4 5 6];
-</pre></div><p> which can be found in file bdmtoolbox/tutorials/userguide/memds_example.m.</p>
-<p>The code above is the minimum necessary information to run scenario <code>simulator</code> in matlab. To actually do so, make sure that matlab can find the simulator.mex file, e.g. by running: </p>
-<div class="fragment"><pre class="fragment">&gt;&gt; addpath _path_to_/bmtoolbox/mex/
-</pre></div><p>The expected result for Matlab is: </p>
-<div class="fragment"><pre class="fragment">&gt;&gt; M=simulator(DS)
+</pre></div> which can be found in file bdmtoolbox/tutorials/userguide/memds_example.m.<p>
+The code above is the minimum necessary information to run scenario <code>simulator</code> in matlab. To actually do so, make sure that matlab can find the simulator.mex file, e.g. by running: <div class="fragment"><pre class="fragment">&gt;&gt; addpath _path_to_/bmtoolbox/mex/
+</pre></div><p>
+The expected result for Matlab is: <div class="fragment"><pre class="fragment">&gt;&gt; M=simulator(DS)
 
 M = 
 
     ch0: [6x1 <span class="keywordtype">double</span>]
-</pre></div><p>If you see this result, you have configured BDM correctly and you have sucessfully run you first experiment. In other cases, please check your installation, <a class="el" href="install.html">BDM Use - Installation</a>. All that the simulator did was actually copying <code>DS.Data</code> to <code>M.ch0</code>. Explanation of the experiment and the logic used there follows.</p>
-<h2><a class="anchor" id="ug_sim">
+</pre></div><p>
+If you see this result, you have configured BDM correctly and you have sucessfully run you first experiment. In other cases, please check your installation, <a class="el" href="install.html">BDM Use - Installation</a>. All that the simulator did was actually copying <code>DS.Data</code> to <code>M.ch0</code>. Explanation of the experiment and the logic used there follows.<h2><a class="anchor" name="ug_sim">
 Systems and DataSources</a></h2>
-<p>In standard system theory, the system is typically illustrated graphically as: </p>
-<div align="center">
+In standard system theory, the system is typically illustrated graphically as: <div align="center">
 <img src="inline_dotgraph_1.dot.png" alt="inline_dotgraph_1.dot" border="0" usemap="#inline_dotgraph_1.dot.map">
-<map name="inline_dotgraph_1.dot.map" id="inline_dotgraph_1.dot.map"></map>
+<map name="inline_dotgraph_1.dot.map"></map>
 </div>
-<p> Where <code>u</code> typically denotes input and <code>y</code> denotes output of the system. A causal dependence between input and output is typically presumed.</p>
-<p>We are predominantly concerned with discrete-time systems, hence, we will add indeces <img class="formulaInl" alt="$ _t $" src="form_159.png"/> to both input and output, <img class="formulaInl" alt="$ u_t $" src="form_5.png"/> and <img class="formulaInl" alt="$ y_t $" src="form_6.png"/>. We presume that the causal dependence is <img class="formulaInl" alt="$ u_t $" src="form_5.png"/> comes before <img class="formulaInl" alt="$ y_t $" src="form_6.png"/>.</p>
-<p>One of the definition of a system is that system is a "set of variables observed on a part of the world". Under this definition system is understood as generator of data. This definition may be a considered too simplistic, but it serves well as a description of what software object <code>DataSource</code> is.</p>
-<p>DataSource is an object that is essentially:</p>
-<ol type="1">
-<li>able to return data observed at time <img class="formulaInl" alt="$ t $" src="form_18.png"/>, (<a class="el" href="classbdm_1_1DS.html#ac1ec862dec7164fee3284c6f9a51b0ba" title="Returns full vector of observed data=[output, input].">bdm::DS::getdata()</a>),</li>
-<li>able to perform one a time step, (<a class="el" href="classbdm_1_1DS.html#a4df78b21d352013d8804a8dda860b7ea" title="Moves from  to , i.e. perfroms the actions and reads response of the system.">bdm::DS::step()</a>).</li>
-<li>able to describe what these data are, (<a class="el" href="classbdm_1_1DS.html#a069497b610296be053d862a2493be0ce" title="access function">bdm::DS::_drv()</a>),</li>
-</ol>
-<p>No fruther specification, e.g. if the data are pre-recorded or computed on-the-fly, are given. Specific behaviour of various DataSources is implemented as specialization of the root class <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a>.</p>
-<h2><a class="anchor" id="ug_memds">
+ Where <code>u</code> typically denotes input and <code>y</code> denotes output of the system. A causal dependence between input and output is typically presumed.<p>
+We are predominantly concerned with discrete-time systems, hence, we will add indeces <img class="formulaInl" alt="$ _t $" src="form_159.png"> to both input and output, <img class="formulaInl" alt="$ u_t $" src="form_5.png"> and <img class="formulaInl" alt="$ y_t $" src="form_6.png">. We presume that the causal dependence is <img class="formulaInl" alt="$ u_t $" src="form_5.png"> comes before <img class="formulaInl" alt="$ y_t $" src="form_6.png">.<p>
+One of the definition of a system is that system is a "set of variables observed on a part of the world". Under this definition system is understood as generator of data. This definition may be a considered too simplistic, but it serves well as a description of what software object <code>DataSource</code> is.<p>
+DataSource is an object that is essentially:<ol type=1>
+<li>able to return data observed at time <img class="formulaInl" alt="$ t $" src="form_18.png">, (<a class="el" href="classbdm_1_1DS.html#c1ec862dec7164fee3284c6f9a51b0ba" title="Returns full vector of observed data=[output, input].">bdm::DS::getdata()</a>),</li><li>able to perform one a time step, (<a class="el" href="classbdm_1_1DS.html#4df78b21d352013d8804a8dda860b7ea" title="Moves from  to , i.e. perfroms the actions and reads response of the system.">bdm::DS::step()</a>).</li><li>able to describe what these data are, (<a class="el" href="classbdm_1_1DS.html#069497b610296be053d862a2493be0ce" title="access function">bdm::DS::_drv()</a>),</li></ol>
+<p>
+No fruther specification, e.g. if the data are pre-recorded or computed on-the-fly, are given. Specific behaviour of various DataSources is implemented as specialization of the root class <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a>.<h2><a class="anchor" name="ug_memds">
 DataSource of pre-recorded data -- MemDS</a></h2>
-<p>The first experiment run in first was actually an instance of DataSource of pre-recorded data that were stored in memory, i.e. the <a class="el" href="classbdm_1_1MemDS.html" title="Memory storage of off-line data column-wise.">bdm::MemDS</a> class.</p>
-<p>Operation of such object is trivial, the data are stored as a matrix and the general operations defined above are specialized as follows:</p>
-<ol type="1">
-<li>data observed at time <img class="formulaInl" alt="$ t $" src="form_18.png"/> are columns of the matrix, getdata() ruturns current column,</li>
-<li>time step itself is performed by increasing the column index,</li>
-<li>each row is named as "ch0","ch1",...</li>
-</ol>
-<p>This is the default bahavior. It can be customized using the UI mechanism. When the object of class MemDS is created it calls method <a class="el" href="classbdm_1_1MemDS.html#afaebfe6d7a2a43421be05d8cf7d7ae45">bdm::MemDS::from_setting()</a> and the input structure is parsed for settings. All available settings are documented in the method, see <a class="el" href="classbdm_1_1MemDS.html#afaebfe6d7a2a43421be05d8cf7d7ae45">bdm::MemDS::from_setting()</a>. The options are: </p>
-<div class="fragment"><pre class="fragment">DS.class = <span class="stringliteral">&apos;MemDS&apos;</span>;
+The first experiment run in first was actually an instance of DataSource of pre-recorded data that were stored in memory, i.e. the <a class="el" href="classbdm_1_1MemDS.html" title="Memory storage of off-line data column-wise.">bdm::MemDS</a> class.<p>
+Operation of such object is trivial, the data are stored as a matrix and the general operations defined above are specialized as follows:<ol type=1>
+<li>data observed at time <img class="formulaInl" alt="$ t $" src="form_18.png"> are columns of the matrix, getdata() ruturns current column,</li><li>time step itself is performed by increasing the column index,</li><li>each row is named as "ch0","ch1",...</li></ol>
+<p>
+This is the default bahavior. It can be customized using the UI mechanism. When the object of class MemDS is created it calls method <a class="el" href="classbdm_1_1MemDS.html#faebfe6d7a2a43421be05d8cf7d7ae45">bdm::MemDS::from_setting()</a> and the input structure is parsed for settings. All available settings are documented in the method, see <a class="el" href="classbdm_1_1MemDS.html#faebfe6d7a2a43421be05d8cf7d7ae45">bdm::MemDS::from_setting()</a>. The options are: <div class="fragment"><pre class="fragment">DS.class = <span class="stringliteral">'MemDS'</span>;
 DS.Data = (...);            <span class="comment">// Data matrix or data vector</span>
         --- optional ---
-DS.drv = RV({<span class="stringliteral">&quot;ch0&quot;</span>,...} ); <span class="comment">// Identification how rows of the matrix Data will be known to others</span>
+DS.drv = RV({<span class="stringliteral">"ch0"</span>,...} ); <span class="comment">// Identification how rows of the matrix Data will be known to others</span>
 DS.time = 0;               <span class="comment">// Index of the first column to user_info,</span>
 DS.rowid = [1,2,3...];     <span class="comment">// ids of rows to be used</span>
-</pre></div><p> The compulsory fields are listed at the beginning; the optional fields are separated by string "--- optional ---".</p>
-<p>Fields <code>time</code> and <code>rowid</code> are self-explanatory. Field <code>drv</code> is a the one that specifies identification of the data elements, (point 3. of the general requirements of a DataSource).</p>
-<p>All optionals fields will be filled by default values, it this case: </p>
-<div class="fragment"><pre class="fragment">DS.drv  = RV({<span class="stringliteral">&apos;ch0&apos;</span>},1,0);
+</pre></div> The compulsory fields are listed at the beginning; the optional fields are separated by string "--- optional ---".<p>
+Fields <code>time</code> and <code>rowid</code> are self-explanatory. Field <code>drv</code> is a the one that specifies identification of the data elements, (point 3. of the general requirements of a DataSource).<p>
+All optionals fields will be filled by default values, it this case: <div class="fragment"><pre class="fragment">DS.drv  = RV({<span class="stringliteral">'ch0'</span>},1,0);
 DS.time = 0;
 DS.rowid = [1];
-</pre></div><p> Where the first line specifies a universal identification structure: random variable (<a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">bdm::RV</a>).</p>
-<h2><a class="anchor" id="ug_rvs">
+</pre></div> Where the first line specifies a universal identification structure: random variable (<a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">bdm::RV</a>).<h2><a class="anchor" name="ug_rvs">
 What is RV and how to use it</a></h2>
-<p>RV stands for <code>random</code> <code>variable</code> which is a description of random variable or its realization. This object playes role of identifier of elements of vectors of data (in datasources), expected inputs to functions (in pdfs), or required results (operations conditioning).</p>
-<p>Mathematical interpretation of RV is straightforward. Consider pdf <img class="formulaInl" alt="$ f(a)$" src="form_142.png"/>, then <img class="formulaInl" alt="$ a $" src="form_143.png"/> is the part represented by RV. Explicit naming of random variables may seem unnecessary for many operations with pdf, e.g. for generation of a uniform sample from &lt;0,1&gt; it is not necessary to specify any random variable. For this reason, RV are often optional information to specify. However, the considered scenanrio <code>simulator</code> is build in a way that requires RV to be given.</p>
-<p>In software, <code>RV</code> has three compulsory properties:</p>
-<ul>
-<li><b>name</b>, unique identifier, two RV with the same name are considered to be identical</li>
-<li><b>size</b>, size of the random variable, if not given it is assumed to be 1,</li>
-<li><b>time</b>, more exactly time shift from <img class="formulaInl" alt="$ t $" src="form_18.png"/>, defaults to 0. For example, scalar <img class="formulaInl" alt="$ x_{t-2} $" src="form_178.png"/> is encoded as (name='x',sizes=1,time=-2). Each RV stores array of these elements, hence RV with: <div class="fragment"><pre class="fragment"> names={<span class="charliteral">&apos;a&apos;</span>, <span class="charliteral">&apos;b&apos;</span>};
+RV stands for <code>random</code> <code>variable</code> which is a description of random variable or its realization. This object playes role of identifier of elements of vectors of data (in datasources), expected inputs to functions (in pdfs), or required results (operations conditioning).<p>
+Mathematical interpretation of RV is straightforward. Consider pdf <img class="formulaInl" alt="$ f(a)$" src="form_142.png">, then <img class="formulaInl" alt="$ a $" src="form_143.png"> is the part represented by RV. Explicit naming of random variables may seem unnecessary for many operations with pdf, e.g. for generation of a uniform sample from &lt;0,1&gt; it is not necessary to specify any random variable. For this reason, RV are often optional information to specify. However, the considered scenanrio <code>simulator</code> is build in a way that requires RV to be given.<p>
+In software, <code>RV</code> has three compulsory properties:<ul>
+<li><b>name</b>, unique identifier, two RV with the same name are considered to be identical</li><li><b>size</b>, size of the random variable, if not given it is assumed to be 1,</li><li><b>time</b>, more exactly time shift from <img class="formulaInl" alt="$ t $" src="form_18.png">, defaults to 0. For example, scalar <img class="formulaInl" alt="$ x_{t-2} $" src="form_178.png"> is encoded as (name='x',sizes=1,time=-2). Each RV stores array of these elements, hence RV with: <div class="fragment"><pre class="fragment"> names={<span class="charliteral">'a'</span>, <span class="charliteral">'b'</span>};
  sizes=[ 2 , 3];
  times=[-1, 1];
-</pre></div> denotes 5-dimensional vector <img class="formulaInl" alt="$ [a_{t-1}', b_{t+1}] $" src="form_179.png"/>.</li>
-</ul>
-<h3><a class="anchor" id="ug_rv_alg">
+</pre></div> denotes 5-dimensional vector <img class="formulaInl" alt="$ [a_{t-1}, b_{t+1}] $" src="form_194.png">.</li></ul>
+<h3><a class="anchor" name="ug_rv_alg">
 Algebra on RVs</a></h3>
-<p>Algebra on RVs (adding, searching in, subtraction, intersection, etc.) is implemented, see <a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">bdm::RV</a>.</p>
-<p>For convenience in Matlab, the following operations are defined:</p>
-<ul>
-<li>RV(names,sizes,times) creates configuration structure for RV,</li>
-<li>RVjoin(rvs) joins configuration structures for array of RVs rvs=[rv1,rv2,...],</li>
-<li>RVtimes(rvs,times) assign times to corresponding rvs.</li>
-</ul>
-<p>See examples in bdmtoolbox/tutorial/userguide</p>
-<h3><a class="anchor" id="ug_rv_connect">
+Algebra on RVs (adding, searching in, subtraction, intersection, etc.) is implemented, see <a class="el" href="classbdm_1_1RV.html" title="Class representing variables, most often random variables.">bdm::RV</a>.<p>
+For convenience in Matlab, the following operations are defined:<ul>
+<li>RV(names,sizes,times) creates configuration structure for RV,</li><li>RVjoin(rvs) joins configuration structures for array of RVs rvs=[rv1,rv2,...],</li><li>RVtimes(rvs,times) assign times to corresponding rvs.</li></ul>
+<p>
+See examples in bdmtoolbox/tutorial/userguide<h3><a class="anchor" name="ug_rv_connect">
 ug_rv_connect</a></h3>
-<p>The <code>simulator</code> scenario connects the DataSource to second basic class of BDM, bdm:logger. The logger is a class that take care of storing results -- in this case, results of simulation. The connection between these blocks is done automatically. The logger stores results of simulations under the names specified in drv. Readers familiar with Simulink environment may look at the RV as being unique identifiers of inputs and outputs of simulation blocks. The inputs are connected automatically with the outputs with matching RV. This view is however, very incomplete, RV have more roles than this.</p>
-<h2><a class="anchor" id="loggers">
+The <code>simulator</code> scenario connects the DataSource to second basic class of BDM, bdm:logger. The logger is a class that take care of storing results -- in this case, results of simulation. The connection between these blocks is done automatically. The logger stores results of simulations under the names specified in drv. Readers familiar with Simulink environment may look at the RV as being unique identifiers of inputs and outputs of simulation blocks. The inputs are connected automatically with the outputs with matching RV. This view is however, very incomplete, RV have more roles than this.<h2><a class="anchor" name="loggers">
 Loggers for flexible handling of results</a></h2>
-<p>Loggers are universal objects for storing and manipulating the results of an experiment. Similar to DataSource, every logger has to provide basic functionality:</p>
-<ol type="1">
-<li>initialize its storage (<a class="el" href="classbdm_1_1logger.html#acd6291a73491f755dc7bc88d022eb2fc" title="Initialize the storage.">bdm::logger.init()</a>),</li>
-<li>assign a connection point to each interested object (bdm::logger.logadd()),</li>
-<li>accept data to be logged to given connection (<a class="el" href="classbdm_1_1logger.html#ae30f695619931b3c372ab280e452d309" title="log this vector">bdm::logger.logit()</a>),</li>
-<li>finalize the storage when experiment is finished.</li>
-</ol>
-<p>These abstarct operations can be specialized in many ways. For example, storing all results in memory and writing them to disc when finished (<a class="el" href="classbdm_1_1memlog.html">bdm::memlog</a>), storing data in a matlab structure (<a class="el" href="classbdm_1_1mexlog.html" title="Logger storing results into an mxArray.">bdm::mexlog</a>), writing them out in ascii (<a class="el" href="classbdm_1_1stdlog.html" title="Simple logger used for debugging All data records are written out to std from where...">bdm::stdlog</a>) or more sophisticated buffered output to harddrive (<a class="el" href="classbdm_1_1dirfilelog.html" title="Logging into dirfile with buffer in memory.">bdm::dirfilelog</a>).</p>
-<p>Since all experiments are performed in matlab, the default mexlog class will be used. However, the way how the results are to be stored can be configured using configuration structure filled by fields from <code>from_setting</code> of the chosen logger, and passing it as third argument to <code>simulator</code>.</p>
-<h2><a class="anchor" id="ug_datasource">
+Loggers are universal objects for storing and manipulating the results of an experiment. Similar to DataSource, every logger has to provide basic functionality:<ol type=1>
+<li>initialize its storage (<a class="el" href="classbdm_1_1logger.html#cd6291a73491f755dc7bc88d022eb2fc" title="Initialize the storage.">bdm::logger.init()</a>),</li><li>assign a connection point to each interested object (bdm::logger.logadd()),</li><li>accept data to be logged to given connection (<a class="el" href="classbdm_1_1logger.html#e30f695619931b3c372ab280e452d309" title="log this vector">bdm::logger.logit()</a>),</li><li>finalize the storage when experiment is finished.</li></ol>
+<p>
+These abstarct operations can be specialized in many ways. For example, storing all results in memory and writing them to disc when finished (<a class="el" href="classbdm_1_1memlog.html">bdm::memlog</a>), storing data in a matlab structure (<a class="el" href="classbdm_1_1mexlog.html" title="Logger storing results into an mxArray.">bdm::mexlog</a>), writing them out in ascii (<a class="el" href="classbdm_1_1stdlog.html" title="Simple logger used for debugging All data records are written out to std from where...">bdm::stdlog</a>) or more sophisticated buffered output to harddrive (<a class="el" href="classbdm_1_1dirfilelog.html" title="Logging into dirfile with buffer in memory.">bdm::dirfilelog</a>).<p>
+Since all experiments are performed in matlab, the default mexlog class will be used. However, the way how the results are to be stored can be configured using configuration structure filled by fields from <code>from_setting</code> of the chosen logger, and passing it as third argument to <code>simulator</code>.<h2><a class="anchor" name="ug_datasource">
 Class inheritance and DataSources</a></h2>
-<p>As mentioned above, the scenario <code>simulator</code> is written to accept any datasource (i.e. any offspring of <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a>). For full list of offsprings, click see Classes &gt; Class Hierarchy.</p>
-<p>At the time of writing this tutorial, available datasources are <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a></p>
-<ul>
-<li><a class="el" href="classbdm_1_1EpdfDS.html" title="Simulate data from a static pdf (epdf).">bdm::EpdfDS</a></li>
-<li><a class="el" href="classbdm_1_1MemDS.html" title="Memory storage of off-line data column-wise.">bdm::MemDS</a><ul>
+As mentioned above, the scenario <code>simulator</code> is written to accept any datasource (i.e. any offspring of <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a>). For full list of offsprings, click see Classes &gt; Class Hierarchy.<p>
+At the time of writing this tutorial, available datasources are <a class="el" href="classbdm_1_1DS.html" title="Abstract class for discrete-time sources of data.">bdm::DS</a><ul>
+<li><a class="el" href="classbdm_1_1EpdfDS.html" title="Simulate data from a static pdf (epdf).">bdm::EpdfDS</a></li><li><a class="el" href="classbdm_1_1MemDS.html" title="Memory storage of off-line data column-wise.">bdm::MemDS</a><ul>
 <li><a class="el" href="classbdm_1_1FileDS.html">bdm::FileDS</a><ul>
-<li><a class="el" href="classbdm_1_1CsvFileDS.html" title="CSV file data storage The constructor creates Data matrix from the records in a CSV...">bdm::CsvFileDS</a></li>
-<li><a class="el" href="classbdm_1_1ITppFileDS.html" title="Read Data Matrix from an IT file.">bdm::ITppFileDS</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="el" href="classbdm_1_1MpdfDS.html" title="Simulate data from conditional density Still having only one density but allowing...">bdm::MpdfDS</a></li>
-<li><a class="el" href="classbdm_1_1stateDS.html">bdm::stateDS</a></li>
-</ul>
-<p>The MemDS has already been introduced in the example in memds. However, any of the classes listed above can be used to replace it in the example. This will be demonstrated on the <code>EpdfDS</code> class.</p>
-<p>Brief decription of the class states that EpdfDS "Simulate data from a static pdf (epdf)". The static pdf means unconditional pdf in the sense that the random variable is conditioned by numerical values only. In mathematical notation it could be both <img class="formulaInl" alt="$ f(a) $" src="form_144.png"/> and <img class="formulaInl" alt="$ f(x_t |d_1 \ldots d_t)$" src="form_145.png"/>. The latter case is true only when all <img class="formulaInl" alt="$ d $" src="form_146.png"/> denotes observed values.</p>
-<p>For example, we wish to simulate realizations of a Uniform pdf on interval &lt;-1,1&gt;. This is achieved by plugging an object representing uniform pdf into general simulator of independent random samples, EpdfDS. Uniform density is implemented as class <a class="el" href="classbdm_1_1euni.html" title="Uniform distributed density on a rectangular support.">bdm::euni</a>. An instance of <code>euni</code> can be again created method <code>from_setting</code>, in this case <a class="el" href="classbdm_1_1euni.html#a77f5fef1f006fe056066da23b9e5f042">bdm::euni.from_setting()</a>. Using documentation we define it with the following code: </p>
-<div class="fragment"><pre class="fragment">U.class=<span class="stringliteral">&apos;euni&apos;</span>;
-U.rv   = RV({<span class="charliteral">&apos;a&apos;</span>});
+<li><a class="el" href="classbdm_1_1CsvFileDS.html" title="CSV file data storage The constructor creates Data matrix from the records in a CSV...">bdm::CsvFileDS</a></li><li><a class="el" href="classbdm_1_1ITppFileDS.html" title="Read Data Matrix from an IT file.">bdm::ITppFileDS</a></li></ul>
+</li></ul>
+</li><li><a class="el" href="classbdm_1_1MpdfDS.html" title="Simulate data from conditional density Still having only one density but allowing...">bdm::MpdfDS</a></li><li>bdm::stateDS</li></ul>
+<p>
+The MemDS has already been introduced in the example in memds. However, any of the classes listed above can be used to replace it in the example. This will be demonstrated on the <code>EpdfDS</code> class.<p>
+Brief decription of the class states that EpdfDS "Simulate data from a static pdf (epdf)". The static pdf means unconditional pdf in the sense that the random variable is conditioned by numerical values only. In mathematical notation it could be both <img class="formulaInl" alt="$ f(a) $" src="form_144.png"> and <img class="formulaInl" alt="$ f(x_t |d_1 \ldots d_t)$" src="form_145.png">. The latter case is true only when all <img class="formulaInl" alt="$ d $" src="form_146.png"> denotes observed values.<p>
+For example, we wish to simulate realizations of a Uniform pdf on interval &lt;-1,1&gt;. This is achieved by plugging an object representing uniform pdf into general simulator of independent random samples, EpdfDS. Uniform density is implemented as class <a class="el" href="classbdm_1_1euni.html" title="Uniform distributed density on a rectangular support.">bdm::euni</a>. An instance of <code>euni</code> can be again created method <code>from_setting</code>, in this case <a class="el" href="classbdm_1_1euni.html#77f5fef1f006fe056066da23b9e5f042">bdm::euni.from_setting()</a>. Using documentation we define it with the following code: <div class="fragment"><pre class="fragment">U.class=<span class="stringliteral">'euni'</span>;
+U.rv   = RV({<span class="charliteral">'a'</span>});
 U.high = 1.0;
 U.low  = -1.0;
-</pre></div><p> which encodes information:</p>
-<p class="formulaDsp">
-<img class="formulaDsp" alt="\[ f(a) = \mathcal{U}(-1,1) \]" src="form_160.png"/>
-</p>
-<p>The datasource itself, i.e. the instanc of <code>EpdfDS</code> can be then configured via: </p>
-<div class="fragment"><pre class="fragment">DS.class = <span class="stringliteral">&apos;EpdfDS&apos;</span>;
+</pre></div> which encodes information:<p class="formulaDsp">
+<img class="formulaDsp" alt="\[ f(a) = \mathcal{U}(-1,1) \]" src="form_160.png">
+<p>
+<p>
+The datasource itself, i.e. the instanc of <code>EpdfDS</code> can be then configured via: <div class="fragment"><pre class="fragment">DS.class = <span class="stringliteral">'EpdfDS'</span>;
 DS.epdf  = U;
-</pre></div><p> where <code>U</code> is the structure defined above.</p>
-<p>Contrary to the previous example, we need to tell to algorithm <code>simulator</code> how many samples from the data source we need. This is configured by variable <code>experiment.ndat</code>. The configuration has to be finalized by: </p>
-<div class="fragment"><pre class="fragment">experiment.ndat = 10;
+</pre></div> where <code>U</code> is the structure defined above.<p>
+Contrary to the previous example, we need to tell to algorithm <code>simulator</code> how many samples from the data source we need. This is configured by variable <code>experiment.ndat</code>. The configuration has to be finalized by: <div class="fragment"><pre class="fragment">experiment.ndat = 10;
 M=simulator(DS,experiment);
-</pre></div><p>The result is as expected in field <code>M.a</code> the name of which corresponds to name of <code>U.rv</code> .</p>
-<p>If the task was only to generate random realizations, this would indeed be a very clumsy way of doing it. However, the power of the proposed approach will be revelead in more demanding examples, one of which follows next.</p>
-<h2><a class="anchor" id="ug_arx_sim">
+</pre></div><p>
+The result is as expected in field <code>M.a</code> the name of which corresponds to name of <code>U.rv</code> .<p>
+If the task was only to generate random realizations, this would indeed be a very clumsy way of doing it. However, the power of the proposed approach will be revelead in more demanding examples, one of which follows next.<h2><a class="anchor" name="ug_arx_sim">
 Simulating autoregressive model</a></h2>
-<p>Consider the following autoregressive model: </p>
-<p class="formulaDsp">
-<img class="formulaDsp" alt="\[ f(y_t|y_{t-3},u_{t-1}) = \mathcal{N}( a y_{t-3} + b u_{t-1}, r) \]" src="form_161.png"/>
-</p>
-<p> where <img class="formulaInl" alt="$ a,b $" src="form_148.png"/> are known constants, and <img class="formulaInl" alt="$ r $" src="form_149.png"/> is known variance.</p>
-<p>Direct application of <code>EpdfDS</code> is not possible, since the pdf above is conditioned on values of <img class="formulaInl" alt="$ y_{t-3}$" src="form_150.png"/> and <img class="formulaInl" alt="$ u_{t-1}$" src="form_151.png"/>. We need to handle two issues:</p>
-<ol type="1">
-<li>extra unsimulated variable <img class="formulaInl" alt="$ u $" src="form_152.png"/>,</li>
-<li>time delayes of the values.</li>
-</ol>
-<p>The first issue can be handled in two ways. First, <img class="formulaInl" alt="$ u $" src="form_152.png"/> can be considered as input and as such it could be externally given to the datasource. This solution is used in scenario <code>closedloop</code>. However, for the <code>simulator</code> scenario we will apply the second option, that is we complement <img class="formulaInl" alt="$ f(y_{t}|y_{t-3},u_{t-1})$" src="form_153.png"/> by extra pdf:</p>
-<p class="formulaDsp">
-<img class="formulaDsp" alt="\[ f(u_t) = \mathcal{N}(0, r_u) \]" src="form_162.png"/>
-</p>
-<p> where <img class="formulaInl" alt="$ r_u $" src="form_163.png"/> is another known constant. Thus, the joint density is now:</p>
-<p class="formulaDsp">
-<img class="formulaDsp" alt="\[ f(y_{t},u_{t}|y_{t-3},u_{t-1}) = f(y_{t}|y_{t-3},u_{t-1})f(u_{t}) \]" src="form_155.png"/>
-</p>
-<p> and we have no need for input since the datasource have all necessary information inside. All that is required is to store them and copy their values to appropriate places.</p>
-<p>That is done in automatic way using dedicated class <a class="el" href="classbdm_1_1datalink__buffered.html" title="Datalink that buffers delayed values - do not forget to call step().">bdm::datalink_buffered</a>. The only issue a user may need to take care about is the missing initial conditions for simulation. By default these are set to zeros. Using the default values, the full configuration of this system is: </p>
-<div class="fragment"><pre class="fragment">y = RV({<span class="charliteral">&apos;y&apos;</span>});
-u = RV({<span class="charliteral">&apos;u&apos;</span>});
-
-fy.class = <span class="stringliteral">&apos;mlnorm&lt;ldmat&gt;&apos;</span>;
+Consider the following autoregressive model: <p class="formulaDsp">
+<img class="formulaDsp" alt="\[ f(y_t|y_{t-3},u_{t-1}) = \mathcal{N}( a y_{t-3} + b u_{t-1}, r) \]" src="form_161.png">
+<p>
+ where <img class="formulaInl" alt="$ a,b $" src="form_148.png"> are known constants, and <img class="formulaInl" alt="$ r $" src="form_149.png"> is known variance.<p>
+Direct application of <code>EpdfDS</code> is not possible, since the pdf above is conditioned on values of <img class="formulaInl" alt="$ y_{t-3}$" src="form_150.png"> and <img class="formulaInl" alt="$ u_{t-1}$" src="form_151.png">. We need to handle two issues:<ol type=1>
+<li>extra unsimulated variable <img class="formulaInl" alt="$ u $" src="form_152.png">,</li><li>time delayes of the values.</li></ol>
+<p>
+The first issue can be handled in two ways. First, <img class="formulaInl" alt="$ u $" src="form_152.png"> can be considered as input and as such it could be externally given to the datasource. This solution is used in scenario <code>closedloop</code>. However, for the <code>simulator</code> scenario we will apply the second option, that is we complement <img class="formulaInl" alt="$ f(y_{t}|y_{t-3},u_{t-1})$" src="form_153.png"> by extra pdf:<p class="formulaDsp">
+<img class="formulaDsp" alt="\[ f(u_t) = \mathcal{N}(0, r_u) \]" src="form_162.png">
+<p>
+ where <img class="formulaInl" alt="$ r_u $" src="form_163.png"> is another known constant. Thus, the joint density is now:<p class="formulaDsp">
+<img class="formulaDsp" alt="\[ f(y_{t},u_{t}|y_{t-3},u_{t-1}) = f(y_{t}|y_{t-3},u_{t-1})f(u_{t}) \]" src="form_155.png">
+<p>
+ and we have no need for input since the datasource have all necessary information inside. All that is required is to store them and copy their values to appropriate places.<p>
+That is done in automatic way using dedicated class <a class="el" href="classbdm_1_1datalink__buffered.html" title="Datalink that buffers delayed values - do not forget to call step().">bdm::datalink_buffered</a>. The only issue a user may need to take care about is the missing initial conditions for simulation. By default these are set to zeros. Using the default values, the full configuration of this system is: <div class="fragment"><pre class="fragment">y = RV({<span class="charliteral">'y'</span>});
+u = RV({<span class="charliteral">'u'</span>});
+
+fy.class = <span class="stringliteral">'mlnorm&lt;ldmat&gt;'</span>;
 fy.rv    = y;
-fy.rvc   = RV({<span class="charliteral">&apos;y&apos;</span>,<span class="charliteral">&apos;u&apos;</span>}, [1 1], [-3, -1]);
+fy.rvc   = RV({<span class="charliteral">'y'</span>,<span class="charliteral">'u'</span>}, [1 1], [-3, -1]);
 fy.A     = [0.5, -0.9];
 fy.const = 0;
@@ -236,43 +184,35 @@
 
 
-fu.class = <span class="stringliteral">&apos;enorm&lt;ldmat&gt;&apos;</span>;
+fu.class = <span class="stringliteral">'enorm&lt;ldmat&gt;'</span>;
 fu.rv    = u;
 fu.mu    = 0;
 fu.R     = 0.2;
 
-DS.class = <span class="stringliteral">&apos;MpdfDS&apos;</span>;
-DS.mpdf.class  = <span class="stringliteral">&apos;mprod&apos;</span>;
+DS.class = <span class="stringliteral">'MpdfDS'</span>;
+DS.mpdf.class  = <span class="stringliteral">'mprod'</span>;
 DS.mpdf.mpdfs  = {fy, epdf2mpdf(fu)};
-</pre></div><p>Explanation of this example will require few remarks:</p>
-<ul>
-<li>class of the <code>fy</code> object is 'mlnorm&lt;ldmat&gt;' which is Normal pdf with mean value given by linear function, and covariance matrix stored in LD decomposition, see <a class="el" href="classbdm_1_1mlnorm.html" title="Normal distributed linear function with linear function of mean value;.">bdm::mlnorm</a> for details.</li>
-<li>naming convention 'mlnorm&lt;ldmat&gt;' relates to the concept of templates in C++. For those unfamiliar with this concept, it is basicaly a way how to share code for different flavours of the same object. Note that mlnorm exist in three versions: mlnorm&lt;ldmat&gt;, <a class="el" href="classbdm_1_1mlnorm.html">mlnorm&lt;chmat&gt;</a>, mlnorm&lt;fsqmat&gt;. Those classes act identically the only difference is that the internal data are stored either in LD decomposition, choleski decomposition or full matrices, respectively.</li>
-<li>the same concept is used for enorm, where <a class="el" href="classbdm_1_1enorm.html">enorm&lt;chmat&gt;</a> and <a class="el" href="classbdm_1_1enorm.html">enorm&lt;fsqmat&gt;</a> are also possible. In this particular use, these objects are equivalent. In specific situation, e.g. Kalman filter implemented on Choleski decomposition (<a class="el" href="classbdm_1_1KalmanCh.html" title="Kalman filter in square root form.">bdm::KalmanCh</a>), only <a class="el" href="classbdm_1_1enorm.html">enorm&lt;chmat&gt;</a> is approprate.</li>
-<li>class 'mprod' represents the chain rule of probability. Attribute <code>mpdfs</code> of its configuration structure is a list of conditional densities. Conditional density <img class="formulaInl" alt="$ f(a|b)$" src="form_156.png"/> is represented by class <code>mpdf</code> and its offsprings. Class <code>RV</code> is used to describe both variables before conditioning (field <code>rv</code> ) and after conditioning sign (field <code>rvc</code>).</li>
-<li>due to simplicity of implementation, mprod accept only conditional densities in the field <code>mpdfs</code>. Hence, the pdf <img class="formulaInl" alt="$ f(u_t)$" src="form_157.png"/> must be converted to conditional density with empty conditioning, <img class="formulaInl" alt="$ f(u_t| \{\})$" src="form_158.png"/>. This is achieved by calling function epdf2mpdf which is only a trivial wrapper creating class <a class="el" href="classbdm_1_1mepdf.html" title="Unconditional mpdf, allows using epdf in the role of mpdf.">bdm::mepdf</a>.</li>
-</ul>
-<p>The code above can be immediatelly run, usin the same execution sequence of <code>estimator</code> as above.</p>
-<h3><a class="anchor" id="ug_ini">
+</pre></div><p>
+Explanation of this example will require few remarks:<ul>
+<li>class of the <code>fy</code> object is 'mlnorm&lt;ldmat&gt;' which is Normal pdf with mean value given by linear function, and covariance matrix stored in LD decomposition, see <a class="el" href="classbdm_1_1mlnorm.html" title="Normal distributed linear function with linear function of mean value;.">bdm::mlnorm</a> for details.</li><li>naming convention 'mlnorm&lt;ldmat&gt;' relates to the concept of templates in C++. For those unfamiliar with this concept, it is basicaly a way how to share code for different flavours of the same object. Note that mlnorm exist in three versions: mlnorm&lt;ldmat&gt;, <a class="el" href="classbdm_1_1mlnorm.html">mlnorm&lt;chmat&gt;</a>, mlnorm&lt;fsqmat&gt;. Those classes act identically the only difference is that the internal data are stored either in LD decomposition, choleski decomposition or full matrices, respectively.</li><li>the same concept is used for enorm, where <a class="el" href="classbdm_1_1enorm.html">enorm&lt;chmat&gt;</a> and <a class="el" href="classbdm_1_1enorm.html">enorm&lt;fsqmat&gt;</a> are also possible. In this particular use, these objects are equivalent. In specific situation, e.g. Kalman filter implemented on Choleski decomposition (<a class="el" href="classbdm_1_1KalmanCh.html" title="Kalman filter in square root form.">bdm::KalmanCh</a>), only <a class="el" href="classbdm_1_1enorm.html">enorm&lt;chmat&gt;</a> is approprate.</li><li>class 'mprod' represents the chain rule of probability. Attribute <code>mpdfs</code> of its configuration structure is a list of conditional densities. Conditional density <img class="formulaInl" alt="$ f(a|b)$" src="form_156.png"> is represented by class <code>mpdf</code> and its offsprings. Class <code>RV</code> is used to describe both variables before conditioning (field <code>rv</code> ) and after conditioning sign (field <code>rvc</code>).</li><li>due to simplicity of implementation, mprod accept only conditional densities in the field <code>mpdfs</code>. Hence, the pdf <img class="formulaInl" alt="$ f(u_t)$" src="form_157.png"> must be converted to conditional density with empty conditioning, <img class="formulaInl" alt="$ f(u_t| \{\})$" src="form_158.png">. This is achieved by calling function epdf2mpdf which is only a trivial wrapper creating class <a class="el" href="classbdm_1_1mepdf.html" title="Unconditional mpdf, allows using epdf in the role of mpdf.">bdm::mepdf</a>.</li></ul>
+<p>
+The code above can be immediatelly run, usin the same execution sequence of <code>estimator</code> as above.<h3><a class="anchor" name="ug_ini">
 Initializing simulation</a></h3>
-<p>When zeros are not appropriate initial conditions, the correct conditions can be set using additional commands (see <a class="el" href="classbdm_1_1MpdfDS.html#a39ef55fb36da354c93c544129e03f558">bdm::MpdfDS.from_setting()</a> ): </p>
-<div class="fragment"><pre class="fragment">DS.init_rv = RV({<span class="charliteral">&apos;y&apos;</span>,<span class="charliteral">&apos;y&apos;</span>,<span class="charliteral">&apos;y&apos;</span>}, [1,1,1], [-1,-2,-3]);
+When zeros are not appropriate initial conditions, the correct conditions can be set using additional commands (see <a class="el" href="classbdm_1_1MpdfDS.html#39ef55fb36da354c93c544129e03f558">bdm::MpdfDS.from_setting()</a> ): <div class="fragment"><pre class="fragment">DS.init_rv = RV({<span class="charliteral">'y'</span>,<span class="charliteral">'y'</span>,<span class="charliteral">'y'</span>}, [1,1,1], [-1,-2,-3]);
 DS.init_values = [0.1, 0.2, 0.3];
-</pre></div><p>The values of <code>init_values</code> will be copied to places in history identified by corresponding values of <code>init_rv</code>. Initial data is not checked for completeness, i.e. values of random variables missing from <code>init_rv</code> (in this case all occurences of <img class="formulaInl" alt="$ u $" src="form_152.png"/>) are still initialized to 0.</p>
-<h2><a class="anchor" id="ug_store">
+</pre></div><p>
+The values of <code>init_values</code> will be copied to places in history identified by corresponding values of <code>init_rv</code>. Initial data is not checked for completeness, i.e. values of random variables missing from <code>init_rv</code> (in this case all occurences of <img class="formulaInl" alt="$ u $" src="form_152.png">) are still initialized to 0.<h2><a class="anchor" name="ug_store">
 Storing results of simulation</a></h2>
-<p>If the simulated data are to be analyzed off-line it may be advantageous to store them and use for later use. This operation is straightforward if the class of logger used in the <code>simulator</code> is compatible with some datasource class.</p>
-<p>For example, the output of <code>MemDS</code> can be stored as an .it file (filename is specified in configuration structure) which can be later read by <a class="el" href="classbdm_1_1ITppFileDS.html" title="Read Data Matrix from an IT file.">bdm::ITppFileDS</a>.</p>
-<p>In matlab, the output of mexlog is a structure of vectors or matrices. The results can be saved in a matlab file using: </p>
-<div class="fragment"><pre class="fragment">Data=[M.y; M.u];
+If the simulated data are to be analyzed off-line it may be advantageous to store them and use for later use. This operation is straightforward if the class of logger used in the <code>simulator</code> is compatible with some datasource class.<p>
+For example, the output of <code>MemDS</code> can be stored as an .it file (filename is specified in configuration structure) which can be later read by <a class="el" href="classbdm_1_1ITppFileDS.html" title="Read Data Matrix from an IT file.">bdm::ITppFileDS</a>.<p>
+In matlab, the output of mexlog is a structure of vectors or matrices. The results can be saved in a matlab file using: <div class="fragment"><pre class="fragment">Data=[M.y; M.u];
 drv = RVjoin({y,u});
 save mpdfds_results Data drv
-</pre></div><p> Such data can be later provided e.g. by MemDS </p>
-<div class="fragment"><pre class="fragment">mxDS.class   = <span class="stringliteral">&apos;MemDS&apos;</span>;
-mxDS.Data    = <span class="stringliteral">&apos;Data&apos;</span>;
+</pre></div> Such data can be later provided e.g. by MemDS <div class="fragment"><pre class="fragment">mxDS.class   = <span class="stringliteral">'MemDS'</span>;
+mxDS.Data    = <span class="stringliteral">'Data'</span>;
 mxDS.drv     = drv;
 </pre></div> </div>
-<hr size="1"/><address style="text-align: right;"><small>Generated on Sun Sep 27 00:49:04 2009 for mixpp by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Wed Oct 7 17:34:44 2009 for mixpp by&nbsp;
 <a href="http://www.doxygen.org/index.html">
-<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
+<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.9 </small></address>
 </body>
 </html>
