<img src="https://raw.githubusercontent.com/retostauffer/python-colorspace/main/_quarto/logo-wide.png" width="350" alt="python-colorspace"/>
## A Python toolbox for manipulating and assessing colors and palettes
[![Documentation](https://github.com/retostauffer/python-colorspace/actions/workflows/quartodoc.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/quartodoc.yml)
[![Examples](https://github.com/retostauffer/python-colorspace/actions/workflows/quartoexamples.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/quartoexamples.yml)
[![Testing](https://github.com/retostauffer/python-colorspace/actions/workflows/pytest.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/pytest.yml)
[![Coverage](https://github.com/retostauffer/python-colorspace/actions/workflows/coverage.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/coverage.yml)
[![](https://retostauffer.github.io/python-colorspace/coverage.svg)](https://retostauffer.github.io/python-colorspace/coverage/)
[![status](https://joss.theoj.org/papers/94041eecfa4b186c7c07252875817578/status.svg)](https://joss.theoj.org/papers/94041eecfa4b186c7c07252875817578)
The package provides a Python 3 version of the
[R colorspace](http://colorspace.R-Forge.R-project.org/) package comprising:
- **Color spaces:** Conversions and manipulations of RGB, HSV, CIEXYZ, CIELAB, CIELUV, HCL etc.
- **HCL-based palettes:** Qualitative, sequential, and diverging color maps constructed
using the HCL (hue-chroma-luminance) color model. These can closely approximate palettes
from ColorBrewer.org, CARTO, viridis, or Crameri's scientific color maps.
- **matplotlib color maps:** Integration with [matplotlib](https://matplotlib.org/) for
use in standard plotting functions.
- **Palette visualization:** Plotting palettes in color swatches, spectrums of HCL and/or
RGB trajectories, and illustrations of typical data visualizations.
- **Interactive palette chooser:** App for exploring, modifying, and picking color
palettes interactively.
- **Color vision deficiency:** Emulation of different kinds of color blindness.
- **Utilities:** Various color manipulations including tools to desaturate, lighten, darken,
adjust the transparency, or compute the contrast ratio.
## Links
- **PyPI:** <https://pypi.org/project/colorspace/>
- **GitHub:** <https://github.com/retostauffer/python-colorspace/>
- **Documentation:** <https://retostauffer.github.io/python-colorspace/>
- **Bug reports:** <https://github.com/retostauffer/python-colorspace/issues>
_Bug reports and suggestions are welcome and very much appreciated!_
## Contributors
- [Reto Stauffer](https://retostauffer.org/) (_principal author & maintainer_), Universität Innsbruck, Austria
- [Achim Zeileis](https://www.zeileis.org/), Universität Innsbruck, Austria
We would like to thank the following individuals for their contributions to the
review process for this software, as part of the submission to
[The Journal of Open Source Software](https://joss.theoj.org/) (JOSS):
[Julia Romanowska @jromanowska, Editor](https://github.com/jromanowska),
[Daniel S. Katz @danielskatz, Editor](https://github.com/danielskatz),
[Andrew Ting @hollowscene, Reviewer](https://github.com/hollowscene), and
[David Reagan @dmreagan, Reviewer](https://github.com/dmreagan).
Furthermore, the Python package implements the functionality from the R package
that is co-written with
[Ross Ihaka](https://www.stat.auckland.ac.nz/~ihaka/),
[Paul Murrell](https://www.stat.auckland.ac.nz/~paul/),
[Kurt Hornik](https://statmath.wu.ac.at/~hornik/),
[Jason C. Fisher](https://www.usgs.gov/staff-profiles/jason-c-fisher),
[Claus O. Wilke](https://clauswilke.com/),
[Claire D. McWhite](https://clairemcwhite.github.io/).
## Development notes
### Community guidelines
If you encountery any bugs or issues, or are interested in contributing
to Python _colorspace_, please have a look at our
[Community guidelines](https://retostauffer.github.io/python-colorspace/community.html).
### Test and development
More detailed information on how to run automated tests, create coverage reports,
test examples and render the documentation can be found on our
[Installation](https://retostauffer.github.io/python-colorspace/installation.html#test-and-development) page.
### GitHub Action integration (CI)
Additional notes about development and deployment are documented in
[GITHUBACTIONS.md](https://github.com/retostauffer/python-colorspace/blob/main/GITHUBACTIONS.md).
Raw data
{
"_id": null,
"home_page": "https://github.com/retostauffer/python-colorspace",
"name": "colorspace",
"maintainer": "Reto Stauffer",
"docs_url": null,
"requires_python": null,
"maintainer_email": "reto.stauffer@uibk.ac.at",
"keywords": "colors, color palettes, color spaces, manipulate colors, HCL, HCL colors, color vision deficiencies",
"author": "Reto Stauffer, Achim Zeileis",
"author_email": "Reto.Stauffer@uibk.ac.at, Achim.Zeileis@uibk.ac.at",
"download_url": "https://files.pythonhosted.org/packages/8b/d8/eeecfd2370f71964ee594603c83fe40861e604eeefcf30e8563e6cc597d8/colorspace-1.0.0.tar.gz",
"platform": null,
"description": "<img src=\"https://raw.githubusercontent.com/retostauffer/python-colorspace/main/_quarto/logo-wide.png\" width=\"350\" alt=\"python-colorspace\"/>\n\n## A Python toolbox for manipulating and assessing colors and palettes\n\n[![Documentation](https://github.com/retostauffer/python-colorspace/actions/workflows/quartodoc.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/quartodoc.yml)\n[![Examples](https://github.com/retostauffer/python-colorspace/actions/workflows/quartoexamples.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/quartoexamples.yml)\n[![Testing](https://github.com/retostauffer/python-colorspace/actions/workflows/pytest.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/pytest.yml)\n[![Coverage](https://github.com/retostauffer/python-colorspace/actions/workflows/coverage.yml/badge.svg?branch=main)](https://github.com/retostauffer/python-colorspace/actions/workflows/coverage.yml)\n[![](https://retostauffer.github.io/python-colorspace/coverage.svg)](https://retostauffer.github.io/python-colorspace/coverage/)\n[![status](https://joss.theoj.org/papers/94041eecfa4b186c7c07252875817578/status.svg)](https://joss.theoj.org/papers/94041eecfa4b186c7c07252875817578)\n\nThe package provides a Python 3 version of the\n[R colorspace](http://colorspace.R-Forge.R-project.org/) package comprising:\n\n- **Color spaces:** Conversions and manipulations of RGB, HSV, CIEXYZ, CIELAB, CIELUV, HCL etc.\n- **HCL-based palettes:** Qualitative, sequential, and diverging color maps constructed\n using the HCL (hue-chroma-luminance) color model. These can closely approximate palettes\n from ColorBrewer.org, CARTO, viridis, or Crameri's scientific color maps.\n- **matplotlib color maps:** Integration with [matplotlib](https://matplotlib.org/) for\n use in standard plotting functions.\n- **Palette visualization:** Plotting palettes in color swatches, spectrums of HCL and/or\n RGB trajectories, and illustrations of typical data visualizations.\n- **Interactive palette chooser:** App for exploring, modifying, and picking color\n palettes interactively.\n- **Color vision deficiency:** Emulation of different kinds of color blindness.\n- **Utilities:** Various color manipulations including tools to desaturate, lighten, darken,\n adjust the transparency, or compute the contrast ratio.\n\n\n## Links\n\n- **PyPI:** <https://pypi.org/project/colorspace/>\n- **GitHub:** <https://github.com/retostauffer/python-colorspace/>\n- **Documentation:** <https://retostauffer.github.io/python-colorspace/>\n- **Bug reports:** <https://github.com/retostauffer/python-colorspace/issues>\n _Bug reports and suggestions are welcome and very much appreciated!_\n\n\n## Contributors\n\n- [Reto Stauffer](https://retostauffer.org/) (_principal author & maintainer_), Universit\u00e4t Innsbruck, Austria\n- [Achim Zeileis](https://www.zeileis.org/), Universit\u00e4t Innsbruck, Austria\n\nWe would like to thank the following individuals for their contributions to the\nreview process for this software, as part of the submission to\n[The Journal of Open Source Software](https://joss.theoj.org/) (JOSS):\n[Julia Romanowska @jromanowska, Editor](https://github.com/jromanowska),\n[Daniel S. Katz @danielskatz, Editor](https://github.com/danielskatz),\n[Andrew Ting @hollowscene, Reviewer](https://github.com/hollowscene), and\n[David Reagan @dmreagan, Reviewer](https://github.com/dmreagan).\n\nFurthermore, the Python package implements the functionality from the R package\nthat is co-written with\n[Ross Ihaka](https://www.stat.auckland.ac.nz/~ihaka/),\n[Paul Murrell](https://www.stat.auckland.ac.nz/~paul/),\n[Kurt Hornik](https://statmath.wu.ac.at/~hornik/),\n[Jason C. Fisher](https://www.usgs.gov/staff-profiles/jason-c-fisher),\n[Claus O. Wilke](https://clauswilke.com/),\n[Claire D. McWhite](https://clairemcwhite.github.io/).\n\n\n## Development notes\n\n### Community guidelines\n\nIf you encountery any bugs or issues, or are interested in contributing\nto Python _colorspace_, please have a look at our\n[Community guidelines](https://retostauffer.github.io/python-colorspace/community.html).\n\n### Test and development\n\nMore detailed information on how to run automated tests, create coverage reports,\ntest examples and render the documentation can be found on our \n[Installation](https://retostauffer.github.io/python-colorspace/installation.html#test-and-development) page.\n\n### GitHub Action integration (CI)\n\nAdditional notes about development and deployment are documented in\n[GITHUBACTIONS.md](https://github.com/retostauffer/python-colorspace/blob/main/GITHUBACTIONS.md).\n",
"bugtrack_url": null,
"license": "GPL-2 | GPL-3",
"summary": "A Python toolbox for manipulating and assessing colors and palettes",
"version": "1.0.0",
"project_urls": {
"Documentation": "https://retostauffer.github.io/python-colorspace/",
"HCL Wizard": "https://hclwizard.org/",
"Homepage": "https://github.com/retostauffer/python-colorspace",
"Issues": "https://github.com/retostauffer/python-colorspace/issues/",
"Repository": "https://github.com/retostauffer/python-colorspace/"
},
"split_keywords": [
"colors",
" color palettes",
" color spaces",
" manipulate colors",
" hcl",
" hcl colors",
" color vision deficiencies"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8bd8eeecfd2370f71964ee594603c83fe40861e604eeefcf30e8563e6cc597d8",
"md5": "4bc5caed82d7dd6447bd8188c0d19e9a",
"sha256": "02e9cedffc8d2f3e30381d2a1b0a841fc90668837e22bf09cd4eb2072d1f5cb0"
},
"downloads": -1,
"filename": "colorspace-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "4bc5caed82d7dd6447bd8188c0d19e9a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 519198,
"upload_time": "2024-10-28T18:53:55",
"upload_time_iso_8601": "2024-10-28T18:53:55.781740Z",
"url": "https://files.pythonhosted.org/packages/8b/d8/eeecfd2370f71964ee594603c83fe40861e604eeefcf30e8563e6cc597d8/colorspace-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-28 18:53:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "retostauffer",
"github_project": "python-colorspace",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "colorspace"
}