colorspacious

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

https://github.com/njsmith/colorspacious

Science Score: 33.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 1 DOI reference(s) in README
  • Academic publication links
    Links to: science.org, zenodo.org
  • Committers with academic emails
    4 of 9 committers (44.4%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.3%) to scientific vocabulary

Keywords

color color-blindness colour colour-blindness python

Keywords from Contributors

closember gtk qt tk wx astronomy astropy
Last synced: 6 months ago · JSON representation

Repository

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

Basic Info
  • Host: GitHub
  • Owner: njsmith
  • License: mit
  • Language: Python
  • Default Branch: master
  • Size: 1.09 MB
Statistics
  • Stars: 179
  • Watchers: 11
  • Forks: 19
  • Open Issues: 20
  • Releases: 0
Topics
color color-blindness colour colour-blindness python
Created over 10 years ago · Last pushed over 6 years ago
Metadata Files
Readme License

README.rst

colorspacious
=============

.. image:: https://travis-ci.org/njsmith/colorspacious.svg?branch=master
   :target: https://travis-ci.org/njsmith/colorspacious
   :alt: Automated test status

.. image:: https://codecov.io/gh/njsmith/colorspacious/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/njsmith/colorspacious
   :alt: Test coverage

.. image:: https://readthedocs.org/projects/colorspacious/badge/?version=latest
   :target: http://colorspacious.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

.. image:: https://zenodo.org/badge/38525000.svg
   :target: https://zenodo.org/badge/latestdoi/38525000

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.python.org/pypi/colorspacious/

Code and bug tracker:
  https://github.com/njsmith/colorspacious

Contact:
  Nathaniel J. Smith 

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:

* ``colour``: http://colour-science.org/
* ``colormath``: http://python-colormath.readthedocs.org/
* ``ciecam02``: https://pypi.python.org/pypi/ciecam02/
* ``ColorPy``: http://markkness.net/colorpy/ColorPy.html

Owner

  • Name: Nathaniel J. Smith
  • Login: njsmith
  • Kind: user

GitHub Events

Total
  • Issues event: 2
  • Watch event: 8
  • Issue comment event: 1
  • Pull request event: 4
  • Fork event: 3
Last Year
  • Issues event: 2
  • Watch event: 8
  • Issue comment event: 1
  • Pull request event: 4
  • Fork event: 3

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 198
  • Total Committers: 9
  • Avg Commits per committer: 22.0
  • Development Distribution Score (DDS): 0.247
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Nathaniel J. Smith n****s@p****m 149
Futrell f****l@m****u 25
Stefan van der Walt s****v@b****u 14
Maximilian Nöthe m****e@t****e 3
Thomas Mansencal t****l@g****m 2
TFiFiE n****x@h****m 2
Edward Betts e****d@4****m 1
Christoph Gohlke c****e@u****u 1
Brien Dieterle b****d@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 27
  • Total pull requests: 10
  • Average time to close issues: about 1 month
  • Average time to close pull requests: 9 days
  • Total issue authors: 22
  • Total pull request authors: 9
  • Average comments per issue: 3.48
  • Average comments per pull request: 1.7
  • Merged pull requests: 6
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: 2 minutes
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.33
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • kloczek (2)
  • bkmgit (2)
  • TFiFiE (2)
  • maxnoe (2)
  • nschloe (2)
  • mpetroff (1)
  • sandrotosi (1)
  • JohannesBuchner (1)
  • rathann (1)
  • denis-bz (1)
  • averyfreeman (1)
  • r-barnes (1)
  • Tronic (1)
  • socketpair (1)
  • mycarta (1)
Pull Request Authors
  • bkmgit (4)
  • emollier (2)
  • joukewitteveen (1)
  • EdwardBetts (1)
  • njsmith (1)
  • KelSolaar (1)
  • briend (1)
  • maxnoe (1)
  • TFiFiE (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 4
  • Total downloads:
    • pypi 73,155 last-month
  • Total docker downloads: 2,289
  • Total dependent packages: 24
    (may contain duplicates)
  • Total dependent repositories: 276
    (may contain duplicates)
  • Total versions: 9
  • Total maintainers: 2
pypi.org: colorspacious

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

  • Versions: 6
  • Dependent Packages: 18
  • Dependent Repositories: 250
  • Downloads: 73,155 Last month
  • Docker Downloads: 2,289
Rankings
Dependent packages count: 1.0%
Dependent repos count: 1.0%
Docker downloads count: 1.4%
Downloads: 1.9%
Average: 3.3%
Stargazers count: 5.6%
Forks count: 8.7%
Maintainers (1)
njs
Last synced: 6 months ago
conda-forge.org: colorspacious
  • Versions: 1
  • Dependent Packages: 5
  • Dependent Repositories: 13
Rankings
Dependent repos count: 9.8%
Dependent packages count: 10.4%
Average: 22.1%
Stargazers count: 29.3%
Forks count: 38.8%
Last synced: 6 months ago
spack.io: py-colorspacious

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

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 15.7%
Forks count: 22.4%
Average: 23.8%
Dependent packages count: 57.3%
Maintainers (1)
Last synced: 6 months ago
anaconda.org: colorspacious

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), it also includes: 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).

  • Versions: 1
  • Dependent Packages: 1
  • Dependent Repositories: 13
Rankings
Dependent packages count: 30.7%
Dependent repos count: 35.9%
Average: 38.9%
Stargazers count: 40.7%
Forks count: 48.3%
Last synced: 6 months ago

Dependencies

doc/requirements.txt pypi
  • ipython *
  • jsonschema *
  • matplotlib *
  • mistune *
  • numpy *
  • sphinx_rtd_theme *
  • sphinxcontrib-bibtex *
setup.py pypi
  • numpy *