root/library/doc/tutorial/kalman.dox @ 1321

/*!
\page kalman Examples of (extended) Kalman filtering

Kalman filtering and Extended Kalman filtering are special cases of Bayesian filtering. 
The Kalman filter is optimal for linear state space model with Gaussian disturbances, the extended Kalman filter
is derived as linearization of non-linear state space models with Gaussian noises. Hence it is only sub-optimal filter.

More advanced filtering algorithms for non-linear non-Gaussian models can be derived, see ...

\section klm Kalman Filtering
Kalman filtering is optimal estimation procedure for linear state space model:
\f{eqnarray}
x_t &= &A x_{t-1} + B u_{t} + v_t,\\
y_t &= &C x_{t} + D u_{t} + w_t,
\f}
where \f$ x_t \f$ is the state, \f$ y_t \f$ is the system output, \f$ A, B, C, D\f$ are state matrices of appropriate dimensions, \f$v_t, w_t\f$ are zero mean Gaussian noises with covariance matrices \f$Q, R\f$, respectively.

Both prior and posterior densities on the state are Gaussian, i.e. of the class enorm.

There is a range of classes that implements this functionality, namely:
- bdm::KalmanFull which implements the estimation algorithm on full matrices,
- bdm::KalmanCh which implements the estimation algorithm using choleski decompositions and QR  algorithm.

\section ekf Extended Kalman Filtering
Extended Kalman filtering arise by linearization of non-linear state space model:
\f{eqnarray}
x_t &= &g( x_{t-1},  u_{t}) + v_t,\\
y_t &= &h( x_{t} ,  u_{t}) + w_t,
\f}
where \f$ g(), h() \f$ are general non-linear functions which have finite derivatives. Remaining variables have the same meaning as in the Kalman Filter.

In order to use this class, the non-linear functions and their derivatives must be defined as an instance of class \c diffbifn.

Two classes are defined:
- bdm::EKFfull on full size matrices,
- bdm::EKFCh on Choleski decompositions and using QR algorithm.

\section exa Examples of Use

The classes can be used directly in C++ or via User Info. The latter example is illustrated in file \subpage ui. A very short example of the former follows:

\include kalman_simple.cpp

*/