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

Measure allowing to compute the area of the 2d convex hull for shape.

The ConvexHullArea2d measure computes the area of the convex hull calculated for each shape.

Here is an example of area 2d measurement :

convexHullArea2dMsr.png

See [Concept] Convex Hull 2d for more details about the convex hull calculation and Area2d for more details about the area computation.

Measure allowing to compute the area of the 2d convex hull for shape

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Generic.png
Generic
area.png
Area
none.png
None
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.createMeasureInfo(inMeasureInfoSet2d, "ConvexHullArea2dMsr")
#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("ConvexHullArea2dMsr")
# 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>();
readFromXmlFile(inputShape2dCollPath, *pShape2dColl);
// define a measure info set
MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create2dInstance();
createMeasureInfo(pMeasureInfoSet, "ConvexHullArea2dMsr");
// compute measure on shape 2d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis2d(pInGreyImg2d, pShape2dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pConvexHullArea2dOutMsr = pOutMeasureSet->getMeasure("ConvexHullArea2dMsr");
const ValueMeasureResult<ipReal64>& outResults = static_cast<const ValueMeasureResult<ipReal64>&>(pConvexHullArea2dOutMsr->getMeasureResult());