com.openinventor.imageviz.engines.geometryandmatching.registration

Class SoImagePreAlignmentTransform3d

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.engines.SoEngine

com.openinventor.imageviz.engines.SoImageVizEngine

com.openinventor.imageviz.engines.geometryandmatching.registration.SoImagePreAlignmentTransform3d

All Implemented Interfaces:

SafeDisposable

public class SoImagePreAlignmentTransform3d
extends SoImageVizEngine

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:

SoImageRegistrationTransform3d, SoRegistrationResult

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoImagePreAlignmentTransform3d.AlignmentModes This enum defines the different types of alignments.

Nested classes/interfaces inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

SoImageVizEngine.ComputeModes, SoImageVizEngine.EventArg, SoImageVizEngine.Neighborhood3ds

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFEnum<SoImagePreAlignmentTransform3d.AlignmentModes>	alignmentMode Select the type of alignment .
static int	CENTERS Deprecated. Use SoImagePreAlignmentTransform3d.AlignmentModes.CENTERS instead.
SoSFImageDataAdapter	inFixedImage The reference image.
SoSFImageDataAdapter	inMovingImage The model image.
SoImageVizEngineOutput<SoSFFieldContainer,SoRegistrationResult>	outTransform Output structure storing registration results.
static int	PRINCIPAL_AXIS Deprecated. Use SoImagePreAlignmentTransform3d.AlignmentModes.PRINCIPAL_AXIS instead.

Fields inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

CONNECTIVITY_18, CONNECTIVITY_26, CONNECTIVITY_6, MODE_2D, MODE_3D, MODE_AUTO, onBegin, onEnd, onProgress

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoImagePreAlignmentTransform3d() Constructor.

Method Summary

Modifier and Type	Method and Description
SbMatrix	getOutputTransformation() Returns the transform matrix that aligns the model image to the reference image.

Methods inherited from class com.openinventor.imageviz.engines.SoImageVizEngine

abortEvaluate, isEvaluating, startEvaluate, waitEvaluate

Methods inherited from class com.openinventor.inventor.engines.SoEngine

copy, getByName, getOutput, getOutputName

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable, touch

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CENTERS

@Deprecated
public static final int CENTERS

Deprecated. Use SoImagePreAlignmentTransform3d.AlignmentModes.CENTERS instead.

PRINCIPAL_AXIS

@Deprecated
public static final int PRINCIPAL_AXIS

Deprecated. Use SoImagePreAlignmentTransform3d.AlignmentModes.PRINCIPAL_AXIS instead.

inMovingImage

public final SoSFImageDataAdapter inMovingImage

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

inFixedImage

public final SoSFImageDataAdapter inFixedImage

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

alignmentMode

public final SoSFEnum<SoImagePreAlignmentTransform3d.AlignmentModes> alignmentMode

Select the type of alignment . Default is CENTERS

outTransform

public final SoImageVizEngineOutput<SoSFFieldContainer,SoRegistrationResult> outTransform

Output structure storing registration results.

Constructor Detail

SoImagePreAlignmentTransform3d

public SoImagePreAlignmentTransform3d()

Constructor.

Method Detail

getOutputTransformation

public SbMatrix getOutputTransformation()

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