OBBCenterZ

Measure allowing to compute the position of the centroid of the minimal oriented bounding box along the z axis. More...

Classes
class	ipsdk::imaproc::shape::analysis::OBBCenterZMsr
	Measurement object for measure OBBCenterZ. More...
class	ipsdk::imaproc::shape::analysis::OBBCenterZMsrInfo
	Information object for measure OBBCenterZ. More...
class	ipsdk::imaproc::shape::analysis::OBBCenterZMsrParams
	Parameter object for measure OBBCenterZ. More...

Functions
IPSDKIPLSHAPEANALYSIS_API OBBCenterZMsrParamsPtr	ipsdk::imaproc::shape::analysis::createOBBCenterZMsrParams (ipUInt32 nbOrientations=36)
	function allowing to create a new parameter object for OBBCenterZ measure

Detailed Description

Measure allowing to compute the position of the centroid of the minimal oriented bounding box along the z axis.

This measure computes the position along the z axis of the centroid of the oriented minimal bounding box for each shape.

In the case of 2d images, the center's coordinate along the z-axis is set to 0.

Here is an example of z center 2d measurement :

See OrientedBoundingBox3d
for more details about the oriented bounding box calculation.

Author

R. Abbal

Date

2015/07/24

Copyright

2015 Reactiv'IP, all right reserved.

Measure allowing to compute the position of the centroid of the minimal oriented bounding box along the z axis

Measure synthesis :

Measure Type	Measure Unit Type	Parameter Type	Result Type	Shape Requirements
Generic	Length	OBBCenterZMsrParams	Value (ipsdk::ipReal64)	Both

See Shape measurement for additional information on these pictograms

Measure Type :

This is a generic measure

• it does not directly use shape or image data
• it can use dependencies to other measures to compute a result (see Measure Dependencies section)

This measure can only be used in 3d case

Measure Unit Type:

Measure OBBCenterZ is associated to a length measurement unit [ipsdk::shape::analysis::eMsrUnitFormat::eMUF_LengthUnit]

Measure Parameter Type :

Measure OBBCenterZ is associated to OBBCenterZMsrParams parameters

Measure Result Type :

Measure OBBCenterZ is associated to ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64> results

Measure Shape Requirements :

Measure OBBCenterZ requires row intersections and boundary approximation from shape data

Measure Dependencies :

Measure OBBCenterZ depends on following measures :

Measure Mode	Measure Name	Measure Type	Measure Parameters
eMVP_3d	OrientedBoundingBox	OrientedBoundingBox3d	createOrientedBoundingBox3dMsrParams(_pMsrParams->getValue<OBBCenterZMsrParams::NbOrientations>())

Note

See Shape Analysis 3d for more information on general shape 3d analysis and measurement usage.

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, "OBBCenterZMsr")
    
    #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("OBBCenterZMsr")
    
    # 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, "OBBCenterZMsr", createOBBCenterZMsrParams(1));
    
    // compute measure on shape 3d collection
    MeasureSetPtr pOutMeasureSet = shapeAnalysis3d(pInGreyImg3d, pShape3dColl, pMeasureInfoSet);

    // retrieve associated results
    const MeasureConstPtr& pOBBCenterZOutMsr = pOutMeasureSet->getMeasure("OBBCenterZMsr");
    const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>& outResults = static_cast<const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>&>(pOBBCenterZOutMsr->getMeasureResult());