extract values at specific coordinates from a 2d image More...

IPSDKIPLUTILITY_API attr::DoublesPtr	ipsdk::imaproc::util::extractImg2dValues (const image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::Coords2dCollConstPtr &pInCoords2dColl)
	wrapper function for extract values at specific coordinates from a 2d image More...

IPSDKIPLUTILITY_API attr::DoublesPtr	ipsdk::imaproc::util::extractImg2dValues (const image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::Coords2dCollConstPtr &pInCoords2dColl, const ipsdk::imaproc::attr::eInterpolationPolicy &inOptInterpolationPolicy)
	wrapper function for extract values at specific coordinates from a 2d image More...

IPSDKIPLUTILITY_API attr::DoublesPtr	ipsdk::imaproc::util::extractImg2dValues (const image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::Coords2dCollConstPtr &pInCoords2dColl, const ipsdk::imaproc::attr::eInterpolationPolicy &inOptInterpolationPolicy, const ipsdk::imaproc::attr::ImageValueExtractionMethodPtr &pInOptImageValueExtractionMethod)
	wrapper function for extract values at specific coordinates from a 2d image More...

IPSDKIPLUTILITY_API attr::PlanIndexedDoublesPtr	ipsdk::imaproc::util::multiSlice_extractImg2dValues (const image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::PlanIndexedCoords2dCollConstPtr &pInPICoords2dColl)
	wrapper function for extract values at specific coordinates from a 2d image More...

IPSDKIPLUTILITY_API attr::PlanIndexedDoublesPtr	ipsdk::imaproc::util::multiSlice_extractImg2dValues (const image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::PlanIndexedCoords2dCollConstPtr &pInPICoords2dColl, const ipsdk::imaproc::attr::eInterpolationPolicy &inOptInterpolationPolicy)
	wrapper function for extract values at specific coordinates from a 2d image More...

IPSDKIPLUTILITY_API attr::PlanIndexedDoublesPtr	ipsdk::imaproc::util::multiSlice_extractImg2dValues (const image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::PlanIndexedCoords2dCollConstPtr &pInPICoords2dColl, const ipsdk::imaproc::attr::eInterpolationPolicy &inOptInterpolationPolicy, const ipsdk::imaproc::attr::ImageValueExtractionMethodPtr &pInOptImageValueExtractionMethod)
	wrapper function for extract values at specific coordinates from a 2d image More...

Detailed Description

extract values at specific coordinates from a 2d image

This algorithm allows to extract grey level values from an input 2d image.

If input image is a multi plane image (ie. 3d, sequence or color image), each plane is processed separatly.

Given a collection of input 2d coordinates $InPICoords2dColl$ , algorithm extracts an associated collection of grey level values $OutPIImgGreyValues$ from input image $InImg$ . User can specify an optional interpolation policy $InOptInterpolationPolicy$ (see enumerate ipsdk::imaproc::attr::eInterpolationPolicy) used to extract values from image.

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InPICoords2dColl	[Input] plan indexed collection of cartesian 2d coordinates	X
ipsdk::imaproc::attr::InOptInterpolationPolicy	[Input Optional] interpolation policy used to extract local data from image	X
ipsdk::imaproc::attr::InOptImageValueExtractionMethod	[Input Optional] object allowing to define used image values extraction method	X
ipsdk::imaproc::attr::OutPIImgGreyValues	[Output] plan indexed collection of grey level values extracted from an image	ipsdk::imaproc::fromImage (_pOutPIImgGreyValues, _pInImg)

Global Rule description

Global rule description for algorithm :
ipsdk::imaproc::matchImagePlans (_pInPICoords2dColl,_pInImg) &&
ipsdk::imaproc::matchImagePlans (_pOutPIImgGreyValues,_pInImg)

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLUtility as util

Code Example

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # create a coordinates collection
    inCoordsColl = PyIPSDK.createCoords2dColl()
    inCoordsColl.addCoords(100.3, 100.2)
    inCoordsColl.addCoords(200.4, 150.1)
    inCoordsColl.addCoords(300.7, 200.3)
    
    # retrieve associated grey values into image with default interpolation policy
    outGreyValues1 = util.extractImg2dValues(inImg, inCoordsColl)
    for i in range(0, len(inCoordsColl.coll)):
        print("Grey value at {" + str(inCoordsColl.coll[i].x) + ", " +
                                  str(inCoordsColl.coll[i].y) + "} = " +
                                  str(outGreyValues1.coll[i]))
                                  
    # retrieve associated grey values into image with cubic interpolation policy
    outGreyValues2 = util.extractImg2dValues(inImg, inCoordsColl, PyIPSDK.eInterpolationPolicy.eIP_Cubic)
    for i in range(0, len(inCoordsColl.coll)):
        print("Grey value at {" + str(inCoordsColl.coll[i].x) + ", " +
                                  str(inCoordsColl.coll[i].y) + "} = " +
                                  str(outGreyValues2.coll[i]))

Example of C++ code :

Example informations

Associated library

IPSDKIPLUtility

Header file

#include <IPSDKIPL/IPSDKIPLUtility/Processor/ExtractImg2dValues/ExtractImg2dValues.h>

Code Example

    // Load the input image
    ImagePtr pInImg = loadTiffImageFile(inImgFilePath);
    // definition of a coordinates collection
    Coords2dCollPtr pInCoordsColl(boost::make_shared<Coords2dColl>());
    pInCoordsColl->addCoords(100.3, 100.2);
    pInCoordsColl->addCoords(200.4, 150.1);
    pInCoordsColl->addCoords(300.7, 200.3);
    // retrieve associated grey values into image with default interpolation policy
    DoublesPtr outGreyValues1 = extractImg2dValues(pInImg, pInCoordsColl);
    // retrieve associated grey values into image with cubic interpolation policy
    DoublesPtr outGreyValues2 = extractImg2dValues(pInImg, pInCoordsColl, eInterpolationPolicy::eIP_Cubic);

See also: ExtractImg2dValuesLvl1; ExtractImg2dValuesLvl2

Function Documentation

◆ extractImg2dValues() [1/3]

IPSDKIPLUTILITY_API attr::DoublesPtr ipsdk::imaproc::util::extractImg2dValues	(	const image::ImageConstPtr &	pInImg,
		const ipsdk::imaproc::attr::Coords2dCollConstPtr &	pInCoords2dColl
	)

wrapper function for extract values at specific coordinates from a 2d image

Note: These wrappers must be used with mono slice (sizeZ=sizeC=sizeT=1) input images

Exceptions