#include <visp3/tt/vpTemplateTrackerWarpSRT.h>

Inheritance diagram for vpTemplateTrackerWarpSRT:

Public Member Functions
	vpTemplateTrackerWarpSRT ()

void	dWarp (const vpColVector &X1, const vpColVector &X2, const vpColVector &ParamM, vpMatrix &dW)

void	dWarpCompo (const vpColVector &X1, const vpColVector &X2, const vpColVector &ParamM, const double *dwdp0, vpMatrix &dW)

void	getdW0 (const int &i, const int &j, const double &dy, const double &dx, double *dIdW)

void	getdWdp0 (const int &i, const int &j, double *dIdW)

void	getParamInverse (const vpColVector &ParamM, vpColVector &ParamMinv) const

void	getParamPyramidDown (const vpColVector &p, vpColVector &pdown)

void	getParamPyramidUp (const vpColVector &p, vpColVector &pup)

bool	isESMcompatible () const

void	pRondp (const vpColVector &p1, const vpColVector &p2, vpColVector &pres) const

void	warpX (const vpColVector &vX, vpColVector &vXres, const vpColVector &ParamM)

void	warpX (const int &i, const int &j, double &i2, double &j2, const vpColVector &ParamM)

void	warpXInv (const vpColVector &vX, vpColVector &vXres, const vpColVector &ParamM)

double	getDistanceBetweenZoneAndWarpedZone (const vpTemplateTrackerZone &Z, const vpColVector &p)

unsigned int	getNbParam () const

void	setNbParam (unsigned int nb)

void	warp (const double ut0, const double vt0, int nb_pt, const vpColVector &p, double u, double v)

void	warpTriangle (const vpTemplateTrackerTriangle &in, const vpColVector &p, vpTemplateTrackerTriangle &out)

void	warpZone (const vpTemplateTrackerZone &in, const vpColVector &p, vpTemplateTrackerZone &out)

Protected Attributes
double	denom

vpMatrix	dW

unsigned int	nbParam

Detailed Description

Examples:: templateTracker.cpp.

Definition at line 54 of file vpTemplateTrackerWarpSRT.h.

Constructor & Destructor Documentation

◆ vpTemplateTrackerWarpSRT()

vpTemplateTrackerWarpSRT::vpTemplateTrackerWarpSRT ( )

Definition at line 42 of file vpTemplateTrackerWarpSRT.cpp.

References vpTemplateTrackerWarp::dW, vpTemplateTrackerWarp::nbParam, and vpArray2D< Type >::resize().

Member Function Documentation

◆ dWarp()

void vpTemplateTrackerWarpSRT::dWarp	(	const vpColVector &	X1,
		const vpColVector &	X2,
		const vpColVector &	ParamM,
		vpMatrix &	dW
	)

virtual

Compute the derivative of the warping function according to its parameters.

Parameters

X1	: Point to consider in the derivative computation.
X2	: Point to consider in the derivative computation.
ParamM	: Parameters of the warping function.
dW	: Resulting derivative matrix.

Implements vpTemplateTrackerWarp.

Definition at line 99 of file vpTemplateTrackerWarpSRT.cpp.

◆ dWarpCompo()

void vpTemplateTrackerWarpSRT::dWarpCompo	(	const vpColVector &	X1,
		const vpColVector &	X2,
		const vpColVector &	ParamM,
		const double *	dwdp0,
		vpMatrix &	dW
	)

virtual

Compute the compositionnal derivative of the warping function according to its parameters.

Parameters

X1	: Point to consider in the derivative computation.
X2	: Point to consider in the derivative computation.
ParamM	: Parameters of the warping function.
dwdp0	: Derivative matrix of the warping function according to the initial warping function parameters (p=0).
dW	: Resulting compositionnal derivative matrix.

Implements vpTemplateTrackerWarp.

Definition at line 116 of file vpTemplateTrackerWarpSRT.cpp.

References vpTemplateTrackerWarp::nbParam.

◆ getDistanceBetweenZoneAndWarpedZone()

double vpTemplateTrackerWarp::getDistanceBetweenZoneAndWarpedZone	(	const vpTemplateTrackerZone &	Z,
		const vpColVector &	p
	)

inherited

Compute the distance between a zone and its associated warped zone.

Parameters

Z	: Zone to consider.
p	: Parameters of the warping function.

Definition at line 73 of file vpTemplateTrackerWarp.cpp.

References vpTemplateTrackerTriangle::getCorner(), vpTemplateTrackerZone::getNbTriangle(), vpTemplateTrackerZone::getTriangle(), and vpTemplateTrackerWarp::warpX().

◆ getdW0()

void vpTemplateTrackerWarpSRT::getdW0	(	const int &	i,
		const int &	j,
		const double &	dy,
		const double &	dx,
		double *	dIdW
	)

virtual

Compute the derivative of the image with relation to the warping function parameters.

Parameters

i	: i coordinate (along the rows) of the point to consider in the image.
j	: j coordinate (along the columns) of the point to consider in the image.
dy	: Derivative on the y-axis (along the rows) of the point (i,j).
dx	: Derivative on the x-axis (along the columns) of the point (i,j).
dIdW	: Resulting derivative matrix (Image according to the warping function).

Implements vpTemplateTrackerWarp.

Definition at line 64 of file vpTemplateTrackerWarpSRT.cpp.

◆ getdWdp0()

void vpTemplateTrackerWarpSRT::getdWdp0	(	const int &	i,
		const int &	j,
		double *	dIdW
	)

virtual

Compute the derivative of the warping function according to the initial parameters.

Parameters

i	: i coordinate (along the rows) of the point to consider in the image.
j	: j coordinate (along the columns) of the point to consider in the image.
dIdW	: Resulting derivative matrix (Image according to the warping function).

Implements vpTemplateTrackerWarp.

Definition at line 74 of file vpTemplateTrackerWarpSRT.cpp.

◆ getNbParam()

unsigned int vpTemplateTrackerWarp::getNbParam ( ) const

inlineinherited

Get the number of parameters of the warping function.

Returns: Number of parameters.

Definition at line 141 of file vpTemplateTrackerWarp.h.

Referenced by vpTemplateTracker::computeOptimalBrentGain(), vpTemplateTrackerMIInverseCompositional::trackNoPyr(), and vpTemplateTracker::vpTemplateTracker().

◆ getParamInverse()

void vpTemplateTrackerWarpSRT::getParamInverse	(	const vpColVector &	ParamM,
		vpColVector &	ParamMinv
	)		const

virtual

Get the inverse of the warping function parameters.

Parameters

ParamM	: Parameters of the warping function.
ParamMinv	: Inverse parameters.

Implements vpTemplateTrackerWarp.

Definition at line 134 of file vpTemplateTrackerWarpSRT.cpp.

References vpMatrix::transpose().

◆ getParamPyramidDown()

void vpTemplateTrackerWarpSRT::getParamPyramidDown	(	const vpColVector &	p,
		vpColVector &	pdown
	)

virtual

Get the parameters of the warping function one level down.

Parameters

p	: Current parameters of the warping function.
pdown	: Resulting parameters on level down.

Implements vpTemplateTrackerWarp.

Definition at line 49 of file vpTemplateTrackerWarpSRT.cpp.

◆ getParamPyramidUp()

void vpTemplateTrackerWarpSRT::getParamPyramidUp	(	const vpColVector &	p,
		vpColVector &	pup
	)

virtual

Get the parameters of the warping function one level up.

Parameters

p	: Current parameters of the warping function.
pup	: Resulting parameters one level up.

Implements vpTemplateTrackerWarp.

Definition at line 56 of file vpTemplateTrackerWarpSRT.cpp.

◆ isESMcompatible()

bool vpTemplateTrackerWarpSRT::isESMcompatible ( ) const

inlinevirtual

Tells if the warping function is ESM compatible.

Returns: True if it is ESM compatible, False otherwise.

Implements vpTemplateTrackerWarp.

Definition at line 143 of file vpTemplateTrackerWarpSRT.h.

References vpTemplateTrackerWarp::pRondp(), vpTemplateTrackerWarp::warpX(), and vpTemplateTrackerWarp::warpXInv().

◆ pRondp()

void vpTemplateTrackerWarpSRT::pRondp	(	const vpColVector &	p1,
		const vpColVector &	p2,
		vpColVector &	pres
	)		const

virtual

Get the displacement resulting from the composition of two other displacements.

Parameters

p1	: First displacement.
p2	: Second displacement.
pres	: Displacement resulting from the composition of p1 and p2.

Implements vpTemplateTrackerWarp.

Definition at line 156 of file vpTemplateTrackerWarpSRT.cpp.

◆ setNbParam()

void vpTemplateTrackerWarp::setNbParam ( unsigned int nb )

inlineinherited

Set the number of parameters of the warping function.

Parameters

nb	: New number of parameters.

Definition at line 189 of file vpTemplateTrackerWarp.h.

References vpArray2D< Type >::resize().

◆ warp()

void vpTemplateTrackerWarp::warp	(	const double *	ut0,
		const double *	vt0,
		int	nb_pt,
		const vpColVector &	p,
		double *	u,
		double *	v
	)

inherited

Warp a list of points.

Parameters

ut0	: List of u coordinates of the points.
vt0	: List of v coordinates of the points.
nb_pt	: Number of points to consider.
p	: Parameters of the warp.
u	: Resulting u coordinates.
v	: resulting v coordinates.

Definition at line 95 of file vpTemplateTrackerWarp.cpp.

References vpMatrix::AtA(), vpMatrix::computeHLM(), vpTemplateTrackerWarp::dWarp(), vpMatrix::inverseByLU(), vpTemplateTrackerWarp::nbParam, vpMatrix::t(), and vpTemplateTrackerWarp::warpX().

Referenced by vpTemplateTrackerWarpHomographySL3::getParamPyramidDown(), and vpTemplateTrackerWarpHomographySL3::getParamPyramidUp().

◆ warpTriangle()

void vpTemplateTrackerWarp::warpTriangle	(	const vpTemplateTrackerTriangle &	in,
		const vpColVector &	p,
		vpTemplateTrackerTriangle &	out
	)

inherited

Warp a triangle and store the result in a new zone.

Parameters

in	: Triangle to warp.
p	: Parameters of the warping function. These parameters are estimated by the template tracker and returned using vpTemplateTracker::getp().
out	: Resulting triangle.

Definition at line 42 of file vpTemplateTrackerWarp.cpp.

References vpException::dimensionError, vpTemplateTrackerTriangle::getCorners(), vpTemplateTrackerTriangle::init(), vpArray2D< Type >::size(), vpCTRACE, and vpTemplateTrackerWarp::warpX().

Referenced by vpTemplateTrackerWarp::warpZone().

◆ warpX() [1/2]

void vpTemplateTrackerWarpSRT::warpX	(	const vpColVector &	vX,
		vpColVector &	vXres,
		const vpColVector &	ParamM
	)

virtual

Warp a point.

Parameters

vX	: Coordinates of the point to warp.
vXres	: Coordinates of the warped point.
ParamM	: Parameters of the warping function.

Implements vpTemplateTrackerWarp.

Definition at line 93 of file vpTemplateTrackerWarpSRT.cpp.

◆ warpX() [2/2]

void vpTemplateTrackerWarpSRT::warpX	(	const int &	i,
		const int &	j,
		double &	i2,
		double &	j2,
		const vpColVector &	ParamM
	)

virtual

Warp a point.

Parameters

i	: i coordinate (along the rows) of the point to warp.
j	: j coordinate (along the columns) of the point to warp.
i2	: i coordinate (along the rows) of the warped point.
j2	: j coordinate (along the columns) of the warped point.
ParamM	: Parameters of the warping function.

Implements vpTemplateTrackerWarp.

Definition at line 87 of file vpTemplateTrackerWarpSRT.cpp.

◆ warpXInv()

void vpTemplateTrackerWarpSRT::warpXInv	(	const vpColVector &	vX,
		vpColVector &	vXres,
		const vpColVector &	ParamM
	)

virtual

Inverse Warp a point.

Parameters

vX	: Coordinates of the point to warp.
vXres	: Coordinates of the warped point.
ParamM	: Parameters of the warping function.

Implements vpTemplateTrackerWarp.

Definition at line 127 of file vpTemplateTrackerWarpSRT.cpp.

◆ warpZone()

void vpTemplateTrackerWarp::warpZone	(	const vpTemplateTrackerZone &	in,
		const vpColVector &	p,
		vpTemplateTrackerZone &	out
	)

inherited

Warp a zone and store the result in a new zone.

Parameters

in	: Zone to warp.
p	: Parameters of the warping function. These parameters are estimated by the template tracker and returned using vpTemplateTracker::getp().
out	: Resulting zone.

Examples:: templateTracker.cpp.

Definition at line 62 of file vpTemplateTrackerWarp.cpp.

References vpTemplateTrackerZone::add(), vpTemplateTrackerZone::clear(), vpTemplateTrackerZone::getNbTriangle(), vpTemplateTrackerZone::getTriangle(), and vpTemplateTrackerWarp::warpTriangle().

Referenced by vpTemplateTracker::display().

Member Data Documentation

◆ denom

double vpTemplateTrackerWarp::denom

protectedinherited

Definition at line 61 of file vpTemplateTrackerWarp.h.

Referenced by vpTemplateTrackerWarpHomography::computeDenom(), vpTemplateTrackerWarpHomographySL3::computeDenom(), vpTemplateTrackerWarpHomography::dWarp(), vpTemplateTrackerWarpHomographySL3::dWarp(), vpTemplateTrackerWarpHomography::dWarpCompo(), vpTemplateTrackerWarpHomographySL3::dWarpCompo(), vpTemplateTrackerWarpHomography::warpX(), and vpTemplateTrackerWarpHomographySL3::warpX().

◆ dW

vpMatrix vpTemplateTrackerWarp::dW

protectedinherited

Definition at line 62 of file vpTemplateTrackerWarp.h.

Referenced by vpTemplateTrackerWarpAffine::vpTemplateTrackerWarpAffine(), vpTemplateTrackerWarpHomography::vpTemplateTrackerWarpHomography(), vpTemplateTrackerWarpRT::vpTemplateTrackerWarpRT(), vpTemplateTrackerWarpSRT(), and vpTemplateTrackerWarpTranslation::vpTemplateTrackerWarpTranslation().

◆ nbParam

unsigned int vpTemplateTrackerWarp::nbParam

protectedinherited

Definition at line 63 of file vpTemplateTrackerWarp.h.

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ vpTemplateTrackerWarpSRT()

Member Function Documentation

◆ dWarp()

◆ dWarpCompo()

◆ getDistanceBetweenZoneAndWarpedZone()

◆ getdW0()

◆ getdWdp0()

◆ getNbParam()

◆ getParamInverse()

◆ getParamPyramidDown()

◆ getParamPyramidUp()

◆ isESMcompatible()

◆ pRondp()

◆ setNbParam()

◆ warp()

◆ warpTriangle()

◆ warpX() [1/2]

◆ warpX() [2/2]

◆ warpXInv()

◆ warpZone()

Member Data Documentation

◆ denom

◆ dW

◆ nbParam