README

colorcorrect
by Shunsuke Aihara - http://argmax.jp

date::

    February 2012

description::

    Imprement some of color correction algorithms

require::

    python2.6 or later
    numpy
    Pillow

install::

    % python setup.py build
    % python setup.py install

impement algorithms::

    gray world
         colorcorrect.algorithm.gray_world
         usage: image
    max white
        colorcorrect.algorithm.max_white
        usage: image
    stretch
        colorcorrect.algorithm.stretch
        usage: image
    retinex
        colorcorrect.algorithm.retinex
        usage: image
    retinex with adjust
            colorcorrect.algorithm.retinex_with_adjust
            usage: image
    standard deviation weighted grey world
             colorcorrect.algorithm.standard_deviation_weighted_grey_world
             usage: image,subblock width(default:20), subblock height(default:20)
    standard deviation and luminance weighted gray world
             colorcorrect.algorithm.standard_deviation_and_luminance_weighted_gray_world
             usage: image,subblock width(default:20), subblock height(default:20)
    luminance weighted gray world
              colorcorrect.algorithm.luminance_weighted_gray_world
             usage: image,subblock width(default:20), subblock height(default:20)
    automatic color equalization
              colorcorrect.algorithm.automatic_color_equalization
              usage: image,slope(default:10),limit(default:1000)

sample usage::

    >>> import Image
    >>> import colorcorrect.algorithm as cca
    >>> from colorcorrect.util import from_pil, to_pil
    >>> img = Image.open('/path/to/image')
    >>> to_pil(cca.stretch(from_pil(img))).show()

References::

    Denis. Nikitenko, M. Wirth and K. Trudel, "Applicability Of White-Balancing Algorithms to Restoring Faded Colour Slides: An Empirical Evaluation.", Journal of Multimedia, vol. 3, no. 5, 2008.
    HK. Lam, OC. Au and CW. Wong, "Automatic white balancing using luminance component and standard deviation of RGB components", in Proc. ICASSP, 2004.
    A. Rizzi, C. Gatta and D. Marini, "A new algorithm for unsupervised global and local color correction.", Pattern Recognition Letters, vol. 24, no. 11, 2003.