IPSDK 4.1.0.2
IPSDK : Image Processing Software Development Kit
Number of 2D Connected Components

Returns the number of connected components associated to each 2d shape.

Natively, IPSDK assigns a single connected component to each shape. However, the result of a machine learning segmentation or a manual labelization can yield to several connected components assigned to the same label value.

Natively, IPSDK assigns a single connected component to each shape / label value.

Here is an example of measurement :

nbConnectedComponents2dMsr.png

Returns the number of connected components associated to each 2d shape

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Geometry2d.png
Geometry 2d
none.png
None
none.png
None
Value.png
Value (ipsdk::ipUInt64)
BoundaryApproximation.png
Boundary Approximation
See Shape measurement for additional information on these pictograms

Example of Python code :

Generic example in 2d case :

import PyIPSDK
import PyIPSDK.IPSDKIPLShapeAnalysis as shapeanalysis
# Create the infoset
inMeasureInfoSet2d = PyIPSDK.createMeasureInfoSet2d()
PyIPSDK.createMeasureInfo(inMeasureInfoSet2d, "NbConnectedComponents2dMsr")
#Perform the analysis
outMeasureSet = shapeanalysis.labelAnalysis2d(inGreyImg, inLabelImg2d, inMeasureInfoSet2d)
# save results to csv format
PyIPSDK.saveCsvMeasureFile(os.path.join(tmpPath, "shape_analysis_results.csv"), outMeasureSet)
# retrieve measure results
outMsr = outMeasureSet.getMeasure("NbConnectedComponents2dMsr")
# retrieve measure values
outMsrValues = outMsr.getMeasureResult().getColl(0)
print("First label measurement equal " + str(outMsrValues[1]))

Example of C++ code :

Example informations

Associated library

IPSDKIPLShapeAnalysis

Code Example

// opening label input image
ImagePtr pInLabelImg2d = loadTiffImageFile(inputLabelImgPath);
// define a measure info set
MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create2dInstance();
createMeasureInfo(pMeasureInfoSet, "NbConnectedComponents2dMsr");
// compute measure on shape 2d collection
MeasureSetPtr pOutMeasureSet = labelAnalysis2d(pInLabelImg2d, pInLabelImg2d, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pNbConnectedComponents2dOutMsr = pOutMeasureSet->getMeasure("NbConnectedComponents2dMsr");
const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipUInt64>& outResults = static_cast<const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipUInt64>&>(pNbConnectedComponents2dOutMsr->getMeasureResult());