BinarySmoothing3d

Transforms a binary three-dimensional image into another binary image with respect to the real local mean of each voxel neighborhood.

Access to parameter description

This algorithm computes a binary smoothing using a specified window size.
It consists of a two step procedure:

Computation of the local mean in the neighborhood, defined by the window size, considering foreground voxels with a value of 1 and background pixels with a value of 0.
Thresholding of the result using the threshold parameter.

Note: the binary smoothing does not preserve the topology of objects.

See also

Function Syntax

This function returns the outputBinaryImage output parameter.

// Function prototype.
std::shared_ptr< iolink::ImageView >
binarySmoothing3d( std::shared_ptr< iolink::ImageView > inputBinaryImage,
                   int32_t kernelRadiusX,
                   int32_t kernelRadiusY,
                   int32_t kernelRadiusZ,
                   double threshold,
                   std::shared_ptr< iolink::ImageView > outputBinaryImage = NULL );

This function returns the outputBinaryImage output parameter.

// Function prototype.
binary_smoothing_3d( input_binary_image,
                     kernel_radius_x = 3,
                     kernel_radius_y = 3,
                     kernel_radius_z = 3,
                     threshold = 0.5,
                     output_binary_image = None )

This function returns the outputBinaryImage output parameter.

// Function prototype.
public static IOLink.ImageView
BinarySmoothing3d( IOLink.ImageView inputBinaryImage,
                   Int32 kernelRadiusX = 3,
                   Int32 kernelRadiusY = 3,
                   Int32 kernelRadiusZ = 3,
                   double threshold = 0.5,
                   IOLink.ImageView outputBinaryImage = null );

Class Syntax

// Command constructor.
BinarySmoothing3d();

// Get method of the inputBinaryImage parameter.
std::shared_ptr< iolink::ImageView > inputBinaryImage() const;
// Set method of the inputBinaryImage parameter.
void setInputBinaryImage( std::shared_ptr< iolink::ImageView > inputBinaryImage );

// Get method of the kernelRadiusX parameter.
int32_t kernelRadiusX() const;
// Set method of the kernelRadiusX parameter.
void setKernelRadiusX( const int32_t& kernelRadiusX );

// Get method of the kernelRadiusY parameter.
int32_t kernelRadiusY() const;
// Set method of the kernelRadiusY parameter.
void setKernelRadiusY( const int32_t& kernelRadiusY );

// Get method of the kernelRadiusZ parameter.
int32_t kernelRadiusZ() const;
// Set method of the kernelRadiusZ parameter.
void setKernelRadiusZ( const int32_t& kernelRadiusZ );

// Get method of the threshold parameter.
double threshold() const;
// Set method of the threshold parameter.
void setThreshold( const double& threshold );

// Get method of the outputBinaryImage parameter.
std::shared_ptr< iolink::ImageView > outputBinaryImage() const;
// Set method of the outputBinaryImage parameter.
void setOutputBinaryImage( std::shared_ptr< iolink::ImageView > outputBinaryImage );

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

// Property of the inputBinaryImage parameter.
BinarySmoothing3d.input_binary_image
// Property of the kernelRadiusX parameter.
BinarySmoothing3d.kernel_radius_x
// Property of the kernelRadiusY parameter.
BinarySmoothing3d.kernel_radius_y
// Property of the kernelRadiusZ parameter.
BinarySmoothing3d.kernel_radius_z
// Property of the threshold parameter.
BinarySmoothing3d.threshold
// Property of the outputBinaryImage parameter.
BinarySmoothing3d.output_binary_image

// Method to launch the command.
execute()

// Command constructor.
BinarySmoothing3d()

// Property of the inputBinaryImage parameter.
BinarySmoothing3d.inputBinaryImage
// Property of the kernelRadiusX parameter.
BinarySmoothing3d.kernelRadiusX
// Property of the kernelRadiusY parameter.
BinarySmoothing3d.kernelRadiusY
// Property of the kernelRadiusZ parameter.
BinarySmoothing3d.kernelRadiusZ
// Property of the threshold parameter.
BinarySmoothing3d.threshold
// Property of the outputBinaryImage parameter.
BinarySmoothing3d.outputBinaryImage

// Method to launch the command.
Execute()

Parameters

Class Name	BinarySmoothing3d

	Description	Type	Supported Values	Default Value
inputBinaryImage	The input binary image.	Image	Binary	nullptr
kernelRadiusX	The horizontal kernel size in voxels.	Int32	>=1	3
kernelRadiusY	The vertical kernel size in voxels.	Int32	>=1	3
kernelRadiusZ	The depth kernel size in voxels.	Int32	>=1	3
threshold	The threshold value applied to the local mean (the minimum volume fraction in the window to set a pixel to 1).	Float64	]0, 1]	0.5
outputBinaryImage	The output binary image. Its dimensions are forced to the same values as the input.	Image		nullptr

Object Examples

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

BinarySmoothing3d binarySmoothing3dAlgo;
binarySmoothing3dAlgo.setInputBinaryImage( foam_sep );
binarySmoothing3dAlgo.setKernelRadiusX( 3 );
binarySmoothing3dAlgo.setKernelRadiusY( 3 );
binarySmoothing3dAlgo.setKernelRadiusZ( 3 );
binarySmoothing3dAlgo.setThreshold( 0.5 );
binarySmoothing3dAlgo.execute();

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

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

binary_smoothing_3d_algo = imagedev.BinarySmoothing3d()
binary_smoothing_3d_algo.input_binary_image = foam_sep
binary_smoothing_3d_algo.kernel_radius_x = 3
binary_smoothing_3d_algo.kernel_radius_y = 3
binary_smoothing_3d_algo.kernel_radius_z = 3
binary_smoothing_3d_algo.threshold = 0.5
binary_smoothing_3d_algo.execute()

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

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

BinarySmoothing3d binarySmoothing3dAlgo = new BinarySmoothing3d
{
    inputBinaryImage = foam_sep,
    kernelRadiusX = 3,
    kernelRadiusY = 3,
    kernelRadiusZ = 3,
    threshold = 0.5
};
binarySmoothing3dAlgo.Execute();

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

Function Examples

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

auto result = binarySmoothing3d( foam_sep, 3, 3, 3, 0.5 );

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

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

result = imagedev.binary_smoothing_3d( foam_sep, 3, 3, 3, 0.5 )

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

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

IOLink.ImageView result = Processing.BinarySmoothing3d( foam_sep, 3, 3, 3, 0.5 );

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

BinarySmoothing3d

- Function Syntax

+ Class Syntax

Parameters

Object Examples

Function Examples

Function Syntax

Class Syntax