Image Equalization 2d

image =	equalize2dImg (inImg,inOutputRange)
image =	equalize2dImg (inImg,inHistogram,inOutputRange)
image =	equalize2dImg (inImg,inPIHistogram,inOutputRange)

Detailed Description

computes an output image associated to histogram equalization of each 2d plan of an input image

This algorithm applies, for each 2D plan of the input image, the intensities look-up table resulting from a histogram equalization computed using:

• either the histogram provided by the user for the current 2D plan, or the histogram automatically computed on the 2D plan by the algorithm
• the output range provided by the user.

See also

Equalization LUT computation for details on histograms equalization.

Here is an example of histogram equalization applied to a 8-bits grey level image with :

See also

http://en.wikipedia.org/wiki/Equalization

http://en.wikipedia.org/wiki/Histogram_equalization

Example of Python code :

Example imports

import PyIPSDK
import PyIPSDK.IPSDKIPLIntensityTransform as itrans

Code Example

    # opening of input images
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # definition of equalization range
    equalizeRange = PyIPSDK.createRange(0, 255)
    
    # equalization image computation (output image allocated by the algorithm)
    autoOutImg = itrans.equalize2dImg(inImg,  equalizeRange)

Example of C++ code :

Example informations

Header file

#include <IPSDKIPL/IPSDKIPLIntensityTransform/Processor/Equalize2dImg/Equalize2dImg.h>

Code Example

        // create a target range for operation
        RangePtr pInOutputRange(boost::make_shared<Range>());
        pInOutputRange->setValue<Range::Min>(fOutMin);
        pInOutputRange->setValue<Range::Max>(fOutMax);

        // Sample with a generated output image
        // ------------------------------------
        ImagePtr pAutoOutImg = equalize2dImg(pInImg, pInOutputRange);

        // Sample with a provided output image
        // -----------------------------------
        equalize2dImg(pInImg, pInOutputRange, pOutImg);