Centroid2d

Computes the centroid of objects in two-dimensional binary image.

Access to parameter description

For an introduction:

• section Mathematical Morphology
• section Thinning, thickening, and hit-Or-miss operations

For an object without holes, the centroid is a unique point. For an object with holes, the centroid is made of rings surrounding each hole, as shown in Figure 1. This algorithm performs successive thinnings with rotations and until convergence, using the D configuration: $$ \begin{array}{ccc} 0 & \times & \times\\ 0 & \bullet & \times\\ 0 & 0 & \times \end{array} ~~~ \mbox{followed by} ~~~~ \begin{array}{ccc} \times & 0 & \times\\ 0 & \bullet & 1\\ \times & 0 & \times \end{array} $$ Where $\times$ means "don't care".



Note: The centroid must not be confused with a classical center of gravity, which may be outside the object as in the case of a boomerang-shaped particle. However, for quasi-convex objects the centroid is very close to the center of gravity.

See also

• ApplyMorphologicalLut2d
• ApplyMorphologicalLut3d
• Skeleton

// Function prototype.
std::shared_ptr< iolink::ImageView >
centroid2d( std::shared_ptr< iolink::ImageView > inputBinaryImage, std::shared_ptr< iolink::ImageView > outputBinaryImage = NULL );

// Function prototype.
centroid_2d( input_binary_image, output_binary_image = None )

// Function prototype.
public static IOLink.ImageView
Centroid2d( IOLink.ImageView inputBinaryImage, IOLink.ImageView outputBinaryImage = null );

// Command constructor.
Centroid2d();

// 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 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.
Centroid2d.input_binary_image
// Property of the outputBinaryImage parameter.
Centroid2d.output_binary_image

// Method to launch the command.
execute()

// Command constructor.
Centroid2d()

// Property of the inputBinaryImage parameter.
Centroid2d.inputBinaryImage
// Property of the outputBinaryImage parameter.
Centroid2d.outputBinaryImage

// Method to launch the command.
Execute()

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

Centroid2d centroid2dAlgo;
centroid2dAlgo.setInputBinaryImage( polystyrene_sep );
centroid2dAlgo.execute();

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

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

centroid_2d_algo = imagedev.Centroid2d()
centroid_2d_algo.input_binary_image = polystyrene_sep
centroid_2d_algo.execute()

print( "output_binary_image:", str( centroid_2d_algo.output_binary_image ) );

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

Centroid2d centroid2dAlgo = new Centroid2d
{
    inputBinaryImage = polystyrene_sep
};
centroid2dAlgo.Execute();

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

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

auto result = centroid2d( polystyrene_sep );

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

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

result = imagedev.centroid_2d( polystyrene_sep )

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

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

IOLink.ImageView result = Processing.Centroid2d( polystyrene_sep );

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