IPSDK  4_1_0_2
IPSDK : Image Processing Software Development Kit
Classes

Measure allowing to compute the y-coordinate of the barycenter ponderated by the gray level of each pixel for shape. More...

Classes

class  ipsdk::imaproc::shape::analysis::GreyBarycenterYMsr
 Measurement object for measure GreyBarycenterY. More...
 
class  ipsdk::imaproc::shape::analysis::GreyBarycenterYMsrInfo
 Information object for measure GreyBarycenterY. More...
 

Detailed Description

Measure allowing to compute the y-coordinate of the barycenter ponderated by the gray level of each pixel for shape.

The coordinates $ \left[ x_b, y_b \right]^T $ of the grey barycenter for a given 2d or 3d shape are computed as follows :

\[ \left\lbrace \begin{array}{ccc} x_b & = & \frac{1}{nbElt} \left( \sum_{\left\{x, y, z\right\} \in Shape}{Shape(x, y, z) \times x} \right)\\ y_b & = & \frac{1}{nbElt} \left( \sum_{\left\{x, y, z\right\} \in Shape}{Shape(x, y, z) \times y} \right)\\ z_b & = & \frac{1}{nbElt} \left( \sum_{\left\{x, y, z\right\} \in Shape}{Shape(x, y, z) \times z} \right) \end{array} \right. \]

Where $ Shape $ is the set of pixels in the shape and $ nbElt $ is the number of elements (i.e. pixels in 2d case or voxels in 3d case) of the shape.

Here is an example of 2d grey y-barycenter measurement :

greyBarycenterYMsr.png
Author
H. Delestre
Date
2016/10/05

Measure allowing to compute the y-coordinate of the barycenter ponderated by the gray level of each pixel for shape

Measure synthesis :

Measure Type Measure Unit Type Parameter Type Result Type Shape Requirements
Generic.png
Generic
length.png
Length
none.png
None
Value.png
Value (ipsdk::ipReal64)
RowIntersections.png
Row Intersections
See Shape measurement for additional information on these pictograms

Measure Type :

This is a generic measure

This measure can be used in 2d and 3d case

Measure Unit Type:

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

Measure Parameter Type :

Measure GreyBarycenterY has no parameters

Measure Result Type :

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

Measure Shape Requirements :

Measure GreyBarycenterY requires row intersections from shape data

Measure Dependencies :

Measure GreyBarycenterY depends on following measures :

Measure Mode Measure Name Measure Type Measure Parameters
eMVP_2d3d GreyBarycenter GreyBarycenter
Note
See Shape Analysis 2d for more information on general shape 2d analysis and measurement usage.
See Shape Analysis 3d for more information on general shape 3d analysis and measurement usage.

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, "GreyBarycenterYMsr")
#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("GreyBarycenterYMsr")
# retrieve measure values
outMsrValues = outMsr.getMeasureResult().getColl(0)
print("First label measurement equal " + str(outMsrValues[1]))

Generic example in 3d case :

import PyIPSDK
import PyIPSDK.IPSDKIPLShapeAnalysis as shapeanalysis
# Create the infoset
inMeasureInfoSet3d = PyIPSDK.createMeasureInfoSet3d()
PyIPSDK.createMeasureInfo(inMeasureInfoSet3d, "GreyBarycenterYMsr")
#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("GreyBarycenterYMsr")
# 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>();
IPSDK_REQUIRE(readFromXmlFile(inputShape2dCollPath, *pShape2dColl) == true);
// define a measure info set
MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create2dInstance();
createMeasureInfo(pMeasureInfoSet, "GreyBarycenterYMsr");
// compute measure on shape 2d collection
MeasureSetPtr pOutMeasureSet = shapeAnalysis2d(pInGreyImg2d, pShape2dColl, pMeasureInfoSet);
// retrieve associated results
const MeasureConstPtr& pGreyBarycenterYOutMsr = pOutMeasureSet->getMeasure("GreyBarycenterYMsr");
const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>& outResults = static_cast<const ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipReal64>&>(pGreyBarycenterYOutMsr->getMeasureResult());