WEMSelectPatches

MLModule

genre	WEMProcessing
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	MLWEMModules
definition	MLWEMModules.def
see also	WEMDemergePatches, WEMThreshold
inherits from	WEMProcessor
keywords	create, filter

Purpose

The module WEMSelectPatches allows for selecting patches of a WEM and creating a new WEM from them.

Usage

Connect a WEM to the input field. Select the parameters described below to define which patches shall be copied to the new WEM.

Click Apply to create the new WEM (or alternatively, enable the Auto Apply option).

Pressing the Clear button clears the output WEM (removing all patches).

Details

This module creates a new WEM based on the WEMPatches connected to its input.

Each time the Apply button is clicked, a new WEM is created that consists of all patches from the WEM connected to the input that match the criteria.

The input WEM is not altered.

If the option Auto Apply is enabled, all parameter changes automatically trigger the creation of the new WEM.

Pressing the Clear button removes all patches from the output WEM.

Tips

If Merge and triangulate all output patches or Triangulate each single output patch is enabled, the Label and the Description attributes must be set; otherwise, they are overwritten with the default empty value.

Windows

Default Panel

Input Fields

inWEM

name: inWEM, type: WEM(MLBase)

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

Output Fields

outWEM

name: outWEM, type: WEM(MLBase)

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

Parameter Fields

Field Index

Apply: Trigger	listenToFinishNotifications: Bool	Selection Value: String
Auto Apply: Bool	listenToRepaintNotifications: Bool	shouldComputeNormals: Bool
Clear: Trigger	listenToSelectionChangedNotifications: Bool	Status: String
Description: String	Merge and triangulate all output patches: Bool	Triangulate each single output patch: Bool
elapsedTime: Float	Overwrite Label Description: Bool	triangulationMode: Enum
id: Integer	Primitive Value Name: String	Update Mode: Enum
isProcessing: Bool	progress: Float	workDirectlyOnInputWEMs: Bool
Label: String	Selection Mode: Enum

Visible Fields

Auto Apply

name: autoApply, type: Bool, default: FALSE

If checked, the module selects the output patch(es) on changing any parameter.

see also WEMGenerator.autoApply

Update Mode

name: updateMode, type: Enum, default: AutoUpdate, deprecated name: autoUpdate

Defines the update mode of this module.

see also WEMGenerator.updateMode

Apply

name: apply, type: Trigger

When pressed, the module selects the output patch(es) on base of the parameters.

see also WEMGenerator.apply

Clear

name: clear, type: Trigger

When pressed, the module clears its output.

see also WEMGenerator.clear

Overwrite Label Description

name: overwriteLabelDescription, type: Bool, default: FALSE

If checked, label and description strings are set in the output WEM to Label and Description.

see also WEMGenerator.overwriteLabelDescription

Label

name: label, type: String

Sets the label string to the output WEMPatch.

see also WEMGenerator.label

Description

name: description, type: String

Sets the description string to the output WEMPatch.

see also WEMGenerator.description

Selection Mode

name: selectMode, type: Enum, default: Patch Number

Defines which property of the input WEM patches shall be used for selection.

Values:

Title	Name	Description
​Patch Number	​Patch Number	​The patch numbers are used for selecting, starting with 0. For example, in a WEM that contains three WEMPatches, a Selection Value of “0 1” will select the first two patches.
​Patch ID	​Patch ID	​The patch IDs are used for selecting.
​Primitive Value: LUT	​PrimitiveValue: LUT	​The mean Primitive Value List (PVL) value of a patch with the name “LUT” is used for selection.
​Primitive Value	​PrimitiveValue	​The mean Primitive Value List (PVL) value of a patch specified in Primitive Value Name is used for selection.

Selection Value

name: selectValue, type: String

Sets a list of space-separated values to selected the WEMPatches. The use of the values depends on Selection Mode.

Primitive Value Name

name: primitiveValueName, type: String

Sets a Primitive Value List (PVL) name to select a WEMPatch if Selection Mode is set to PrimitiveValue.

A patch is selected if the mean PVL value is equal to the value specified in Selection Value.

Hint: Use the module WEMInfo to show the mean PVL value of a WEMPatch.

Merge and triangulate all output patches

name: singleOutputPatch, type: Bool, default: TRUE

If checked, all selected patches are merged into a single output patch.

In this case, the single output patch is always a triangle patch. Otherwise, each output patch can be triangulated (see Triangulate each single output patch).

Triangulate each single output patch

name: triangulatePatches, type: Bool, default: TRUE

If checked, all patches will be triangulated before being added to the output WEM.

Remember: some WEM modules support arbitrary polygons; others do not.

Normally, all patches from the input WEM are copied to the output WEM “as they are” (i.e., with the same number and type of faces as in the input WEM).

This option is available only if Merge and triangulate all output patches is not checked.

Status

name: status, type: String, persistent: no

Shows the status of the module.

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: TRUE

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