SoHExtremaWatershedProcessing Class Reference
[Separating And Filling]

ImageViz SoHExtremaWatershedProcessing engine computes the watershed lines of a grayscale image. More...

#include <ImageViz/Engines/ImageSegmentation/SeparatingAndFilling/SoHExtremaWatershedProcessing.h>

Inheritance diagram for SoHExtremaWatershedProcessing:
SoImageVizEngine SoEngine SoFieldContainer SoBase SoRefCounter SoTypedObject

List of all members.

Public Types

enum  ObjectLightness {
  DARK_OBJECTS = 0,
  BRIGHT_OBJECTS = 1
}
enum  SeparationMode {
  SEPARATED_OBJECTS = 0,
  WATERSHED_RIDGES = 1,
  SEPARATED_BASINS = 2,
  CONTIGUOUS_BASINS = 3
}
enum  AlgorithmMode {
  REPEATABLE = 0,
  FAST = 1
}

Public Member Functions

 SoHExtremaWatershedProcessing ()

Public Attributes

SoSFEnum computeMode
SoSFEnum neighborhood3d
SoSFImageDataAdapter inGrayImage
SoSFEnum objectLightness
SoSFEnum separationMode
SoSFEnum algorithmMode
SoSFInt32 contrastValue
SoImageVizEngineOutput
< SoSFImageDataAdapter,
SoImageDataAdapter * > 
outSeparationImage

Detailed Description

ImageViz SoHExtremaWatershedProcessing engine computes the watershed lines of a grayscale image.

This engine computes the watershed lines of a grayscale image. It directly uses the image for black objects and the inverted image for white objects. You can adjust the contrast level which is used to reduce the number of markers for the watershed process.

This engine is a high-level combination of watershed, distance transform and numerical reconstruction algorithms. There is a limitation to the separating ability: if some particles overlap too much, they will not be separated. This engine can be used on the gradient modulus to compute best-fit contours.

Notice: This engine requires to preliminarily load the whole input data set into memory to be computed. As a consequence the input data set will be automatically loaded before the execution of this engine, ignoring the maximum memory parameter of the SbImageDataAdapterHelper::getAppropriateAdapter function or SoFileDataAdapter class

If the input data set cannot fit in memory, this engine will fail during its computation.

SEE ALSO

SoSeparateObjectsProcessing.

FILE FORMAT/DEFAULT


Library references: greyseparate


Member Enumeration Documentation

Enumerator:
REPEATABLE 

Repeatable but slower.

FAST 

Faster but not repeatable because of asynchronous parallel computation.

Enumerator:
DARK_OBJECTS 

The engine applies to black particles.

BRIGHT_OBJECTS 

The engine applies to white particles.

Enumerator:
SEPARATED_OBJECTS 

The result data is the original data minus separation lines (binary image of split particles).

WATERSHED_RIDGES 

The result data is the separation lines (binary image).

SEPARATED_BASINS 

The result data is the watersheds (label image).

CONTIGUOUS_BASINS 

The result data is the watersheds without separation lines (label image).


Constructor & Destructor Documentation

SoHExtremaWatershedProcessing::SoHExtremaWatershedProcessing (  ) 

Constructor.


Member Data Documentation

Select the algorithm mode for fastwatershed.

Use enum AlgorithmMode. Default is REPEATABLE

Select the compute Mode (2D or 3D or AUTO) Use enum ComputeMode.

Default is MODE_AUTO

The depth of valley.

Default value is 30.

The input grayscale image.

Default value is NULL. Supported types include: grayscale image.

In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.

Use enum Neighborhood3d. Default is CONNECTIVITY_26.

Select the lightness mode for object to separate.

Use enum ObjectLightness. Default is DARK_OBJECTS

The output separation (binary or label) image.

Default value is NULL. Supported types include: grayscale binary label color image.

Select the output image type: separation lines, split objects or separated basins.

Use enum SeparationMode. Default is SEPARATED_OBJECTS


The documentation for this class was generated from the following file:

Open Inventor Toolkit reference manual, generated on 12 Feb 2024
Copyright © Thermo Fisher Scientific All rights reserved.
http://www.openinventor.com/