image =	equalize3dImg (inImg,inOutputRange)
image =	equalize3dImg (inImg,inHistogram,inOutputRange)
image =	equalize3dImg (inImg,inHistogram,inOutputRange)

Detailed Description

computes an output image associated to histogram equalization of an input image

This algorithm applies, for each 3D volume 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 3D volume, or the histogram automatically computed on the 3D volume by the algorithm
the output range provided by the user.

See also: Equalization LUT computation for details on histograms equalization.; 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.2, 252)
    
    # equalization image computation (output image allocated by the algorithm)
    autoOutImg = itrans.equalize3dImg(inImg,  equalizeRange)

Example of C++ code :

Example informations

Header file

#include <IPSDKIPL/IPSDKIPLIntensityTransform/Processor/Equalize3dImg/Equalize3dImg.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 = equalize3dImg(pInImg, pInOutputRange);
        // Sample with a provided output image
        // -----------------------------------
        equalize3dImg(pInImg, pInOutputRange, pOutImg);