IPSDK 0.2
IPSDK : Image Processing Software Development Kit

Number of voxels in shape 3d measurement.

NbPixels3d measure simply count number of voxels associated to a 3d shape.

Note that shape 3d volume and number of voxels may differ since the volume is computed with respect to a given polyhedral approximation while the number of voxels only takes care of initial image binary shape.

Here is an example of number of voxels measurement :

nbPixels3dMsr.png

Number of pixels in shape 3d measurement

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Geometry3d.png
Geometry 3d
none.png
None
none.png
None
Value.png
Value (ipsdk::ipUInt64)
RowIntersections.png
Row Intersections
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, "NbPixels3dMsr")
#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("NbPixels3dMsr")
# 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();
BoolResult bCreateNbPixels3dMsr = pMeasureInfoSet->createMeasureInfo("NbPixels3dMsr");
IPSDK_REQUIRE_MESSAGE(bCreateNbPixels3dMsr == true, bCreateNbPixels3dMsr.getMsg());
// compute measure on shape 3d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis3d(pInGreyImg3d, pShape3dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pNbPixels3dOutMsr = pOutMeasureSet->getMeasure("NbPixels3dMsr");
const ValueMeasureResult<ipUInt64>& outResults = static_cast<const ValueMeasureResult<ipUInt64>&>(pNbPixels3dOutMsr->getMeasureResult());