TextureFilter

MLModule

genre	Filters
status	stable
author	Regina Ochotzki
package	MeVisLab/Standard
dll	MLFilter2
definition	mlFilter2.def
see also	ExtendedConvolution, Compass, Convolution, LoG, Roberts
keywords	TextureFilterOp, Convolution, Average, variance, correlation `, :keyword:`inverse, difference, moment, sum, entropie, contrast, homogeneity, occurrence, matrix, run, length `, :keyword:`percentage, short, long, emphasis, skewness, kurtosis, grey, level, non-uniformity

Purpose

The module TextureFilter offers a variety of texture filters.

For the most filters, only the kernel extent is used but not the actual kernel values.

Windows

Default Panel

Input Fields

input0

name: input0, type: Image

Original scalar input image.

Output Fields

output0

name: output0, type: Image

Filtered output image.

Parameter Fields

Field Index

Adjust min and max Values: Bool	Edge Mode: Enum	neighbourSelectOn: Bool
Adjust Values: Trigger	extentInput: Bool	noFilter: Bool
Apply: Trigger	Fill Value: Double	referenceExtentMode: Enum
Auto Apply: Bool	Filter Select: Enum	Scale Select: Enum
borderHandling: Enum	Get Current Values: Trigger	scaleSelectOn: Bool
c Coordinate: Integer	Input Select: Enum	t Coordinate: Integer
Current Selected Filter: String	Kernel Info: String	u Coordinate: Integer
Deviance: Double	Kernel Input: String	x Coordinate: Integer
devianceOn: Bool	maxValue: Double	y Coordinate: Integer
Distance: Integer	minValue: Double	z Coordinate: Integer
distanceOn: Bool	Neighbour Select: Enum

Visible Fields

Fill Value

name: fillValue, type: Double, default: 0

Sets a fill value for undefined kernel values.

Edge Mode

name: edgeMode, type: Enum, default: PadSrcClamp

Defines the edge mode for kernel operations.

See Kernel for more 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

Kernel Input

name: kernelInput, type: String

Sets an external kernel as a string.

Kernel Info

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

Shows information about the current kernel.

Input Select

name: inputSelect, type: Enum, default: use Extent Input

Defines from where the kernel input is set.

Values:

Title	Name	Description
Kernel Input	use Kernel Input	The kernel extent is set by the kernel string in Kernel Input.
Extent Input	use Extent Input	The kernel extent is set explictly with x Coordinate to u Coordinate.

Filter Select

name: filterSelect, type: Enum, default: No Filter

Defines which filter the module should use.

Values:

Title	Name	Description
No Filter	No Filter	The output image is an indentical copy of the input image.
Average (simple)	Average (simple)
Contrast (simple)	Contrast (simple)
Deviation (simple)	Deviation (simple)
Skewness (simple)	Skewness (simple)
Kurtosis (simple)	Kurtosis (simple)
Homogeneity(asm) (Co-ocurrence Matrix)	Homogeneity(asm) (Co-ocurrence Matrix)
Contrast (Co-ocurrence Matrix)	Contrast (Co-ocurrence Matrix)
Correlation (Co-ocurrence Matrix)	Correlation (Co-ocurrence Matrix)
Variance (Co-ocurrence Matrix)	Variance (Co-ocurrence Matrix)
Inverse Difference Moment (Co-ocurrence Matrix)	Inverse Difference Moment (Co-ocurrence Matrix)
Sum Average (Co-ocurrence Matrix)	Sum Average (Co-ocurrence Matrix)
Sum Entropie (Co-ocurrence Matrix)	Sum Entropie (Co-ocurrence Matrix)
Sum Variance (Co-ocurrence Matrix)	Sum Variance (Co-ocurrence Matrix)
Entropie (Co-ocurrence Matrix)	Entropie (Co-ocurrence Matrix)
Difference Variance (Co-ocurrence Matrix)	Difference Variance (Co-ocurrence Matrix)
Difference Entropie (Co-ocurrence Matrix)	Difference Entropie (Co-ocurrence Matrix)
Measures of Correlation1 (Co-ocurrence Matrix)	Measures of Correlation1 (Co-ocurrence Matrix)
Measures of Correlation2 (Co-ocurrence Matrix)	Measures of Correlation2 (Co-ocurrence Matrix)
Short Runs Emphasis (Run Length Matrix)	Short Runs Emphasis (Run Length Matrix)
Long Runs Emphasis (Run Length Matrix)	Long Runs Emphasis (Run Length Matrix)
Grey Level Nonuniformity (Run Length Matrix)	Grey Level Nonuniformity (Run Length Matrix)
Run Length Nonuniformity (Run Length Matrix)	Run Length Nonuniformity (Run Length Matrix)
Run Percentage (Run Length Matrix)	Run Percentage (Run Length Matrix)
Small Number Emphasis (NGLDM)	Small Number Emphasis (NGLDM)
Large Number Emphasis (NGLDM)	Large Number Emphasis (NGLDM)
Number Nonuniformity (NGLDM)	Number Nonuniformity (NGLDM)
Second Moment (NGLDM)	Second Moment (NGLDM)
Entropie (NGLDM)	Entropie (NGLDM)
Coarseness (NGTDM)	Coarseness (NGTDM)
Contrast (NGTDM)	Contrast (NGTDM)
Busyness (NGTDM)	Busyness (NGTDM)
Complexity (NGTDM)	Complexity (NGTDM)
Texture Strength (NGTDM)	Texture Strength (NGTDM)

Scale Select

name: scaleSelect, type: Enum, default: factor 16

Defines the number of bins for internal computation. Only available for non-simple filters.

All gray values of the input images are sorted to the number of bins defined here.

The more bins, the longer the computation takes, but the better the result will be.

Values:

Title	Name
8	factor 8
16	factor 16
32	factor 32
64	factor 64
128	factor 128
256	factor 256
512	factor 512
1024	factor 1024
2048	factor 2048
4096	factor 4096

Neighbour Select

name: neighbourSelect, type: Enum, default: 0 Degree (x+,y)

Defines which neighboring voxels of the current voxel are taken into account.

Only available for non-simple filters.

Values:

Title	Name
0 Degree (x+,y)	0 Degree (x+,y)
45 Degree (x+,y+)	45 Degree (x+,y+)
90 Degree (x,y+)	90 Degree (x,y+)
135 Degree (x-,y-)	135 Degree (x-,y-)
use Average of All 2D	use Average of All 2D
Upper (x,y,z+)	Upper (x,y,z+)
Upper Right (x+,y,z+)	Upper Right (x+,y,z+)
Upper Head (x,y+,z+)	Upper Head (x,y+,z+)
use Average of All 3D	use Average of All 3D
use Average of All	use Average of All

Distance

name: distance, type: Integer, default: 1, minimum: 1, maximum: 50

Sets the radius around a current voxel in which values are considered for the computation.

Only available for NGLDM and NGTDM based algorithms.

Deviance

name: deviance, type: Double, default: 0, minimum: 0, maximum: 50

Sets the difference value of a neighboring voxel to the current voxel value to be considered in a compuation.

Only available in NGLDM based algorithms.

x Coordinate

name: xCoordExt, type: Integer, default: 3, minimum: 1, maximum: 100

Sets the extent of the kernel in x-direction.

y Coordinate

name: yCoordExt, type: Integer, default: 3, minimum: 1, maximum: 100

Sets the extent of the kernel in y-direction.

z Coordinate

name: zCoordExt, type: Integer, default: 1, minimum: 1, maximum: 100

Sets the extent of the kernel in z-direction.

c Coordinate

name: cCoordExt, type: Integer, default: 1, minimum: 1, maximum: 100

Sets the extent of the kernel in c-direction.

t Coordinate

name: tCoordExt, type: Integer, default: 1, minimum: 1, maximum: 100

Sets the extent of the kernel in t-direction.

u Coordinate

name: uCoordExt, type: Integer, default: 1, minimum: 1, maximum: 100

Sets the extent of the kernel in u-direction.

Apply

name: apply, type: Trigger

If pressed, the module computes the output image anew.

Auto Apply

name: autoApply, type: Bool, default: TRUE

If checked, all changes to any field cause the module to compute anew.

Adjust min and max Values

name: minMaxAdjust, type: Bool, default: FALSE

If checked, the minValue and maxValue can manually be set.

minValue

name: minValue, type: Double, default: 0

Sets the minimum value of the output image manually.

maxValue

name: maxValue, type: Double, default: 0

Sets the maximum value of the output image manually.

Get Current Values

name: getCurrentValues, type: Trigger

If pressed, the minValue and maxValue are automatically filled by the according values of the output image.

Adjust Values

name: adjustValue, type: Trigger

If pressed, the output image is computed anew and the fields minValue and maxValue are being updated.

Current Selected Filter

name: currentFilter, type: String, default: No Filter

Shows information about the currently selected filter.

Hidden Fields

borderHandling

name: borderHandling, type: Enum, default: PadSrcClamp

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

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

distanceOn

name: distanceOn, type: Bool, default: FALSE

devianceOn

name: devianceOn, type: Bool, default: FALSE

neighbourSelectOn

name: neighbourSelectOn, type: Bool, default: FALSE

scaleSelectOn

name: scaleSelectOn, type: Bool, default: FALSE

extentInput

name: extentInput, type: Bool, default: FALSE

noFilter

name: noFilter, type: Bool, default: TRUE