SoImagePreAlignmentTransform3d Class Reference
[Registration]

SoImagePreAlignmentTransform3d image filter More...

#include <ImageViz/Engines/GeometryAndMatching/Registration/SoImagePreAlignmentTransform3d.h>

Inheritance diagram for SoImagePreAlignmentTransform3d:

List of all members.

Public Types
enum	AlignmentMode {   CENTERS = 0,   PRINCIPAL_AXIS = 1 }
Public Member Functions
	SoImagePreAlignmentTransform3d ()
SbMatrix	getOutputTransformation ()
Public Attributes
SoSFImageDataAdapter	inMovingImage
SoSFImageDataAdapter	inFixedImage
SoSFEnum	alignmentMode
SoImageVizEngineOutput < SoSFFieldContainer, SoRegistrationResult * >	outTransform

---

Detailed Description

SoImagePreAlignmentTransform3d image filter

SoImagePreAlignmentTransform3d estimates a transformation (translation and rotation) that aligns a moving image with a fixed image based on their intensity values. This transformation is particularly useful as an initial transformation value for the IntensityParametricRegistration engine.

SoImagePreAlignmentTransform3d first computes the centers of gravity and (optionally) the principal axes of both images (model and reference) using the image intensity values as a mass density. In the second step, the translation and the rotation that align the centers of gravity and the principal axes of both images are estimated. Note that if the computation of principal axes is omitted, only a translation is estimated.

FILE FORMAT/DEFAULT

ImagePreAlignmentTransform3d {

inMovingImage	NULL
inFixedImage	NULL
alignmentMode	CENTERS

}

Notice: This engine requires to preliminarily load the whole input data sets into memory to be computed. As a consequence, the maximum memory parameter must be either set to 0 or greater than the data set memory size: maxMemory parameter of the SbImageDataAdapterHelper::getAppropriateAdapter function maxMemory attribute of the SoFileDataAdapter class If this condition is not respected an exception will be raised when launching the execution of this engine: "engine cannot be computed because inputs are not in memory images." If the input data sets cannot fit in memory, this engine will fail during its computation.

SEE ALSO

SoImageRegistrationTransform, SoRegistrationResult

---

Member Enumeration Documentation

enum SoImagePreAlignmentTransform3d::AlignmentMode

This enum defines the different types of alignments.

Enumerator:

CENTERS	In this mode, the centers of gravity of the input images are aligned.
PRINCIPAL_AXIS	In this mode, the centers of gravity and the principal axes of the input images are aligned.

---

Constructor & Destructor Documentation

SoImagePreAlignmentTransform3d::SoImagePreAlignmentTransform3d

(

)

Constructor.

---

Member Function Documentation

SbMatrix SoImagePreAlignmentTransform3d::getOutputTransformation

(

)

[inline]

Returns the transform matrix that aligns the model image to the reference image.

---

Member Data Documentation

SoSFEnum SoImagePreAlignmentTransform3d::alignmentMode

Select the type of alignment Use enum AlignmentMode.

Default is CENTERS

SoSFImageDataAdapter SoImagePreAlignmentTransform3d::inFixedImage

The reference image.

Default value is NULL. Supported types include: grayscale, binary, label.

SoSFImageDataAdapter SoImagePreAlignmentTransform3d::inMovingImage

The model image.

Default value is NULL. Supported types include: grayscale, binary, label.

SoImageVizEngineOutput<SoSFFieldContainer, SoRegistrationResult*> SoImagePreAlignmentTransform3d::outTransform

Output structure storing registration results.

---

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

• ImageViz/Engines/GeometryAndMatching/Registration/SoImagePreAlignmentTransform3d.h