1. Description
  2. License
  3. Requirements
  4. Installation
  5. Instructions
  6. Contact
  7. Contributing


PyColorTools is a python library that implements some utilities functions for color conversion from RGB to YCbCr (YUV) and back. This library also implements functions to join 3 independent grayscale channels to a single color image. The split function, used to separate the 3-dimension color image to 3 gray images with 1 dimension each, is also implemented.


PyColorTools is released under GNU GPL version 2.


PyColorTools was tested with Python 2.7 and Python 3.4.0, Scipy 0.10.0, Numpy 1.9.0, and Cython 0.21.1.


  1. Clone the last version

    # hg clone

  2. Go to the directory where '' os located

    cd pycolortools

  3. Install using distributils

    # sudo python install


The repository 'test' contains some examples of how to use the functions.


Please send all comments, questions, reports and suggestions (especially if you would like to contribute) to


If you would like to contribute with new algorithms, increment the code performance, documentation or another kind of modifications, please contact me. The only requirements are: keep the code compatible with PEP8 standardization and licensed by GPLv2.



[2] ITU-R, Rec. BT. 601-4. Encoding parameters of digital television for studios, 2001.

[3] ITU, ITURBT. 709-5 Parameter values for the HDTV standards for production and international programme exchange. (2002).

[4] Malvar, Henrique, and Gary Sullivan. YCoCg-R: A color space with RGB reversibility and low dynamic range. ISO/IEC JTC1/SC29/WG11 and ITU (2003).