---

vtkThinPlateSplineTransform Class Reference

a nonlinear warp transformation. More...

#include <vtkThinPlateSplineTransform.h>

Inheritance diagram for vtkThinPlateSplineTransform:

[legend]Collaboration diagram for vtkThinPlateSplineTransform:

[legend]List of all members.

Public Methods
virtual const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
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 ()
unsigned long	GetMTime ()
vtkAbstractTransform *	MakeTransform ()
Static Public Methods
int	IsTypeOf (const char *type)
vtkThinPlateSplineTransform *	SafeDownCast (vtkObject *o)
vtkThinPlateSplineTransform *	New ()
Protected Methods
	vtkThinPlateSplineTransform ()
	~vtkThinPlateSplineTransform ()
	vtkThinPlateSplineTransform (const vtkThinPlateSplineTransform &)
void	operator= (const 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.

Date:

2000/12/10 20:08:26

Revision:

1.17

Thanks:

Thanks to David G. Gobbi who developed this class based on code from vtkThinPlateSplineMeshWarp.cxx written by Tim Hutton.

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.

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

Examples:

vtkThinPlateSplineTransform (examples)

Definition at line 76 of file vtkThinPlateSplineTransform.h.

---

Constructor & Destructor Documentation

vtkThinPlateSplineTransform::vtkThinPlateSplineTransform (    )  [protected]

vtkThinPlateSplineTransform::~vtkThinPlateSplineTransform (    )  [protected]

vtkThinPlateSplineTransform::vtkThinPlateSplineTransform (  const vtkThinPlateSplineTransform &    )  [inline, protected]

Definition at line 129 of file vtkThinPlateSplineTransform.h.

---

Member Function Documentation

virtual const char* vtkThinPlateSplineTransform::GetClassName (    )  [virtual]

Return the class name as a string. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h. Reimplemented from vtkWarpTransform.

int vtkThinPlateSplineTransform::IsTypeOf (  const char *    type )  [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 *    type )  [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.

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

Will cast the supplied object to vtkObject* is this is a safe operation (i.e., a safe downcast); otherwise NULL is returned. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h. 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.

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]

void vtkThinPlateSplineTransform::SetBasis (  int    basis )

Specify the radial basis function to use. The default is R2LogR which is what most people use as the thin plate spline.

virtual int vtkThinPlateSplineTransform::GetBasis (    )  [virtual]

void vtkThinPlateSplineTransform::SetBasisToR (    )  [inline]

Definition at line 91 of file vtkThinPlateSplineTransform.h.

void vtkThinPlateSplineTransform::SetBasisToR2LogR (    )  [inline]

Definition at line 92 of file vtkThinPlateSplineTransform.h.

const char* vtkThinPlateSplineTransform::GetBasisAsString (    )

void vtkThinPlateSplineTransform::SetBasisFunction (  double(*    U)(double r) )  [inline]

Set the radial basis function to a custom function. You must supply both the function and its derivative with respect to r. Definition at line 98 of file vtkThinPlateSplineTransform.h.

void vtkThinPlateSplineTransform::SetBasisDerivative (  double(*    dUdr)(double r, double &dU) )  [inline]

Definition at line 103 of file vtkThinPlateSplineTransform.h.

void vtkThinPlateSplineTransform::SetSourceLandmarks (  vtkPoints *    source )

Set the source landmarks for the warp. If you add or change the vtkPoints object, you must call Modified() on it or the transformation might not update.

virtual vtkPoints* vtkThinPlateSplineTransform::GetSourceLandmarks (    )  [virtual]

void vtkThinPlateSplineTransform::SetTargetLandmarks (  vtkPoints *    target )

Set the target landmarks for the warp. If you add or change the vtkPoints object, you must call Modified() on it or the transformation might not update.

virtual vtkPoints* vtkThinPlateSplineTransform::GetTargetLandmarks (    )  [virtual]

unsigned long vtkThinPlateSplineTransform::GetMTime (    )  [virtual]

Get the MTime. Reimplemented from vtkAbstractTransform.

vtkAbstractTransform* vtkThinPlateSplineTransform::MakeTransform (    )  [virtual]

Make another transform of the same type. Reimplemented from vtkAbstractTransform.

void vtkThinPlateSplineTransform::operator= (  const vtkThinPlateSplineTransform &    )  [inline, protected]

Definition at line 130 of file vtkThinPlateSplineTransform.h.

void vtkThinPlateSplineTransform::InternalUpdate (    )  [protected, virtual]

Prepare the transformation for application. Reimplemented from vtkAbstractTransform.

void vtkThinPlateSplineTransform::InternalDeepCopy (  vtkAbstractTransform *    transform )  [protected, virtual]

This method does no type checking, use DeepCopy instead. Reimplemented from vtkAbstractTransform.

void vtkThinPlateSplineTransform::ForwardTransformPoint (  const float    in[3], float    out[3] )  [protected, virtual]

If the InverseFlag is set to 0, then a call to InternalTransformPoint results in a call to ForwardTransformPoint. Reimplemented from vtkWarpTransform.

void vtkThinPlateSplineTransform::ForwardTransformPoint (  const double    in[3], double    out[3] )  [protected, virtual]

Reimplemented from vtkWarpTransform.

void vtkThinPlateSplineTransform::ForwardTransformDerivative (  const float    in[3], float    out[3], float    derivative[3][3] )  [protected, virtual]

Calculate the forward transform as well as the derivative. Reimplemented from vtkWarpTransform.

void vtkThinPlateSplineTransform::ForwardTransformDerivative (  const double    in[3], double    out[3], double    derivative[3][3] )  [protected, virtual]

Reimplemented from vtkWarpTransform.

---

Member Data Documentation

double vtkThinPlateSplineTransform::Sigma [protected]

Definition at line 146 of file vtkThinPlateSplineTransform.h.

vtkPoints* vtkThinPlateSplineTransform::SourceLandmarks [protected]

Definition at line 147 of file vtkThinPlateSplineTransform.h.

vtkPoints* vtkThinPlateSplineTransform::TargetLandmarks [protected]

Definition at line 148 of file vtkThinPlateSplineTransform.h.

double(* vtkThinPlateSplineTransform::BasisFunction)(double r) [protected]

double(* vtkThinPlateSplineTransform::BasisDerivative)(double r, double& dUdr) [protected]

int vtkThinPlateSplineTransform::Basis [protected]

Definition at line 155 of file vtkThinPlateSplineTransform.h.

int vtkThinPlateSplineTransform::NumberOfPoints [protected]

Definition at line 157 of file vtkThinPlateSplineTransform.h.

double** vtkThinPlateSplineTransform::MatrixW [protected]

Definition at line 158 of file vtkThinPlateSplineTransform.h.

---

The documentation for this class was generated from the following file:

• contrib/vtkThinPlateSplineTransform.h

---