ImageDev

ClosingByReconstruction3d

Performs a three-dimensional closing by reconstruction with a structuring element matching with a cube.

Access to parameter description

A closing by reconstruction consists in applying a dilation followed by a morphological reconstruction. In the binary case, closing by reconstruction can be used for filling small holes without modifying edges of the large ones. In the grayscale case, opening by reconstruction can be used for performing a Top Hat by reconstruction for detecting dark small structures without getting artifacts from the boundary concavities of large structures.
Its 2D grayscale behavior is illustrated in the ClosingByReconstruction2d documentation (Figure 1).

See also
See related example

Function Syntax

This function returns outputImage. 
// Function prototype
std::shared_ptr< iolink::ImageView >
closingByReconstruction3d( std::shared_ptr< iolink::ImageView > inputImage,
                           uint32_t kernelRadius,
                           ClosingByReconstruction3d::Neighborhood neighborhood,
                           std::shared_ptr< iolink::ImageView > outputImage = NULL );
This function returns outputImage. 
// Function prototype.
closing_by_reconstruction_3d( input_image,
                              kernel_radius = 3,
                              neighborhood = ClosingByReconstruction3d.Neighborhood.CONNECTIVITY_26,
                              output_image = None )
This function returns outputImage. 
// Function prototype.
public static IOLink.ImageView
ClosingByReconstruction3d( IOLink.ImageView inputImage,
                           UInt32 kernelRadius = 3,
                           ClosingByReconstruction3d.Neighborhood neighborhood = ImageDev.ClosingByReconstruction3d.Neighborhood.CONNECTIVITY_26,
                           IOLink.ImageView outputImage = null );

Class Syntax

Parameters

Parameter Name Description Type Supported Values Default Value
input
inputImage
The input image. Image Binary, Label or Grayscale nullptr
input
kernelRadius
The number of iterations (the half size of the structuring element, in voxels). A cube structuring element always has an odd side length (3x3x3, 5x5x5, etc.) which is defined by twice the kernel radius + 1. UInt32 >=1 3
input
neighborhood
The 3D neighborhood configuration.
CONNECTIVITY_6 The structuring element is composed of voxels with a common face with the voxel of interest.
CONNECTIVITY_18 The structuring element is composed of voxels with at least one common edge.
CONNECTIVITY_26 The structuring element is a full cube.
Enumeration CONNECTIVITY_26
output
outputImage
The output image. Its dimensions and type are forced to the same values as the input image. Image nullptr
Parameter Name Description Type Supported Values Default Value
input
input_image
The input image. image Binary, Label or Grayscale None
input
kernel_radius
The number of iterations (the half size of the structuring element, in voxels). A cube structuring element always has an odd side length (3x3x3, 5x5x5, etc.) which is defined by twice the kernel radius + 1. uint32 >=1 3
input
neighborhood
The 3D neighborhood configuration.
CONNECTIVITY_6 The structuring element is composed of voxels with a common face with the voxel of interest.
CONNECTIVITY_18 The structuring element is composed of voxels with at least one common edge.
CONNECTIVITY_26 The structuring element is a full cube.
enumeration CONNECTIVITY_26
output
output_image
The output image. Its dimensions and type are forced to the same values as the input image. image None
Parameter Name Description Type Supported Values Default Value
input
inputImage
The input image. Image Binary, Label or Grayscale null
input
kernelRadius
The number of iterations (the half size of the structuring element, in voxels). A cube structuring element always has an odd side length (3x3x3, 5x5x5, etc.) which is defined by twice the kernel radius + 1. UInt32 >=1 3
input
neighborhood
The 3D neighborhood configuration.
CONNECTIVITY_6 The structuring element is composed of voxels with a common face with the voxel of interest.
CONNECTIVITY_18 The structuring element is composed of voxels with at least one common edge.
CONNECTIVITY_26 The structuring element is a full cube.
Enumeration CONNECTIVITY_26
output
outputImage
The output image. Its dimensions and type are forced to the same values as the input image. Image null

Object Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

ClosingByReconstruction3d closingByReconstruction3dAlgo;
closingByReconstruction3dAlgo.setInputImage( foam );
closingByReconstruction3dAlgo.setKernelRadius( 3 );
closingByReconstruction3dAlgo.setNeighborhood( ClosingByReconstruction3d::Neighborhood::CONNECTIVITY_26 );
closingByReconstruction3dAlgo.execute();

std::cout << "outputImage:" << closingByReconstruction3dAlgo.outputImage()->toString();

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

closing_by_reconstruction_3d_algo = imagedev.ClosingByReconstruction3d()
closing_by_reconstruction_3d_algo.input_image = foam
closing_by_reconstruction_3d_algo.kernel_radius = 3
closing_by_reconstruction_3d_algo.neighborhood = imagedev.ClosingByReconstruction3d.CONNECTIVITY_26
closing_by_reconstruction_3d_algo.execute()

print( "output_image:", str( closing_by_reconstruction_3d_algo.output_image ) )

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

ClosingByReconstruction3d closingByReconstruction3dAlgo = new ClosingByReconstruction3d
{
    inputImage = foam,
    kernelRadius = 3,
    neighborhood = ClosingByReconstruction3d.Neighborhood.CONNECTIVITY_26
};
closingByReconstruction3dAlgo.Execute();

Console.WriteLine( "outputImage:" + closingByReconstruction3dAlgo.outputImage.ToString() );

Function Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

auto result = closingByReconstruction3d( foam, 3, ClosingByReconstruction3d::Neighborhood::CONNECTIVITY_26 );

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

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

result = imagedev.closing_by_reconstruction_3d( foam, 3, imagedev.ClosingByReconstruction3d.CONNECTIVITY_26 )

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

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

IOLink.ImageView result = Processing.ClosingByReconstruction3d( foam, 3, ClosingByReconstruction3d.Neighborhood.CONNECTIVITY_26 );

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