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

Measure allowing to compute the volume of the 3d convex hull for shape.

The ConvexHullVolume3d measure computes the volume of the convex hull calculated for each shape.

Here is an example of volume 3d measurement :

convexHullVolume3dMsr.png

See [Concept] Convex Hull 3d for more details about the convex hull calculation and Volume3d for more details about the volume computation.

Measure allowing to compute the volume of the 3d convex hull for shape

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Generic.png
Generic
volume.png
Volume
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 3d case :

import PyIPSDK
import PyIPSDK.IPSDKIPLShapeAnalysis as shapeanalysis
# Create the infoset
inMeasureInfoSet3d = PyIPSDK.createMeasureInfoSet3d()
PyIPSDK.createMeasureInfo(inMeasureInfoSet3d, "ConvexHullVolume3dMsr")
#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("ConvexHullVolume3dMsr")
# 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, eTiffDirectoryMode::eTDM_Volume);
// read entity shape 3d collection used for processing
Shape3dCollPtr pShape3dColl = boost::make_shared<Shape3dColl>();
readFromBinaryFile(inputShape3dCollPath, *pShape3dColl);
// define a measure info set
MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create3dInstance();
createMeasureInfo(pMeasureInfoSet, "ConvexHullVolume3dMsr");
// compute measure on shape 3d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis3d(pInGreyImg3d, pShape3dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pConvexHullVolume3dOutMsr = pOutMeasureSet->getMeasure("ConvexHullVolume3dMsr");
const ValueMeasureResult<ipReal64>& outResults = static_cast<const ValueMeasureResult<ipReal64>&>(pConvexHullVolume3dOutMsr->getMeasureResult());