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 - maxMemory parameter of the
SbImageDataAdapterHelper.getAppropriateAdapter
function - maxMemory attribute of the
SoFileDataAdapter
class
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: 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
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 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 Description SoSFEnum<SoImagePreAlignmentTransform3d.AlignmentModes>
alignmentMode
Select the type of alignment .SoSFImageDataAdapter
inFixedImage
The reference image.SoSFImageDataAdapter
inMovingImage
The model image.SoImageVizEngineOutput<SoSFFieldContainer,SoRegistrationResult>
outTransform
Output structure storing registration results.-
Fields inherited from class com.openinventor.imageviz.engines.SoImageVizEngine
onBegin, onEnd, onProgress
-
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
-
Constructor Summary
Constructors Constructor Description SoImagePreAlignmentTransform3d()
Constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method 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, getName, isDisposable, isSynchronizable, setName, setSynchronizable, touch
-
Methods inherited from class com.openinventor.inventor.Inventor
getNativeResourceHandle
-
-
-
-
Field Detail
-
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.
-
-
Method Detail
-
getOutputTransformation
public SbMatrix getOutputTransformation()
Returns the transform matrix that aligns the model image to the reference image.
-
-