vtkThinPlateSplineTransform Class Reference

#include <vtkThinPlateSplineTransform.h>

Inheritance diagram for vtkThinPlateSplineTransform:

Inheritance graph
[legend]
Collaboration diagram for vtkThinPlateSplineTransform:

Collaboration graph
[legend]

List of all members.


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 50 of file vtkThinPlateSplineTransform.h.


Public Types

typedef vtkWarpTransform Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
unsigned long GetMTime ()
vtkAbstractTransformMakeTransform ()
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 vtkPointsGetSourceLandmarks ()
void SetTargetLandmarks (vtkPoints *target)
virtual vtkPointsGetTargetLandmarks ()

Static Public Member Functions

static int IsTypeOf (const char *type)
static
vtkThinPlateSplineTransform
SafeDownCast (vtkObject *o)
static
vtkThinPlateSplineTransform
New ()

Protected Member Functions

 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
vtkPointsSourceLandmarks
vtkPointsTargetLandmarks
double(* BasisFunction )(double r)
double(* BasisDerivative )(double r, double &dUdr)
int Basis
int NumberOfPoints
double ** MatrixW

Member Typedef Documentation

Reimplemented from vtkWarpTransform.

Definition at line 53 of file vtkThinPlateSplineTransform.h.


Constructor & Destructor Documentation

vtkThinPlateSplineTransform::vtkThinPlateSplineTransform (  )  [protected]

vtkThinPlateSplineTransform::~vtkThinPlateSplineTransform (  )  [protected]


Member Function Documentation

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

Reimplemented from vtkWarpTransform.

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 ( vtkObject o  )  [static]

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  ) 

Specify the radial basis function to use. The default is R2LogR which is appropriate for 2D. Use |R| (SetBasisToR) if your data is 3D. Alternatively specify your own basis function, however this will mean that the transform will no longer be a true thin-plate spline.

virtual int vtkThinPlateSplineTransform::GetBasis (  )  [virtual]

Specify the radial basis function to use. The default is R2LogR which is appropriate for 2D. Use |R| (SetBasisToR) if your data is 3D. Alternatively specify your own basis function, however this will mean that the transform will no longer be a true thin-plate spline.

void vtkThinPlateSplineTransform::SetBasisToR (  )  [inline]

Specify the radial basis function to use. The default is R2LogR which is appropriate for 2D. Use |R| (SetBasisToR) if your data is 3D. Alternatively specify your own basis function, however this will mean that the transform will no longer be a true thin-plate spline.

Definition at line 70 of file vtkThinPlateSplineTransform.h.

void vtkThinPlateSplineTransform::SetBasisToR2LogR (  )  [inline]

Specify the radial basis function to use. The default is R2LogR which is appropriate for 2D. Use |R| (SetBasisToR) if your data is 3D. Alternatively specify your own basis function, however this will mean that the transform will no longer be a true thin-plate spline.

Definition at line 71 of file vtkThinPlateSplineTransform.h.

const char* vtkThinPlateSplineTransform::GetBasisAsString (  ) 

Specify the radial basis function to use. The default is R2LogR which is appropriate for 2D. Use |R| (SetBasisToR) if your data is 3D. Alternatively specify your own basis function, however this will mean that the transform will no longer be a true thin-plate spline.

void vtkThinPlateSplineTransform::SetBasisFunction ( double(*)(double r)  U  )  [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 79 of file vtkThinPlateSplineTransform.h.

void vtkThinPlateSplineTransform::SetBasisDerivative ( double(*)(double r, double &dU)  dUdr  )  [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 84 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]

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.

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]

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.

unsigned long vtkThinPlateSplineTransform::GetMTime (  )  [virtual]

Get the MTime.

Reimplemented from vtkAbstractTransform.

vtkAbstractTransform* vtkThinPlateSplineTransform::MakeTransform (  )  [virtual]

Make another transform of the same type.

Implements vtkAbstractTransform.

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.

Implements vtkWarpTransform.

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

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

Implements 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.

Implements vtkWarpTransform.

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

Calculate the forward transform as well as the derivative.

Implements vtkWarpTransform.


Member Data Documentation

Definition at line 130 of file vtkThinPlateSplineTransform.h.

Definition at line 131 of file vtkThinPlateSplineTransform.h.

Definition at line 132 of file vtkThinPlateSplineTransform.h.

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

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

Definition at line 139 of file vtkThinPlateSplineTransform.h.

Definition at line 141 of file vtkThinPlateSplineTransform.h.

Definition at line 142 of file vtkThinPlateSplineTransform.h.


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

Generated on Wed Aug 24 12:13:16 2011 for VTK by  doxygen 1.5.6