WEMBinarySurface

MLModule

author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	MLOpenVDB
definition	MLOpenVDB.def
inherits from	WEMGenerator
keywords	iso, contour, dual

Purpose

The WEMBinarySurface allows for creating a surface from a binary segmentation mask. When used in LevelSet” mode, every voxel value not equal to 0 is treated as foreground, while every value equal to 0 is treated as background. This topology mask is used to create a level set that is closed, dilated, or filtered. Finally, a mesh is created using dual contouring on the level set.

It utilizes the OpenVDB library.

NOTE: The topologyToLevelSet method used in level set generation appears to create non-closed level sets, which can lead to undesired holes in the surface.

The module also supports a classical IsoValue mode; however, this mode will be inefficient if there are many voxel values that are not background (equal to 0).

For a more general isosurface generation module, see WEMIsoSurface.

Windows

Default Panel

Parameter Fields

Field Index

Adaptivity: Double	elapsedTime: Float	shouldComputeNormals: Bool
Apply: Trigger	id: Integer	Smoothing Iterations: Integer
Auto Apply: Bool	Iso Value: Float	Update Mode: Enum
Build Edges: Bool	isProcessing: Bool
Clear: Trigger	Label: String
Closing Iterations: Integer	Mode: Enum
Description: String	Overwrite label and description: Bool
Dilate Iterations: Integer	progress: Float

Visible Fields

Auto Apply

name: autoApply, type: Bool, default: TRUE

see WEMGenerator.autoApply

Update Mode

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

see WEMGenerator.updateMode

Apply

name: apply, type: Trigger

see WEMGenerator.apply

Clear

name: clear, type: Trigger

see WEMGenerator.clear

Overwrite label and description

name: overwriteLabelDescription, type: Bool, default: FALSE

see WEMGenerator.overwriteLabelDescription

Label

name: label, type: String

see WEMGenerator.label

Description

name: description, type: String

see WEMGenerator.description

Mode

name: mode, type: Enum, default: LevelSet

Defines the surface generation mode.

Values:

Title	Name	Description
Iso Value	IsoValue	Dual contouring is performed on the interpolated voxel grid using the provided Iso Value. Consider using WEMIsoSurface as an alternative to this mode.
Level Set	LevelSet	Every voxel value not equal to 0 is treated as foreground, while every voxel value equal to 0 is treated as background. This topology mask is used to create a level set that is closed, dilated, or filtered. Finally, a mesh is created using dual contouring on the level set. To select an object in a more complex input image, use a module like IntervalThreshold to map the desired object to 1 and the background to 0.

Adaptivity

name: adaptivity, type: Double, default: 1

Sets the adaptivity of the resulting mesh.

An adaptivity value of 0 means that all triangles are created at the highest resolution, while an adaptivity value of 1 reduces the mesh to the maximum supported by OpenVDB.

Build Edges

name: buildEdges, type: Bool, default: TRUE

If checked, the generation of edge connectivity is enabled.

Closing Iterations

name: closingIterations, type: Integer, default: 1

Sets the number of closing iterations. At least one iteration should be used.

Dilate Iterations

name: dilateIterations, type: Integer, default: 0

Sets the number of dilation iterations.

Smoothing Iterations

name: smoothingIterations, type: Integer, default: 1

Sets the number of smoothing iterations.

Iso Value

name: isoValue, type: Float, default: 0.5

Sets the iso-value for the IsoValue mode.

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

progress

name: progress, type: Float, persistent: no