WEMDemergePatches¶

MLModule¶

genre	`WEMProcessing`
author	`MeVis Medical Solutions AG`
package	`MeVisLab/Standard`
dll	`MLWEMModules`
definition	MLWEMModules.def
see also	`WEMInfo`
inherits from	`WEMProcessor`
keywords	`separate`, `connected`, `components`

Purpose¶

The module WEMDemergePatches splits a WEM into connected components and offers the possibility to remove certain parts of those separated WEM patches.

If the option Merge All Output Patches is checked, the module just filters a WEM; the output WEM consists of only one patch.

Details¶

The module scans the input WEM for connected components. For each connected component, a WEMPatch is generated, and the geometry stored in there.

This list of WEM patches (connected components) can be purged by adjusting the purge mode and limit.

The following purge modes are available:

Num Nodes, Num Edges, Num Faces, Primitives Percentage
Area mm², Area cm², Area m², Area Percentage
Volume mm³, Volume cm³, Volume ³, Volume Percentage

A purge limit of 0 disables the purging which is the default.

Windows¶

Default Panel¶

../../../Modules/ML/MLWEMModules/mhelp/Images/Screenshots/WEMDemergePatches._default.png

Input Fields¶

inWEM¶

name: inWEM, type: WEM(MLBase)¶: The input WEM consisting to be demerged.

For accessing this object via scripting see the Scripting Reference: MLWEMWrapper.

Output Fields¶

outWEM¶

name: outWEM, type: WEM(MLBase)¶: The demerged and eventually purged WEM.

For accessing this object via scripting see the Scripting Reference: MLWEMWrapper.

Parameter Fields¶

Field Index¶

`Apply`: `Trigger`	`Limit`: `Float`	`progress`: `Float`
`Auto Apply`: `Bool`	`listenToFinishNotifications`: `Bool`	`Purge Mode`: `Enum`
`Clear`: `Trigger`	`listenToRepaintNotifications`: `Bool`	`shouldComputeNormals`: `Bool`
`Description`: `String`	`listenToSelectionChangedNotifications`: `Bool`	`triangulationMode`: `Enum`
`elapsedTime`: `Float`	`Merge All Output Patches`: `Bool`	`Update Mode`: `Enum`
`Generate Edges`: `Bool`	`Overwrite label and description`: `Bool`	`Use Primitive Value List`: `Bool`
`id`: `Integer`	`Patch List String`: `String`	`workDirectlyOnInputWEMs`: `Bool`
`isProcessing`: `Bool`	`Primitive Value List Name`: `String`
`Label`: `String`	`Primitive Value List Range`: `Double`

Visible Fields¶

Auto Apply¶

name: autoApply, type: Bool, default: TRUE¶: If checked, all parameter changes lead to a new computation.

Update Mode¶

name: updateMode, type: Enum, default: AutoUpdate, deprecated name: autoUpdate¶: Defines how this module should react on any input field change.

Apply¶

name: apply, type: Trigger¶: If pressed, the module demerges and purges the input WEM.

Clear¶

name: clear, type: Trigger¶: If pressed, the output WEM is cleared (made empty).

Overwrite label and description¶

name: overwriteLabelDescription, type: Bool, default: FALSE¶: If checked, the label and description string in the output WEM are set to Label and Description, respectively.

Label¶

name: label, type: String¶: Sets a label string in the output WEM.

Description¶

name: description, type: String¶: Sets a description string in the output WEM.

Generate Edges¶

name: generateEdges, type: Bool, default: TRUE¶: If checked and the input WEM has no edges computes yet, edges are computated in the output WEMPatches.

Limit¶

name: limit, type: Float, default: 0¶: Sets the limit for purging WEMPatches. A value of 0 means no purging.

Patch List String¶

name: patchListString, type: String, persistent: no¶: Shows all demerged patches and information about them in this string.

Purge Mode¶

name: limitMode, type: Enum, default: PrimitivesPercentage¶: Defines the purge mode that is active if the Limit is greater than 0.

Values:

Title	Name
Num Nodes	NumNodes
Num Edges	NumEdges
Num Faces	NumFaces
Primitives Percentage	PrimitivesPercentage
Area SMM	AreaSMM
Area SCM	AreaSCM
Area SM	AreaSM
Area Percentage	AreaPercentage
Volume CMM	VolumeCMM
Volume CCM	VolumeCCM
Volume CM	VolumeCM
Volume Percentage	VolumePercentage

Use Primitive Value List¶

name: usePrimitiveValueList, type: Bool, default: FALSE¶: If checked, the module does not scan for connected components anymore but rather for nodes with a Primitive Value List value in a given range.

Primitive Value List Name¶

name: primitiveValueListName, type: String, default: LUT¶: Sets the Primitive Value List which is used as a look up for the value range.

Primitive Value List Range¶

name: primitiveValueListRange, type: Double, default: 1¶: Sets the range for the PVL values to lead to a separation into WEMPatches.

Merge All Output Patches¶

name: mergeAllOutputPatches, type: Bool, default: FALSE¶

If checked, the output WEM consists of only one WEMPatch; filtering is still applied.

Otherwise, the output WEM consists of all separated connected components as single WEMPatches.

Hidden Fields¶

isProcessing¶

name: isProcessing, type: Bool, persistent: no¶

see WEMGenerator.isProcessing

elapsedTime¶

name: elapsedTime, type: Float, persistent: no¶

see WEMGenerator.elapsedTime

id¶

name: id, type: Integer, default: 0¶

see WEMGenerator.id

shouldComputeNormals¶

name: shouldComputeNormals, type: Bool, default: FALSE¶

see WEMGenerator.shouldComputeNormals

workDirectlyOnInputWEMs¶

name: workDirectlyOnInputWEMs, type: Bool, default: FALSE¶

see WEMProcessor.workDirectlyOnInputWEMs

listenToFinishNotifications¶

name: listenToFinishNotifications, type: Bool, default: TRUE¶

see WEMProcessor.listenToFinishNotifications

listenToRepaintNotifications¶

name: listenToRepaintNotifications, type: Bool, default: TRUE¶

see WEMProcessor.listenToRepaintNotifications

listenToSelectionChangedNotifications¶

name: listenToSelectionChangedNotifications, type: Bool, default: TRUE¶

see WEMProcessor.listenToSelectionChangedNotifications

progress¶

name: progress, type: Float, persistent: no¶

see WEMProcessor.progress

triangulationMode¶

name: triangulationMode, type: Enum, default: Strip¶

see WEMProcessor.triangulationMode