opentl::models::Motion Class Reference

Abstract class for object motion models. More...

Inherited by opentl::models::LinearARModels.

List of all members.

Public Types
Public Member Functions
virtual MotionType	getMotionType ()
	get motion type (see above)
virtual math::SquareMatrix &	getNoiseCovariance ()=0
	Get process noise covariance matrix.
virtual int	getNoiseDim ()=0
	Returns dimension of process noise square matrix.
virtual void	getUniformPrior (opentl::core::State &srcDstState)=0
	Function to get the first state prior for the tracking. The filter calls this function at initialization. Requires to call setNoiseCovariance() first to get range values for uniform distribution.
	Motion (MotionType motionType)
virtual void	predictMotion (opentl::core::State &srcDstState, bool addNoise=false, math::SquareMatrix **noiseCovMat=NULL, math::SquareMatrix **jacStateTrans=NULL, math::Vector *inputU=NULL)=0
	Predicts state(k+1) based on specific motion model.
virtual void	setAveragePose (const math::Vector &averagePose)=0
	Set average pose value (used by some models with additive update).
virtual void	setFixedDeltaT (double fixedDeltaT=0.0f)=0
	Sets a fixed delta t.
virtual void	setNoiseCovariance (const math::SquareMatrix &noiseCovMat)=0
	Set process noise covariance, and update matrices accordingly.
virtual void	setUniformNoiseRange (const math::Vector &uniformNoiseRange)=0
	Set uniform noise range (for the initial prior).
virtual	~Motion ()

---

Detailed Description

Abstract class for object motion models.

Author:

Claus Lenz, lenz@in.tum.de; Erwin Roth, erwin.roth@weihenstephan.org

---

Member Enumeration Documentation

enum opentl::models::Motion::MotionType

ENUM type specifying the motion type (useful for quickly knowing the number of state derivatives or replica).

Enumerator:

BROWNIAN
CWNA
OSCILL

---

Constructor & Destructor Documentation

opentl::models::Motion::Motion

(

MotionType

motionType

)

virtual opentl::models::Motion::~Motion

(

)

[virtual]

---

Member Function Documentation

virtual MotionType opentl::models::Motion::getMotionType

(

)

[inline, virtual]

get motion type (see above)

virtual math::SquareMatrix& opentl::models::Motion::getNoiseCovariance

(

)

[pure virtual]

Get process noise covariance matrix.

Implemented in opentl::models::LinearARModels.

virtual int opentl::models::Motion::getNoiseDim

(

)

[pure virtual]

Returns dimension of process noise square matrix.

Returns:

Dimension of process noise

Implemented in opentl::models::LinearARModels.

virtual void opentl::models::Motion::getUniformPrior

(

opentl::core::State &

srcDstState

)

[pure virtual]

Function to get the first state prior for the tracking. The filter calls this function at initialization. Requires to call setNoiseCovariance() first to get range values for uniform distribution.

Parameters:

srcDstState

State used as basis for initialization of motion

Implemented in opentl::models::LinearARModels.

virtual void opentl::models::Motion::predictMotion	(	opentl::core::State &	srcDstState,
		bool	addNoise = false,
		math::SquareMatrix **	noiseCovMat = NULL,
		math::SquareMatrix **	jacStateTrans = NULL,
		math::Vector *	inputU = NULL
	)			[pure virtual]

Predicts state(k+1) based on specific motion model.

Parameters:

	srcDstState	Variable holding input and output state
	addNoise	Optional: (default = false) if true, process noise will be added to state(k+1)
	noiseCovMat	Gives access to (dynamic) process noise covariance matrix
	jacStateTrans	Optional: returns Jacobian of state transition matrix (must be square)
	inputU	Optional: input control vector (u)

Implemented in opentl::models::LinearARModels.

virtual void opentl::models::Motion::setAveragePose

(

const math::Vector &

averagePose

)

[pure virtual]

Set average pose value (used by some models with additive update).

Parameters:

averagePose

Input average pose vector

Implemented in opentl::models::LinearARModels.

virtual void opentl::models::Motion::setFixedDeltaT

(

double

fixedDeltaT = 0.0f

)

[pure virtual]

Sets a fixed delta t.

Parameters:

fixedDeltaT

value of delta t, if set to 0.0 then delta t is computed dynamically

Implemented in opentl::models::LinearARModels.

virtual void opentl::models::Motion::setNoiseCovariance

(

const math::SquareMatrix &

noiseCovMat

)

[pure virtual]

Set process noise covariance, and update matrices accordingly.

Implemented in opentl::models::LinearARModels.

virtual void opentl::models::Motion::setUniformNoiseRange

(

const math::Vector &

uniformNoiseRange

)

[pure virtual]

Set uniform noise range (for the initial prior).

Parameters:

uniformNoiseRange

Input minimum and maximum values for the absolute pose parameters

Implemented in opentl::models::LinearARModels.