root/library/doc/tutorial/005userguide0.dox @ 994

Revision 983, 3.1 kB (checked in by smidl, 14 years ago)

doc - extensions

Line 
1/*!
2\page userguide0 BDM Use - Introduction
3
4BDM is a library of basic components for Bayesian decision making, hence its direct use is not possible. In order to use BDM the components must be pulled together in order to achieve desired functionality. We expect two kinds of users:
5
6 - <b> Experimenters </b> who run prepared scripts with different parameterizations and analyze their results,
7 - <b> Advanced users</b> who are able to extend functionality by filling prepared Matlab classes,
8 - <b> Porgrammers </b> who are able to implement algorithms withing C++ backend of BDM.
9
10This tutorial is intended for the first two classes of users. Programmers should read it for introduction and then follow to the Doxygen maunal.
11
12The logic of bdmtoolbox is that the experiment is run in C++ via mex-file. Parameterization of the task is done via Matlab structures.
13A range of selected "callback" functions to Matlab is available. This range can be extended by a Programmer, please contact authors if available extension point are not satisfactory for you.
14
15\section param Experiment is fully parameterized before execution
16
17The main logic behind the experiment is that all necessary information about it are gathered in advance in a configuration structure.
18This approach was designed especially for time consuming  experiments and Monte-Carlo studies for which it suits the most.
19
20For smaller decision making tasks, interactive use of the experiment can be achieved by showing the full configuration structure (or its selected parts),
21running the experiment on demand and showing the results.
22
23Semi-interactive experiments can be designed by sequential run of different algorithms. This topic will be covered in advanced documentation.
24
25\section secnario Prepared Scenarios
26
27Since some tasks are repeatedly occuring in practical applications of decision making, these tasks has been identified and prepared as standalone applications (or mex files). These tasks are implemented in separate toolbox - bdmtoolbox. Binary version of the toolbox is available see \ref install.
28
29The predefined scenarios are:
30 - <b>Data simulation</b>: a task that arise in modelling of real physical experiment. For example, this scenario allows empirical comparison of observed and simulated data.
31 - <b>Sequential estimation</b>: the previous scenario is extended by on-line estimation of model parameters. It allows to run multiple estimators in parallel allowing their mutual comparison.
32 - <b>Closed loop</b>: sequantial estimation from previous step is complemneted by adaptive controller (or decision maker) that designs control strategy for the next step.
33
34Mex files for some atomic operations with internal objects are provided for comfortable definition of an experiment and analysis.
35These functions are not efficient for use in repettitive way.
36
37These scenarios may serve as a starting point for advanced users who can design specific algorithms tailored for given application domain.
38
39A tutorial how to run the scenarios are:
40
41 - \ref userguide_pdf
42 - \ref userguide_sim
43 - \ref userguide_estim
44
45*/
Note: See TracBrowser for help on using the browser.