Main Page | Directories | Class Hierarchy | Alphabetical List | Class List | File List | Class Members | File Members | Related Pages

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
Created by:
  • Gobbi, David
CVS contributions (if > 5%):
  • Gobbi, David (93%)
CVS logs (CVSweb):
  • .cxx (/Hybrid/vtkThinPlateSplineTransform.cxx)
  • .h (/Hybrid/vtkThinPlateSplineTransform.h)
Tests:
vtkThinPlateSplineTransform (Tests)

Definition at line 60 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

int IsTypeOf (const char *type)
vtkThinPlateSplineTransformSafeDownCast (vtkObject *o)
vtkThinPlateSplineTransformNew ()

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

typedef vtkWarpTransform vtkThinPlateSplineTransform::Superclass
 

Reimplemented from vtkWarpTransform.

Definition at line 63 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.

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 vtkTypeRevisionMacro 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 vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkWarpTransform.

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.

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

References VTK_RBF_R.

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

References VTK_RBF_R2LOGR.

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(*  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 89 of file vtkThinPlateSplineTransform.h.

References vtkObject::Modified(), and VTK_RBF_CUSTOM.

void vtkThinPlateSplineTransform::SetBasisDerivative double(*  dUdr)(double r, double &dU)  )  [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 94 of file vtkThinPlateSplineTransform.h.

References vtkObject::Modified().

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

double vtkThinPlateSplineTransform::Sigma [protected]
 

Definition at line 140 of file vtkThinPlateSplineTransform.h.

vtkPoints* vtkThinPlateSplineTransform::SourceLandmarks [protected]
 

Definition at line 141 of file vtkThinPlateSplineTransform.h.

vtkPoints* vtkThinPlateSplineTransform::TargetLandmarks [protected]
 

Definition at line 142 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 149 of file vtkThinPlateSplineTransform.h.

int vtkThinPlateSplineTransform::NumberOfPoints [protected]
 

Definition at line 151 of file vtkThinPlateSplineTransform.h.

double** vtkThinPlateSplineTransform::MatrixW [protected]
 

Definition at line 152 of file vtkThinPlateSplineTransform.h.


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