| 1 |
Metadata-Version: 1.1 |
| 2 |
Name: colorspacious |
| 3 |
Version: 1.1.2 |
| 4 |
Summary: A powerful, accurate, and easy-to-use Python library for doing colorspace conversions |
| 5 |
Home-page: https://github.com/njsmith/colorspacious |
| 6 |
Author: Nathaniel J. Smith |
| 7 |
Author-email: [email protected] |
| 8 |
License: MIT |
| 9 |
Description: colorspacious |
| 10 |
============= |
| 11 |
|
| 12 |
.. image:: https://travis-ci.org/njsmith/colorspacious.svg?branch=master |
| 13 |
:target: https://travis-ci.org/njsmith/colorspacious |
| 14 |
:alt: Automated test status |
| 15 |
|
| 16 |
.. image:: https://codecov.io/gh/njsmith/colorspacious/branch/master/graph/badge.svg |
| 17 |
:target: https://codecov.io/gh/njsmith/colorspacious |
| 18 |
:alt: Test coverage |
| 19 |
|
| 20 |
.. image:: https://readthedocs.org/projects/colorspacious/badge/?version=latest |
| 21 |
:target: http://colorspacious.readthedocs.io/en/latest/?badge=latest |
| 22 |
:alt: Documentation Status |
| 23 |
|
| 24 |
.. image:: https://zenodo.org/badge/38525000.svg |
| 25 |
:target: https://zenodo.org/badge/latestdoi/38525000 |
| 26 |
|
| 27 |
Colorspacious is a powerful, accurate, and easy-to-use library for |
| 28 |
performing colorspace conversions. |
| 29 |
|
| 30 |
In addition to the most common standard colorspaces (sRGB, XYZ, xyY, |
| 31 |
CIELab, CIELCh), we also include: color vision deficiency ("color |
| 32 |
blindness") simulations using the approach of Machado et al (2009); a |
| 33 |
complete implementation of `CIECAM02 |
| 34 |
<https://en.wikipedia.org/wiki/CIECAM02>`_; and the perceptually |
| 35 |
uniform CAM02-UCS / CAM02-LCD / CAM02-SCD spaces proposed by Luo et al |
| 36 |
(2006). |
| 37 |
|
| 38 |
To get started, simply write:: |
| 39 |
|
| 40 |
from colorspacious import cspace_convert |
| 41 |
|
| 42 |
Jp, ap, bp = cspace_convert([64, 128, 255], "sRGB255", "CAM02-UCS") |
| 43 |
|
| 44 |
This converts an sRGB value (represented as integers between 0-255) to |
| 45 |
CAM02-UCS `J'a'b'` coordinates (assuming standard sRGB viewing |
| 46 |
conditions by default). This requires passing through 4 intermediate |
| 47 |
colorspaces; ``cspace_convert`` automatically finds the optimal route |
| 48 |
and applies all conversions in sequence: |
| 49 |
|
| 50 |
This function also of course accepts arbitrary NumPy arrays, so |
| 51 |
converting a whole image is just as easy as converting a single value. |
| 52 |
|
| 53 |
Documentation: |
| 54 |
http://colorspacious.readthedocs.org/ |
| 55 |
|
| 56 |
Installation: |
| 57 |
``pip install colorspacious`` |
| 58 |
|
| 59 |
Downloads: |
| 60 |
https://pypi.python.org/pypi/colorspacious/ |
| 61 |
|
| 62 |
Code and bug tracker: |
| 63 |
https://github.com/njsmith/colorspacious |
| 64 |
|
| 65 |
Contact: |
| 66 |
Nathaniel J. Smith <[email protected]> |
| 67 |
|
| 68 |
Dependencies: |
| 69 |
* Python 2.6+, or 3.3+ |
| 70 |
* NumPy |
| 71 |
|
| 72 |
Developer dependencies (only needed for hacking on source): |
| 73 |
* nose: needed to run tests |
| 74 |
|
| 75 |
License: |
| 76 |
MIT, see LICENSE.txt for details. |
| 77 |
|
| 78 |
References for algorithms we implement: |
| 79 |
* Luo, M. R., Cui, G., & Li, C. (2006). Uniform colour spaces based on |
| 80 |
CIECAM02 colour appearance model. Color Research & Application, 31(4), |
| 81 |
320–330. doi:10.1002/col.20227 |
| 82 |
* Machado, G. M., Oliveira, M. M., & Fernandes, L. A. (2009). A |
| 83 |
physiologically-based model for simulation of color vision |
| 84 |
deficiency. Visualization and Computer Graphics, IEEE Transactions on, |
| 85 |
15(6), 1291–1298. http://www.inf.ufrgs.br/~oliveira/pubs_files/CVD_Simulation/CVD_Simulation.html |
| 86 |
|
| 87 |
Other Python packages with similar functionality that you might want |
| 88 |
to check out as well or instead: |
| 89 |
|
| 90 |
* ``colour``: http://colour-science.org/ |
| 91 |
* ``colormath``: http://python-colormath.readthedocs.org/ |
| 92 |
* ``ciecam02``: https://pypi.python.org/pypi/ciecam02/ |
| 93 |
* ``ColorPy``: http://markkness.net/colorpy/ColorPy.html |
| 94 |
|
| 95 |
Platform: UNKNOWN |
| 96 |
Classifier: Development Status :: 4 - Beta |
| 97 |
Classifier: Intended Audience :: Developers |
| 98 |
Classifier: Intended Audience :: Science/Research |
| 99 |
Classifier: License :: OSI Approved :: MIT License |
| 100 |
Classifier: Programming Language :: Python :: 2 |
| 101 |
Classifier: Programming Language :: Python :: 3 |