python-colormath — python-colormath 3.0.0 documentation (original) (raw)

python-colormath

python-colormath is a simple Python module that spares the user from directly dealing withcolor math. Some features include:

• Support for a wide range of color spaces. A good chunk of the CIE spaces, RGB, HSL/HSV, CMY/CMYK, and many more.
• Conversions between the various color spaces. For example, XYZ to sRGB, Spectral to XYZ, CIE Lab to Adobe RGB.
• Calculation of color difference. All CIE Delta E functions, plus CMC.
• Chromatic adaptations (changing illuminants).
• RGB to hex and vice-versa.
• 16-bit RGB support.
• Runs on Python 2.7 and Python 3.3+.

License: python-colormath is licensed under the BSD License.

Assorted Info¶

• Issue tracker - Report bugs, ask questions, and share ideas here.
• GitHub project - Source code and issue tracking.
• @gctaylor Twitter - Tweets from the maintainer.
• Greg Taylor’s blog - Occasional posts about color math and software development.

Topics¶

• Installation

• Color Objects

  • SpectralColor
  • LabColor
  • LCHabColor
  • LCHuvColor
  • LuvColor
  • XYZColor
  • xyYColor
  • sRGBColor
  • BT2020Color
  • AdobeRGBColor
  • HSLColor
  • HSVColor
  • CMYColor
  • CMYKColor
  • IPTColor

• Observers and Illuminants

  • Two-degree observer angle
  • Ten-degree observer angle

• Color Conversions

  • Example
  • RGB conversions and native illuminants
  • RGB conversions and out-of-gamut coordinates

• Delta E Equations

  • Example
  • Delta E CIE 1976
  • Delta E CIE 1994
  • Delta E CIE 2000
  • Delta E CMC

• ANSI and ISO Density

  • Example
  • Valid Density Constants

• Color Appearance Models

  • Example
  • Nayatani95 et al. Model
  • Hunt Model
  • RLAB Model
  • ATD95 Model
  • LLAB Model
  • CIECAM02 Model
  • CIECAM02-m1 Model

• Release Notes

Useful color math resources¶

• Bruce Lindbloom - Lots of formulas, calculators, and standards.
• John the Math Guy - Useful tutorials and explanations of color theory.