IPSDK  4_1_0_2
IPSDK : Image Processing Software Development Kit
Classes
Distance to nearest barycenter 3d

computation of distance from shape barycenter to nearest neighbor shape barycenter for each shape More...

Classes

class  ipsdk::imaproc::shape::analysis::DistanceToNearestBarycenter3dMsr
 Measurement object for measure DistanceToNearestBarycenter3d. More...
 
class  ipsdk::imaproc::shape::analysis::DistanceToNearestBarycenter3dMsrInfo
 Information object for measure DistanceToNearestBarycenter3d. More...
 

Detailed Description

computation of distance from shape barycenter to nearest neighbor shape barycenter for each shape

This measure allows to compute the distance from the shape barycenter to its nearest neighbor shape barycenter. It is based on a geometric analysis of shape neighborhood.

Here is an example of nearest barycenter computation for a sample of shapes :

distanceToNearestBarycenter3dMsr.png

In the previous figure, the distance to the nearest barycenter is illustrated using a color map starting on green colors for lower distance and ending on red color for higher distances

Author
E.Noirfalise
Date
2018/07/23

computation of distance from shape barycenter to nearest neighbor shape barycenter for each shape

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Geometry3d.png
Geometry 3d
length.png
Length
none.png
None
Value.png
Value (ipsdk::ipReal64)
RowIntersections.png
Row Intersections
See Shape measurement for additional information on these pictograms

Measure Type :

This is a geometry 3d measure

This measure can only be used in 3d case

Measure Unit Type:

Measure DistanceToNearestBarycenter3d is associated to a length measurement unit [ipsdk::shape::analysis::eMsrUnitFormat::eMUF_LengthUnit]

Measure Parameter Type :

Measure DistanceToNearestBarycenter3d has no parameters

Measure Result Type :

Measure DistanceToNearestBarycenter3d is associated to ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64> results

Measure Shape Requirements :

Measure DistanceToNearestBarycenter3d requires row intersections from shape data

Measure Dependencies :

Measure DistanceToNearestBarycenter3d depends on following measures :

Measure Mode Measure Name Measure Type Measure Parameters
eMVP_3d Barycenter3dCollRTree Barycenter3dCollRTree
eMVP_3d Barycenter Barycenter3d
Note
See Shape Analysis 3d for more information on general shape 3d analysis and measurement usage.

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, "DistanceToNearestBarycenter3dMsr")
#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("DistanceToNearestBarycenter3dMsr")
# 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 pInGreyImg3d = loadTiffImageFile(inputGreyImgPath);
// read entity shape 3d collection used for processing
Shape3dCollPtr pShape3dColl = boost::make_shared<Shape3dColl>();
IPSDK_REQUIRE(readFromBinaryFile(inputShape3dCollPath, *pShape3dColl) == true);
// define a measure info set
MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create3dInstance();
createMeasureInfo(pMeasureInfoSet, "DistanceToNearestBarycenter3dMsr");
// compute measure on shape 3d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis3d(pInGreyImg3d, pShape3dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pDistanceToNearestBarycenter3dOutMsr = pOutMeasureSet->getMeasure("DistanceToNearestBarycenter3dMsr");
const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>& outResults = static_cast<const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>&>(pDistanceToNearestBarycenter3dOutMsr->getMeasureResult());