a nonlinear warp transformation More...

#include <vtkThinPlateSplineTransform.h>

Inheritance diagram for vtkThinPlateSplineTransform:

Collaboration diagram for vtkThinPlateSplineTransform:

Public Types
typedef vtkWarpTransform	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkThinPlateSplineTransform *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
unsigned long	GetMTime ()
vtkAbstractTransform *	MakeTransform ()

virtual double	GetSigma ()
virtual void	SetSigma (double)

void	SetBasis (int basis)
virtual int	GetBasis ()
void	SetBasisToR ()
void	SetBasisToR2LogR ()
const char *	GetBasisAsString ()

void	SetBasisFunction (double(*U)(double r))
void	SetBasisDerivative (double(*dUdr)(double r, double &dU))

void	SetSourceLandmarks (vtkPoints *source)
virtual vtkPoints *	GetSourceLandmarks ()

void	SetTargetLandmarks (vtkPoints *target)
virtual vtkPoints *	GetTargetLandmarks ()
Static Public Member Functions
static int	IsTypeOf (const char *type)
static vtkThinPlateSplineTransform *	SafeDownCast (vtkObjectBase *o)
static vtkThinPlateSplineTransform *	New ()
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
	vtkThinPlateSplineTransform ()
	~vtkThinPlateSplineTransform ()
void	InternalUpdate ()
void	InternalDeepCopy (vtkAbstractTransform *transform)
void	ForwardTransformPoint (const float in[3], float out[3])
void	ForwardTransformPoint (const double in[3], double out[3])
void	ForwardTransformDerivative (const float in[3], float out[3], float derivative[3][3])
void	ForwardTransformDerivative (const double in[3], double out[3], double derivative[3][3])
Protected Attributes
double	Sigma
vtkPoints *	SourceLandmarks
vtkPoints *	TargetLandmarks
double(*	BasisFunction )(double r)
double(*	BasisDerivative )(double r, double &dUdr)
int	Basis
int	NumberOfPoints
double **	MatrixW

Detailed Description

a nonlinear warp transformation

vtkThinPlateSplineTransform describes a nonlinear warp transform defined by a set of source and target landmarks. Any point on the mesh close to a source landmark will be moved to a place close to the corresponding target landmark. The points in between are interpolated smoothly using Bookstein's Thin Plate Spline algorithm.

To obtain a correct TPS warp, use the R2LogR kernel if your data is 2D, and the R kernel if your data is 3D. Or you can specify your own RBF. (Hence this class is more general than a pure TPS transform.)

Warning:: 1) The inverse transform is calculated using an iterative method, and is several times more expensive than the forward transform. 2) Whenever you add, subtract, or set points you must call Modified() on the vtkPoints object, or the transformation might not update. 3) Collinear point configurations (except those that lie in the XY plane) result in an unstable transformation.

See also:: vtkGridTransform vtkGeneralTransform

Tests:: vtkThinPlateSplineTransform (Tests)

Definition at line 51 of file vtkThinPlateSplineTransform.h.

Member Typedef Documentation

typedef vtkWarpTransform vtkThinPlateSplineTransform::Superclass

Reimplemented from vtkWarpTransform.

Definition at line 54 of file vtkThinPlateSplineTransform.h.

Constructor & Destructor Documentation

vtkThinPlateSplineTransform::vtkThinPlateSplineTransform ( ) [protected]

vtkThinPlateSplineTransform::~vtkThinPlateSplineTransform ( ) [protected]

Member Function Documentation

static int vtkThinPlateSplineTransform::IsTypeOf ( const char * name ) [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkWarpTransform.

virtual int vtkThinPlateSplineTransform::IsA ( const char * name ) [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkWarpTransform.

static vtkThinPlateSplineTransform* vtkThinPlateSplineTransform::SafeDownCast ( vtkObjectBase * o ) [static]

Reimplemented from vtkWarpTransform.

virtual vtkObjectBase* vtkThinPlateSplineTransform::NewInstanceInternal ( ) const [protected, virtual]

Reimplemented from vtkWarpTransform.

vtkThinPlateSplineTransform* vtkThinPlateSplineTransform::NewInstance ( ) const

Reimplemented from vtkWarpTransform.

void vtkThinPlateSplineTransform::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)		`[virtual]`

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkWarpTransform.

static vtkThinPlateSplineTransform* vtkThinPlateSplineTransform::New ( ) [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

virtual double vtkThinPlateSplineTransform::GetSigma ( ) [virtual]

Specify the 'stiffness' of the spline. The default is 1.0.

virtual void vtkThinPlateSplineTransform::SetSigma ( double ) [virtual]

Specify the 'stiffness' of the spline. The default is 1.0.

void vtkThinPlateSplineTransform::SetBasis ( int basis )