SurfaceProjectionX

Measure that computes the surface of the projection along the X axis. More...

Classes
class	ipsdk::imaproc::shape::analysis::SurfaceProjectionXMsr
	Measurement object for measure SurfaceProjectionX. More...
class	ipsdk::imaproc::shape::analysis::SurfaceProjectionXMsrInfo
	Information object for measure SurfaceProjectionX. More...

Detailed Description

Measure that computes the surface of the projection along the X axis.

This measure returns the surface of the projection along the X axis for each 3d shapes. The surface is computed on the YZ plane.

Here is an example of the surface projection X measurement :

Author

A. Eymar

Date

2022/02/07

Copyright

2022 Reactiv'IP, all right reserved.

Measure the surface of the projection along the X axis

Measure synthesis :

Measure Type	Measure Unit Type	Parameter Type	Result Type	Shape Requirements
Geometry 3d	None	None	Value (ipsdk::ipUInt64)	Row Intersections

See Shape measurement for additional information on these pictograms

Measure Type :

This is a geometry 3d measure

• it use shape 3d data to compute a result
• it optionally 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 SurfaceProjectionX is not associated to any unit [ipsdk::shape::analysis::eMsrUnitFormat::eMUF_NoUnit]

Measure Parameter Type :

Measure SurfaceProjectionX has no parameters

Measure Result Type :

Measure SurfaceProjectionX is associated to ipsdk::shape::analysis::ValueMeasureResult<ipsdk::ipUInt64> results

Measure Shape Requirements :

Measure SurfaceProjectionX requires row intersections from shape data

Measure Dependencies :

Measure SurfaceProjectionX has no dependency

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, "SurfaceProjectionXMsr")
    
    #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("SurfaceProjectionXMsr")
    
    # 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

    //ImagePtr pInGreyImg3d = loadTiffImageFile(inputGreyImgPath);

    //Shape3dCollPtr pShape3dColl = boost::make_shared<Shape3dColl>();
    //IPSDK_REQUIRE(readFromXmlFile(inputShape3dCollPath, *pShape3dColl) == true);

    ImageGeometryPtr pImageGeometry = geometry3d(eImageBufferType::eIBT_Label16, 100, 100, 50);
    boost::shared_ptr<MemoryImage> pImg(boost::make_shared<MemoryImage>());
    pImg->init(*pImageGeometry);
 
    FormulaInOptImages inOptImages1;
    inOptImages1._pInOptImg1 = pImg;
    ImagePtr pOutBinImg = formula3dImg("if (x>5&&x<40&&y>10&&y<30&&z>2&&z<15, True, if (x>16&&x<36&&y>40&&y<70&&z>5&&z<25, True, if (x>1&&x<51&&y>50&&y<60&&z>5&&z<25, True, if (sqrt((x-30-cx)*(x-30-cx)+(y-20-cy)*(y-20-cy)+(z-cz)*(z-cz))<=20, True, False))))", inOptImages1);

    ImagePtr pInLabelImg = connectedComponent3dImg(pOutBinImg);

    Shape3dCollPtr pShape3dColl = labelShapeExtraction3d(pInLabelImg);

    // define a measure info set
    MeasureInfoSetPtr pMeasureInfoSet = MeasureInfoSet::create3dInstance();
    createMeasureInfo(pMeasureInfoSet, "SurfaceProjectionXMsr");
    
    // compute measure on shape 3d collection
    MeasureSetPtr pOutMeasureSet = shapeAnalysis3d(pInLabelImg, pShape3dColl, pMeasureInfoSet);

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