Module: Topological Image Repair

Description:

Modifies the input object so as to avoid topological "artefacts" in a ensuing skeletonisation¹.

Left:Initial object. Centre: resulting 26-connected skeleton. Right: 26-connected skeleton with pre-processing.
In this example, 56 pixels have been modified (initial object has 2876649 pixels).

Connections:

Image

[required]
The input image, of type HxUniformScalarField3 comes in through this port.

Ports:

Threshold

Used to define, along with the comparison operator, which pixels are in the object.

Comparison

Used to define how the threshold value is used for defining the object.

Value

Pixels of the object and background will be modified by this modules. This provides the values to which object pixels are set to background, and vice versa.

Boundary_condition

For periodic boundary conditions, a neighbourhood of a pixel on the left side of the image contains pixels of the right side.

Action button

Push the button to start the computation.

Commands:

Additional options can be accessed when typing in the console Topological_Image_Repair COMMAND_NAME. Typing the command again usually reverts back to original settings.

`verbose`

Displays timing information after the computation. Retype to hide info.

`create`

Runs the computation. Returns the name of the output, so it can be used in a script, such as set RESULT [Topological_Image_Repair create].

References:

¹ E. Plougonven, and D. Bernard (2011). Optimal removal of topological artefacts in microtomographic images of porous materials. Advances In Water Resources 34: 731-736.