ConstrainedConnectionCost

MLModule
genre Morphology
author MeVis Medical Solutions AG
package MeVisLab/Standard
dll MLRate
definition MLRate.def
see also Morphology, BitMorphology, CloseGap
keywords morphology, distance, fill

Purpose

The module ConstrainedConnectionCost calculates 2D connection cost of image voxels with respect to a given set of reference voxels.

Depth-constraints of a marker image are taken into account. Connection cost are computed independent on each x-y slice of the input data.

Given the path cost as the maximal image value over all voxels belonging to a given path, the connection cost of two voxels is defined as the minimal path cost concerning all possible connections between the two voxels.

Hence the connection cost between two points x and y corresponds to the minimal barrier that must be crossed in order to pass from x to y.

Starting at the set of reference voxels the algorithm results in filling all the local valleys present in the image.

Usage

Computes image of min values (CCC values) that any path from the boundary needs to overcome to in order to reach a pixel in a slice. The result is displayed directly or used to show the difference of this value to the original or to mask out parts of the image.

Details

The reference set for the connection cost is given by all voxels v with input1(v) less input0(v). For the other voxels input1 gives a local upper constrain for the calculated connection cost.

If no reference image is used, connection costs are calculated in respect to the border of image input0 (i.e. for filling holes in binary masks).

the module works globally in the x-y plane, hence page extent is set appropriately.

Windows

Default Panel

../../../Modules/ML/MLRate/mhelp/Images/Screenshots/ConstrainedConnectionCost._default.png

Input Fields

input0

name: input0, type: Image

Primary input: image data. Common gray scale images or binary images are typical use cases

input1

name: input1, type: Image

Marker image for use with the use marker image option, an alternative to computing connection costs with respect to the image boundary.

Output Fields

output0

name: output0, type: Image

The resulting image

Parameter Fields

Visible Fields

Use marker (input1)

name: useMarker, type: Bool, default: FALSE, deprecated name: UseMarker

If checked, input1 is used for constraining the connection cost.

Otherwise connection costs are calculated respect to the border of image input0 (i.e. for filling gaps in binary masks).

Compute Diff Image

name: computeDiffImage, type: Bool, default: FALSE

If checked, the difference image is computed.

Compute Masked Image

name: computeMaskedImage, type: Bool, default: FALSE

Check this to mask the output such that only parts where the CCC exceeds Min CCCValue will be present in the output image.

Pixels with a CCC below Min CCCValue will get assigned the specified Fill Value, the rest of the output depends on further settings (i.e., one will get either the CCC values, the original values, or the difference between the CCC and original values).

Min CCCValue

name: minCCCValue, type: Double, default: 1

The threshold on CCC used in masking.

Fill Value

name: fillValue, type: Double, default: 0

Fill value for the background region in the masking mode.

Mask Orig Image

name: maskOrigImage, type: Bool, default: FALSE

Instead of CCC values show the masked original image in the output for pixels with a CCC above Min CCCValue.

Only used if Compute Masked Image is active.

Marker Status (input1)

name: markerStatus, type: String, persistent: no, deprecated name: MarkerStatus

Shows information about the marker input image.

Connection

name: connectionMode, type: Enum, default: ConnectXY, deprecated name: Connection

Defines the path along which the connection cost are evaluated.

For standard purposes, all paths in x-y-plane are feasible, however to use only paths parallel to the x or y-axis may be useful in special cases.

Values:

Title Name Deprecated Name Description
xy-plane-8nb ConnectXY xy-plane Connections over all 8 2D neighbor pixels are considered.
xy-plane-4nb ConnectXY4NB   Connections over only the closest 4 2D neighbor pixels are considered.
x-axis ConnectX x-axis Connections over only the 2 neighbor pixels in 1D rows are considered.
y-axis ConnectY y-axis Connections over only the 2 neighbor pixels in 1D columns are considered.