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

2d Oriented bounding box fitting a shape

This measure uses FeretDiameter2d to compute the oriented minimum bounding box for each shape.

The Feret diameters are calculated for a given angle $ \alpha $ and $ \alpha + \pi/2 $. The corners coordinates of the bounding box are then computed and the resulting oriented bounding box is selected so that its area is minimal.

Here is an example of oriented bounding box measurement, the oriented bounding boxes are displayed with dashed lines :

orientedBoundingBoxMsr_illustration.png

2d Oriented bounding box fitting a shape

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Generic.png
Generic
none.png
None
parameter.png
OrientedBoundingBox2dMsrParams
Custom.png
Custom
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, "OrientedBoundingBox2dMsr")
#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("OrientedBoundingBox2dMsr")
# 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, "OrientedBoundingBox2dMsr", createOrientedBoundingBox2dMsrParams(36));
// compute measure on shape 2d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis2d(pInGreyImg2d, pShape2dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pOrientedBoundingBox2dOutMsr = pOutMeasureSet->getMeasure("OrientedBoundingBox2dMsr");
const OrientedBoundingBox2dMsrResults& outResults = static_cast<const OrientedBoundingBox2dMsrResults&>(pOrientedBoundingBox2dOutMsr->getMeasureResult());