IPSDK 0.2
IPSDK : Image Processing Software Development Kit

Measure allowing to compute the ratio between the shapes areas and the image area.

This measure computes the ratio between the shapes areas and the image area, in terms of number of pixels. For a given shape, the 2d ratio is calculated as follows :

\[ ImageRatio = \frac{shapeNbPixels}{imageNbPixels} \]

Where $ ImageRatio \in \left[ 0, 1 \right]$, $ shapeNbPixels $ is the number of pixels of the shape calculated with NbPixels2d and $ imageNbPixels = width(Image) \times height(Image)$ is the number of pixels of the image.

In the 3d case, the ratio is given by :

\[ ImageRatio = \frac{shapeVolume}{imageVolume} \]

Where $ shapeVolume $ is the number of voxels of the shape calculated with NbPixels3d and $ imageVolumle = width(Image) \times height(Image) \times depth(Image)$ is the volume of the image.

Here is an example of image ratio measurement in 2d case :

imageRatioMsr.png

Measure allowing to compute the ratio between the shapes areas and the image area

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Generic.png
Generic
none.png
None
none.png
None
Value.png
Value (ipsdk::ipReal64)
RowIntersections.png
Row Intersections
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, "ImageRatioMsr")
#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("ImageRatioMsr")
# retrieve measure values
outMsrValues = outMsr.getMeasureResult().getColl(0)
print("First label measurement equal " + str(outMsrValues[1]))

Generic example in 3d case :

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, "ImageRatioMsr");
// compute measure on shape 2d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis2d(pInGreyImg2d, pShape2dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pImageRatioOutMsr = pOutMeasureSet->getMeasure("ImageRatioMsr");
const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>& outResults = static_cast<const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>&>(pImageRatioOutMsr->getMeasureResult());