Returns the number of connected components associated to each 3d 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 :

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

Measure synthesis :

Measure Type	Measure Unit Type	Parameter Type	Result Type	Shape Requirements
Geometry 3d	None	None	Value (ipsdk::ipUInt64)	Boundary Approximation

See Shape measurement for additional information on these pictograms

Example of Python code :

Generic example in 3d case :

import PyIPSDK

import PyIPSDK.IPSDKIPLShapeAnalysis as shapeanalysis

    # Create the infoset
    inMeasureInfoSet3d = PyIPSDK.createMeasureInfoSet3d()
    PyIPSDK.createMeasureInfo(inMeasureInfoSet3d, "NbConnectedComponents3dMsr")
    
    #Perform the analysis
    outMeasureSet = shapeanalysis.labelAnalysis3d(inGreyImg, inLabelImg, inMeasureInfoSet3d)
    
    # save results to csv format
    PyIPSDK.saveCsvMeasureFile(os.path.join(tmpPath,  "shape_analysis_results.csv"), outMeasureSet)
    
    # retrieve measure results
    outMsr = outMeasureSet.getMeasure("NbConnectedComponents3dMsr")
    
    # 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 grey level input image
    ImagePtr pInLabelImg3d = loadTiffImageFile(inputLabelImgPath);
    // define a measure info set
    MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create3dInstance();
    createMeasureInfo(pMeasureInfoSet, "NbConnectedComponents3dMsr");
    
    // compute measure on shape 3d collection
    MeasureSetPtr pOutMeasureSet = labelAnalysis3d(pInLabelImg3d, pInLabelImg3d, createSubSampledSurfaceExtractionSettings(0), pMeasureInfoSet);
    // retrieve associated results
    const MeasureConstPtr& pNbConnectedComponents3dOutMsr = pOutMeasureSet->getMeasure("NbConnectedComponents3dMsr");
    const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipUInt64>& outResults = static_cast<const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipUInt64>&>(pNbConnectedComponents3dOutMsr->getMeasureResult());