Morphology

MLModule

genre	Morphology
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	MLKernel
definition	MLKernel.def
see also	SeparateBits, Convolution, ExtendedConvolution, KernelExample, Rank, KernelEditor, Morphology
keywords	dilation, erosion, opening, open, closing, close, minimum, maximum, enhance, kernel, input, filter, interval, sphere, spherical, structure, element, parallel, bone

Purpose

The module Morphology implements the dilation and erosion filters.

Optionally, a threshold interval can be used to select a subset of voxels from the input image to which the filtering is applied. Another threshold interval can be used to limit the set of voxels under a kernel used to produce a filtered voxel. By using these intervals, filtering can be applied selectively to regions in the image. Additionally, the influence of certain objects on the filtering itself can be avoided by excluding the corresponding voxels from the kernel.

An implementation of the operations opening and closing can be achieved by using two Morphology modules performing an erosion and dilation, respectively dilation and erosion.

Windows

Default Panel

Input Fields

input0

name: input0, type: Image

Output Fields

output0

name: output0, type: Image

Parameter Fields

Field Index

Border Handling: Enum	KernelX: Integer	numKernelElements: Integer
External Kernel: String	KernelY: Integer	referenceExtentMode: Enum
Fill Value: Double	KernelZ: Integer	Use (filterMode): Enum
is: String	Make kernel spherical: Bool	Use (useIntervalOfFilteredVoxels): Bool
KernelC: Integer	Max (intervalMaxOfFilteredVoxels): Double	Use (useIntervalOfVoxelsForFiltering): Bool
kernelElementsSum: Double	Max (intervalMaxOfVoxelsForFiltering): Double	Use External Kernel: Bool
KernelT: Integer	Min (intervalMinOfFilteredVoxels): Double
KernelU: Integer	Min (intervalMinOfVoxelsForFiltering): Double

Visible Fields

Border Handling

name: borderHandling, type: Enum, default: PadSrcClamp, deprecated name: edgeMode

Defines the border handling mode.

See Border Handling in Kernel Operations for details.

Values:

Title	Name
​No Pad	​NoPad
​Pad Src Fill	​PadSrcFill
​Pad Dst Fill	​PadDstFill
​Pad Dst Fill With Orig	​PadDstFillWithOrig
​Pad Src Undefined	​PadSrcUndefined
​Pad Dst Undefined	​PadDstUndefined
​Pad Src Clamp	​PadSrcClamp

Fill Value

name: fillValue, type: Double, default: 0

Sets the fill value for certain Border Handling modes.

Use (filterMode)

name: filterMode, type: Enum, default: Dilation

Defines the filter mode of this module.

Values:

Title	Name	Description
​Id	​Id	​Copies the input image.
​Dilation	​Dilation	​The kernel element values are added to their corresponding image values. The maximum of these values is written to the output image.
​Erosion	​Erosion	​The kernel element values are subtracted from the corresponding image values. The minimum of these values is written to the output image.

KernelX

name: kernelX, type: Integer, default: 3, minimum: 1, maximum: 999

Sets the x-extent of the kernel.

KernelY

name: kernelY, type: Integer, default: 3, minimum: 1, maximum: 999

Sets the y-extent of the kernel.

KernelZ

name: kernelZ, type: Integer, default: 1, minimum: 1, maximum: 999

Sets the z-extent of the kernel.

KernelC

name: kernelC, type: Integer, default: 1, minimum: 1, maximum: 999

Sets the c-extent of the kernel.

KernelT

name: kernelT, type: Integer, default: 1, minimum: 1, maximum: 999

Sets the t-extent of the kernel.

KernelU

name: kernelU, type: Integer, default: 1, minimum: 1, maximum: 999

Sets the u-extent of the kernel.

Make kernel spherical

name: makeSpherical, type: Bool, default: FALSE

If checked, the used kernel is a spherical kernel, not a rectangular one.

Min (intervalMinOfFilteredVoxels)

name: intervalMinOfFilteredVoxels, type: Double, default: 0, deprecated name: imageIntervalMin

Sets the minimum value threshold for outputting a subset of voxels.

Max (intervalMaxOfFilteredVoxels)

name: intervalMaxOfFilteredVoxels, type: Double, default: 1024, deprecated name: imageIntervalMax

Sets the maximum value threshold for outputting a subset of voxels.

Use (useIntervalOfFilteredVoxels)

name: useIntervalOfFilteredVoxels, type: Bool, default: FALSE

If checked, the module outputs only on a subset of voxels defined by a value range.

Min (intervalMinOfVoxelsForFiltering)

name: intervalMinOfVoxelsForFiltering, type: Double, default: 0, deprecated name: kernelIntervalMin

Sets the minimum value threshold for operating on a subset of voxels.

Max (intervalMaxOfVoxelsForFiltering)

name: intervalMaxOfVoxelsForFiltering, type: Double, default: 1024, deprecated name: kernelIntervalMax

Sets the maximum value threshold for operating on a subset of voxels.

Use (useIntervalOfVoxelsForFiltering)

name: useIntervalOfVoxelsForFiltering, type: Bool, default: FALSE

If checked, the module operates only on a subset of voxels defined by a value range.

External Kernel

name: externalKernel, type: String, deprecated name: kernelInput

Sets an external kernel as a string.

Use the module KernelEditor for editing the kernel or set the kernel by scripting.

Use External Kernel

name: useExternalKernel, type: Bool, default: FALSE

If checked, the optionally attached External Kernel is used.

is

name: kernelInfo, type: String, persistent: no

Shows information about the used kernel.

numKernelElements

name: numKernelElements, type: Integer, persistent: no

Shows the number of used kernel elements.

Hidden Fields

referenceExtentMode

name: referenceExtentMode, type: Enum, default: Overlap

Values:

Title	Name
​Overlap	​Overlap
​Input0 Ext Without Fill	​Input0_ExtWithoutFill
​Input0 Ext With Fill	​Input0_ExtWithFill
​Max Extents Without Fill	​MaxExtentsWithoutFill
​Max Extents With Fill	​MaxExtentsWithFill

kernelElementsSum

name: kernelElementsSum, type: Double, persistent: no