SeparableKernelExample

MLModule

genre

Kernel

author

MeVis Medical Solutions AG

package

MeVisLab/Examples

dll

MLKernelExamples

definition

MLKernelExamples.def

see also

Convolution, ExtendedConvolution, Rank, Sigma, BitMorphology, Morphology, LoG, KernelEditor, StandardDeviation

keywords

enhance, kernel, filter

Purpose

This module is an example module to show how to implement a separable convolution filter.

It contains some options and parameters which are available from the KernelBaseOp and KernelOp classes.

Windows

Default Panel

../../../Modules/ML/MLKernelExamples/mhelp/Images/Screenshots/SeparableKernelExample._default.png

Input Fields

input0

name: input0, type: Image

Output Fields

output0

name: output0, type: Image

Parameter Fields

Field Index

Border Handling: Enum

X: Integer

C: Integer

Y: Integer

Fill Value: Double

Z: Integer

Info: String

Kernel Output: String

referenceExtentMode: Enum

T: Integer

U: Integer

Visible Fields

Border Handling

name: borderHandling, type: Enum, default: PadSrcClamp

Defines the border handling of the kernel operation.

Values:

Title

Name

Description

​No Pad

​NoPad

​Only those voxels are passed to the output which can be filtered correctly by the entire kernel. So the output image usually shrinks by the extents of the kernel - 1.

​Pad Src Fill

​PadSrcFill

​The input image is virtually expanded by so many voxels that all input image voxels can be filtered correctly with the kernel.

The area added around the input image is filled with the value specified in the Fill Value field.

​Pad Dst Fill

​PadDstFill

​All pixels of the output image which can be filtered correctly with the kernel without accessing voxels outside the output image are filtered with the kernel.

All other voxels in the image are filled with the value specified in the Fill Value field.

​Pad Dst Fill With Orig

​PadDstFillWithOrig

​All pixels of the output image which can be filtered correctly with the kernel without accessing voxels outside the output image are filtered with the kernel.

All other voxels in the image are filled with their corresponding values from the input image.

​Pad Src Undefined

​PadSrcUndefined

​The input image is virtually expanded by so many voxels that all input image voxels can be filtered correctly with the kernel. The area added around the input image is not filled with a certain value and remains undefined.

Note that this mode saves time for border filling but causes unpredictable values in the border regions of the output image.

​Pad Dst Undefined

​PadDstUndefined

​All pixels of the output image which can be filtered correctly with the kernel without accessing voxels outside the output image are filtered with the kernel. All other voxels in the image are left undefined.

Note that this mode saves time for border filling but causes unpredictable values in the border regions of the output image.

​Pad Src Clamp

​PadSrcClamp

​The input image is virtually expanded by so many voxels that all input image voxels can be filtered correctly with the kernel.

The contents of the area added around the input image is filled with those voxels of the input image which are nearest to the filled ones.

Fill Value

name: fillValue, type: Double, default: 0

Sets a fill value that is used for filling the border in certain modes of Border Handling.

Info

name: kernelInfo, type: String, persistent: no

Shows information about the module.

Kernel Output

name: kernelOutput, type: String, persistent: no

Shows the used kernel as a string.

X

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

Sets the size of the kernel in x-direction.

Y

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

Sets the size of the kernel in y-direction.

Z

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

Sets the size of the kernel in z-direction.

C

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

Sets the size of the kernel in c-direction.

T

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

Sets the size of the kernel in t-direction.

U

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

Sets the size of the kernel in u-direction.

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