ConstrainedConnectionCost

MLModule
genre Morphology
status stable
author Stephan Zidowitz
package MeVisLab/Standard
dll MLRate
definition MLRate.def
see also Morphology, BitMorphology, CloseGap
keywords connection, cost, 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.

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

input1

name: input1, type: Image

Output Fields

output0

name: output0, type: 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, deprecated name: computeDiffImage

If checked, the difference image is computed.

Marker Status (input1)

name: markerStatus, type: String, default: no marker image, 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 feasable, however to use only paths parallel to the x or y-axis may be useful in special cases.

Values:

Title Name
xy-plane-8nb ConnectXY
xy-plane-4nb ConnectXY4NB
x-axis ConnectX
y-axis ConnectY