BitMorphology

MLModule

genre	Morphology
status	stable
authors	Horst Hahn, Sven Hansen, Wolf Spindler
package	MeVisLab/Standard
dll	MLKernel
definition	MLKernel.def
see also	SeparateBits, Convolution, ExtendedConvolution, Rank, KernelEditor, Morphology, LoG, StandardDeviation
keywords	dilation, erosion, opening, open, closing, close, minimum, maximum, enhance, kernel, input, filter, interval, sphere, spherical, structure, element, parallel, bone

Purpose

The module BitMorphology implements dilation and erosion filters that act separately on single bits.

With such operation, 8, 16, or 32 independent objects can be modified simultaneously based on a binary representation as stored in the respective data bit.

Note: These operations are not applicable to floating point data.

The influence of certain objects to 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 filters performing an erosion and then a dilation, respectively dilation and then a 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	KernelY: Integer
External Kernel: String	KernelZ: Integer
Fill Value: Double	Make kernel spherical: Bool
is: String	Num. Elements: Integer
KernelC: Integer	referenceExtentMode: Enum
KernelT: Integer	Use: Enum
KernelU: Integer	Use External Kernel: Bool
KernelX: Integer

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.

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.

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, deprecated name: useKernelInput

If checked, the optionally attached External Kernel is used.

is

name: kernelInfo, type: String, default: 9 elems, 3x3x1x1x1x1

Shows information about the used kernel.

Num. Elements

name: numKernelElements, type: Integer, default: 9

Shows the number of kernel elements.

Use

name: filterMode, type: Enum, default: BitDilation

Defines the used filter.

Values:

Title	Name	Description
Id	Id	The filtered area is just copied. Note that the border handling is still performed.
Bit Dilation	BitDilation	For all kernel elements a bit wise OR operation is performed on the corresponding image values. This is equivalent to a dilation on all bits separately from each other.
Bit Erosion	BitErosion	For all kernel elements a bit wise AND operation is performed on the corresponding image values. This is equivalent to an erosion on all bits separately from each other.

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