IPSDK 0.2
IPSDK : Image Processing Software Development Kit
Skeleton2dDiameterMeanCurvatureSee full documentation

Mean curvature of the longest shortest path between any two skeleton 2d verticies.

Skeleton 2d diameter leangth measure is based on skeleton 2d diameter measure (see [Concept] Skeleton 2d Diameter). This measure allows to compute mean curvature along skeleton diameter path.

Mean curvature is in this case defined for 3 consecutive points as the reciprocal of circle radius passing through these points :

\[ \kappa = \frac{1}{R} \]

Here is an example of measure results for different skeleton 2d holes processing policy.

Skeleton2dDiameterMeanCurvatureMsr.png

Mean curvature of the longest shortest path between any two skeleton 2d verticies

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Generic.png
Generic
custom.png
Custom
parameter.png
Skeleton2dDiameterMeanCurvatureMsrParams
Value.png
Value (ipsdk::ipReal64)
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.createGeometricCalibration2d(1,1,'px'))
PyIPSDK.createMeasureInfo(inMeasureInfoSet2d, "Skeleton2dDiameterTortuosityMsr", shapeanalysis.createSkeleton2dDiameterTortuosityMsrParams(PyIPSDK.eSHP_Ignored))
#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("Skeleton2dDiameterTortuosityMsr")
# 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 pInGreyImg2d = loadTiffImageFile(inputGreyImgPath);
// read entity shape 2d collection used for processing
Shape2dCollPtr pShape2dColl = boost::make_shared<Shape2dColl>();
IPSDK_REQUIRE(readFromXmlFile(inputShape2dCollPath, *pShape2dColl) == true);
// define a measure info set
MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create2dInstance();
createMeasureInfo(pMeasureInfoSet, "Skeleton2dDiameterMeanCurvatureMsr", createSkeleton2dDiameterMeanCurvatureMsrParams(skeleton2dHolesPolicy));
// compute measure on shape 2d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis2d(pInGreyImg2d, pShape2dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pSkeleton2dDiameterMeanCurvatureOutMsr = pOutMeasureSet->getMeasure("Skeleton2dDiameterMeanCurvatureMsr");
const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>& outResults = static_cast<const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>&>(pSkeleton2dDiameterMeanCurvatureOutMsr->getMeasureResult());