Skip to main content

A powerful, accurate, and easy-to-use Python library for doing colorspace conversions

Project description

Automated test status Test coverage Documentation Status https://zenodo.org/badge/38525000.svg

Colorspacious is a powerful, accurate, and easy-to-use library for performing colorspace conversions.

In addition to the most common standard colorspaces (sRGB, XYZ, xyY, CIELab, CIELCh), we also include: color vision deficiency (“color blindness”) simulations using the approach of Machado et al (2009); a complete implementation of CIECAM02; and the perceptually uniform CAM02-UCS / CAM02-LCD / CAM02-SCD spaces proposed by Luo et al (2006).

To get started, simply write:

from colorspacious import cspace_convert

Jp, ap, bp = cspace_convert([64, 128, 255], "sRGB255", "CAM02-UCS")

This converts an sRGB value (represented as integers between 0-255) to CAM02-UCS J’a’b’ coordinates (assuming standard sRGB viewing conditions by default). This requires passing through 4 intermediate colorspaces; cspace_convert automatically finds the optimal route and applies all conversions in sequence:

This function also of course accepts arbitrary NumPy arrays, so converting a whole image is just as easy as converting a single value.

Documentation:

http://colorspacious.readthedocs.org/

Installation:

pip install colorspacious

Downloads:

https://pypi-hypernode.com/pypi/colorspacious/

Code and bug tracker:

https://github.com/njsmith/colorspacious

Contact:

Nathaniel J. Smith <njs@pobox.com>

Dependencies:
  • Python 2.6+, or 3.3+

  • NumPy

Developer dependencies (only needed for hacking on source):
  • nose: needed to run tests

License:

MIT, see LICENSE.txt for details.

References for algorithms we implement:
  • Luo, M. R., Cui, G., & Li, C. (2006). Uniform colour spaces based on CIECAM02 colour appearance model. Color Research & Application, 31(4), 320–330. doi:10.1002/col.20227

  • Machado, G. M., Oliveira, M. M., & Fernandes, L. A. (2009). A physiologically-based model for simulation of color vision deficiency. Visualization and Computer Graphics, IEEE Transactions on, 15(6), 1291–1298. http://www.inf.ufrgs.br/~oliveira/pubs_files/CVD_Simulation/CVD_Simulation.html

Other Python packages with similar functionality that you might want to check out as well or instead:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

colorspacious-1.1.2.tar.gz (688.6 kB view details)

Uploaded Source

Built Distribution

colorspacious-1.1.2-py2.py3-none-any.whl (37.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file colorspacious-1.1.2.tar.gz.

File metadata

File hashes

Hashes for colorspacious-1.1.2.tar.gz
Algorithm Hash digest
SHA256 5e9072e8cdca889dac445c35c9362a22ccf758e97b00b79ff0d5a7ba3e11b618
MD5 2f457686bd0afb8b0816b68cd903b8f9
BLAKE2b-256 75e4aa41ae14c5c061205715006c8834496d86ec7500f1edda5981f0f0190cc6

See more details on using hashes here.

File details

Details for the file colorspacious-1.1.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for colorspacious-1.1.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c78befa603cea5dccb332464e7dd29e96469eebf6cd5133029153d1e69e3fd6f
MD5 950cb853f03016cc311fa5f5d4e7447a
BLAKE2b-256 aba1318b9aeca7b9856410ededa4f52d6f82174d1a41e64bdd70d951e532675a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page