DentalWallSegmentation3d

Transforms a grayscale CBCT image into a binary image where every pixel identified as belonging to the dental wall is set to 1 and all the others are set to 0.

Access to parameter description

For an introduction to dental panoramics: section Dental applications

This algorithm performs a rough segmentation of the teeth and the jaws contained in a cone beam computed tomography (CBCT) image.
The binarization step can be either performed automatically, or by using a user-defined threshold value.
A sub sampling factor can be applied to reduce the computation time during the subsequent steps of the workflow.

Figure 2. Dental wall segmentation: (left) the initial CBCT and (right) the segmentation result
Important notices:

This class is dedicated to be used on CBCT data whose voxel size are expressed in millimeters.
Default segmentation parameters are preset to work with voxel intensities in Hounsfield Unit but can be adapted to different calibration thanks to the threshold parameters.

See also

Function Syntax

This function returns outputBinaryImage.

// Function prototype
std::shared_ptr< iolink::ImageView >
dentalWallSegmentation3d( std::shared_ptr< iolink::ImageView > inputImage,
                          bool autoThresholdMode,
                          uint32_t samplingFactor,
                          double threshold,
                          std::shared_ptr< iolink::ImageView > outputBinaryImage = NULL );

This function returns outputBinaryImage.

// Function prototype.
dental_wall_segmentation_3d( input_image,
                             auto_threshold_mode = True,
                             sampling_factor = 4,
                             threshold = 1000,
                             output_binary_image = None )

This function returns outputBinaryImage.

// Function prototype.
public static IOLink.ImageView
DentalWallSegmentation3d( IOLink.ImageView inputImage,
                          bool autoThresholdMode = true,
                          UInt32 samplingFactor = 4,
                          double threshold = 1000,
                          IOLink.ImageView outputBinaryImage = null );

Class Syntax

// Command constructor.
DentalWallSegmentation3d();

/// Gets the inputImage parameter.
/// The input 3D CBCT image of the head (LP orientation).
std::shared_ptr< iolink::ImageView > inputImage() const;
/// Sets the inputImage parameter.
/// The input 3D CBCT image of the head (LP orientation).
void setInputImage( std::shared_ptr< iolink::ImageView > inputImage );

/// Gets the autoThresholdMode parameter.
/// The way to binarize the data. Performs an automatic segmentation of the teeth is equals true, applies the threshold defined by the thresholdRange parameter otherwise.
bool autoThresholdMode() const;
/// Sets the autoThresholdMode parameter.
/// The way to binarize the data. Performs an automatic segmentation of the teeth is equals true, applies the threshold defined by the thresholdRange parameter otherwise.
void setAutoThresholdMode( const bool& autoThresholdMode );

/// Gets the samplingFactor parameter.
/// The down sampling factor to compute the segmentation volume used for extracting the dental wall.
uint32_t samplingFactor() const;
/// Sets the samplingFactor parameter.
/// The down sampling factor to compute the segmentation volume used for extracting the dental wall.
void setSamplingFactor( const uint32_t& samplingFactor );

/// Gets the threshold parameter.
/// The low and high threshold levels. This parameter is ignored when the automatic threshold mode is enabled.
double threshold() const;
/// Sets the threshold parameter.
/// The low and high threshold levels. This parameter is ignored when the automatic threshold mode is enabled.
void setThreshold( const double& threshold );

/// Gets the outputBinaryImage parameter.
/// The output binary image representing the extracted dental wall. Its dimensions are equal to the input image dimensions divided by the sampling factor.
std::shared_ptr< iolink::ImageView > outputBinaryImage() const;
/// Sets the outputBinaryImage parameter.
/// The output binary image representing the extracted dental wall. Its dimensions are equal to the input image dimensions divided by the sampling factor.
void setOutputBinaryImage( std::shared_ptr< iolink::ImageView > outputBinaryImage );


// Method to launch the command.
void execute();

# Property of the inputImage parameter.
DentalWallSegmentation3d.input_image
# Property of the autoThresholdMode parameter.
DentalWallSegmentation3d.auto_threshold_mode
# Property of the samplingFactor parameter.
DentalWallSegmentation3d.sampling_factor
# Property of the threshold parameter.
DentalWallSegmentation3d.threshold
# Property of the outputBinaryImage parameter.
DentalWallSegmentation3d.output_binary_image

// Method to launch the command.
execute()

// Command constructor.
DentalWallSegmentation3d()

// Property of the inputImage parameter.
DentalWallSegmentation3d.inputImage
// Property of the autoThresholdMode parameter.
DentalWallSegmentation3d.autoThresholdMode
// Property of the samplingFactor parameter.
DentalWallSegmentation3d.samplingFactor
// Property of the threshold parameter.
DentalWallSegmentation3d.threshold
// Property of the outputBinaryImage parameter.
DentalWallSegmentation3d.outputBinaryImage

// Method to launch the command.
Execute()

Parameters

	Description	Type	Supported Values	Default Value
inputImage	The input 3D CBCT image of the head (LP orientation).	Image	Grayscale	nullptr
autoThresholdMode	The way to binarize the data. Performs an automatic segmentation of the teeth is equals true, applies the threshold defined by the thresholdRange parameter otherwise.	Bool		true
threshold	The low and high threshold levels. This parameter is ignored when the automatic threshold mode is enabled.	Float64	Any value	1000
samplingFactor	The down sampling factor to compute the segmentation volume used for extracting the dental wall. The higher this factor is, the less precise the fitted mesh is and the faster the computation is. If it is equal to 1, no down sampling is applied.	UInt32	Any value	4
outputBinaryImage	The output binary image representing the extracted dental wall. Its dimensions are equal to the input image dimensions divided by the sampling factor.	Image		nullptr

Description	Type	Supported Values	Default Value
input_image	The input 3D CBCT image of the head (LP orientation).	image	Grayscale	None
auto_threshold_mode	The way to binarize the data. Performs an automatic segmentation of the teeth is equals true, applies the threshold defined by the thresholdRange parameter otherwise.	bool		True
threshold	The low and high threshold levels. This parameter is ignored when the automatic threshold mode is enabled.	float64	Any value	1000
sampling_factor	The down sampling factor to compute the segmentation volume used for extracting the dental wall. The higher this factor is, the less precise the fitted mesh is and the faster the computation is. If it is equal to 1, no down sampling is applied.	uint32	Any value	4
output_binary_image	The output binary image representing the extracted dental wall. Its dimensions are equal to the input image dimensions divided by the sampling factor.	image		None

Description	Type	Supported Values	Default Value
inputImage	The input 3D CBCT image of the head (LP orientation).	Image	Grayscale	null
autoThresholdMode	The way to binarize the data. Performs an automatic segmentation of the teeth is equals true, applies the threshold defined by the thresholdRange parameter otherwise.	Bool		true
threshold	The low and high threshold levels. This parameter is ignored when the automatic threshold mode is enabled.	Float64	Any value	1000
samplingFactor	The down sampling factor to compute the segmentation volume used for extracting the dental wall. The higher this factor is, the less precise the fitted mesh is and the faster the computation is. If it is equal to 1, no down sampling is applied.	UInt32	Any value	4
outputBinaryImage	The output binary image representing the extracted dental wall. Its dimensions are equal to the input image dimensions divided by the sampling factor.	Image		null

Object Examples

std::shared_ptr< iolink::ImageView > dental_cbct = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "dental_cbct.am" );

DentalWallSegmentation3d dentalWallSegmentation3dAlgo;
dentalWallSegmentation3dAlgo.setInputImage( dental_cbct );
dentalWallSegmentation3dAlgo.setAutoThresholdMode( true );
dentalWallSegmentation3dAlgo.setSamplingFactor( 4 );
dentalWallSegmentation3dAlgo.setThreshold( 580 );
dentalWallSegmentation3dAlgo.execute();

std::cout << "outputBinaryImage:" << dentalWallSegmentation3dAlgo.outputBinaryImage()->toString();

dental_cbct = ioformat.read_image(imagedev_data.get_image_path("dental_cbct.am"))

dental_wall_segmentation_3d_algo = imagedev.DentalWallSegmentation3d()
dental_wall_segmentation_3d_algo.input_image = dental_cbct
dental_wall_segmentation_3d_algo.auto_threshold_mode = True
dental_wall_segmentation_3d_algo.sampling_factor = 4
dental_wall_segmentation_3d_algo.threshold = 580
dental_wall_segmentation_3d_algo.execute()

print( "output_binary_image:", str( dental_wall_segmentation_3d_algo.output_binary_image ) )

ImageView dental_cbct = ViewIO.ReadImage( @"Data/images/dental_cbct.am" );

DentalWallSegmentation3d dentalWallSegmentation3dAlgo = new DentalWallSegmentation3d
{
    inputImage = dental_cbct,
    autoThresholdMode = true,
    samplingFactor = 4,
    threshold = 580
};
dentalWallSegmentation3dAlgo.Execute();

Console.WriteLine( "outputBinaryImage:" + dentalWallSegmentation3dAlgo.outputBinaryImage.ToString() );

Function Examples

std::shared_ptr< iolink::ImageView > dental_cbct = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "dental_cbct.am" );

auto result = dentalWallSegmentation3d( dental_cbct, true, 4, 580 );

std::cout << "outputBinaryImage:" << result->toString();

dental_cbct = ioformat.read_image(imagedev_data.get_image_path("dental_cbct.am"))

result = imagedev.dental_wall_segmentation_3d( dental_cbct, True, 4, 580 )

print( "output_binary_image:", str( result ) )

ImageView dental_cbct = ViewIO.ReadImage( @"Data/images/dental_cbct.am" );

IOLink.ImageView result = Processing.DentalWallSegmentation3d( dental_cbct, true, 4, 580 );

Console.WriteLine( "outputBinaryImage:" + result.ToString() );

DentalWallSegmentation3d

- Function Syntax

+ Class Syntax

Parameters

Object Examples

Function Examples

Function Syntax

Class Syntax