OrthoMPR

MLModule
genre Resample
status stable
author Florian Link
package MeVisLab/Standard
dll MLResample1
definition MLResample1.def
see also MPR, MPRPath, Reformat, OrthoReformat3

Purpose

The module OrthoMPR computes an MPR out of an input image and the two orthogonal slices to the MPR.

Usage

Have a look at the module MPR for further information.

Windows

Default Panel

../../../Modules/ML/MLResample1/mhelp/Images/Screenshots/OrthoMPR._default.png

Input Fields

input0

name: input0, type: Image

Input image from which an MPR is computed.

Output Fields

output0

name: output0, type: Image

Provides the MPR image slice (or slice stack if Output Depth > 1) for the given plane.

output1

name: output1, type: Image

Provides an orthogonal slice to output0.

output2

name: output2, type: Image

Provides and orthogonal slice to output0 and output1.

Parameter Fields

Field Index

aspectRatio: Float Interpolation: Enum Translation: Vector3
Axial: Trigger Memory Access: Enum  
Coronal: Trigger Output Depth: Integer  
enablePlaneEdit: Bool Output Size: Integer  
Field Of View: Float Plane: Plane  
Fill Value: Double representInputSlice: Trigger  
Force Upright: Bool Rotation: Rotation  
inputSliceNo: Integer Sagittal: Trigger  

Visible Fields

Rotation

name: rotation, type: Rotation, default: 0 0 1 0

Sets the rotation of the MPR slice, mapping the world X-, Y-, and Z-axes to the MPR image's X-, negative Z-, and Y-axes, respectively.

Translation

name: translation, type: Vector3, default: 0 0 0

Sets the translation vector to the center of the (first) MPR slice (in world coordinates).

Plane

name: plane, type: Plane, default: 0 0 1 0

Sets the plane containing the first slice of the MPR first output image.

Fill Value

name: fillValue, type: Double, default: 0, deprecated name: fillvalue

Sets the value used for regions outside of the input image.

Field Of View

name: fieldOfView, type: Float, default: 100

Sets the extent of the MPR slice in the world coordinate system (in mm).

Output Size

name: outputSize, type: Integer, default: 256

Sets the resolution of the output slice (X,Y) in pixels.

Output Depth

name: outputDepth, type: Integer, default: 1

Sets the depth (Z size) of the output image.

If set to 1, a single slice is generated. If set to a value > 1, the output image is a stack of MPR's, where the translation defines the center of the first slice.

Force Upright

name: forceUpright, type: Bool, default: FALSE, deprecated name: useUpVector

If checked, the MPR slice's Y-axis is forced to be close to the world Y-axis (or Z-axis if the MPR slice normal is parallel to the Y-axis).

Axial

name: axial, type: Trigger

If pressed, the MPR is set to the first output image to axial (transversal) orientation.

Sagittal

name: sagittal, type: Trigger

If pressed, the MPR is set to the first output image to sagittal orientation.

Coronal

name: coronal, type: Trigger

If pressed, the MPR is set to the first output image to coronal orientation.

Interpolation

name: interpolation, type: Enum, default: Trilinear, deprecated name: Mode

Defines the interpolation used for resampling.

Values:

Title Name Description
Nearest Neighbor NearestNeighbor

No interpolation, picks the nearest input image voxel.

Fastest mode.

Trilinear Trilinear

Trilinear filtering. The 8-voxel-neighborhood is used for linear interpolation.

Slowest mode.

Trilinear Skip Border TrilinearSkipBorder

Same as Trilinear, but all output voxels that depend on a voxel outside of the input image are filled with Fill Value.

Faster than Trilinear.

Memory Access

name: memoryAccess, type: Enum, default: Global, deprecated name: pagedInputImage

Defines how the module accesses the input image.

Values:

Title Name Deprecated Name Description
Paged Paged TRUE

Slower than global, except for small MPR's in large input images. The output MPR is split into tiles that are processed individually. For each tile, the module requests the corresponding 3D region of the input image.

If not enough memory is available, the module falls back to Virtual Volume access.

Global Global FALSE

Fastest, but highest memory cosumption and initialization time. The input image is accessed as a global image (via the ML memory image). This consumes a lot of memory for large datasets.

If not enough memory is available, the module falls back to the Virtual Volume memory access.

Virtual Volume VirtualVolume   Slowest, but works on huge datasets. All pages of the input image are requested via the virtual volume mechanism, thus only small portions of the input image are needed at the same time.

Hidden Fields

enablePlaneEdit

name: enablePlaneEdit, type: Bool, default: FALSE

If this is enabled, the Plane field can be used as an input field.

Incremental modifications of the Plane field are transformed to modifications of the Rotation and Translation parameters.

aspectRatio

name: aspectRatio, type: Float, default: 1

Values larger than 1.0 produce portrait, smaller than 1.0 landscape output.

inputSliceNo

name: inputSliceNo, type: Integer, default: 0

Slice number to be reproduced by the representInputSlice trigger.

representInputSlice

name: representInputSlice, type: Trigger

Adjusts Field Of View, Output Size, aspectRatio, Translation, and Rotation such that the output exactly matches the input slice number inputSliceNo.