Metadata-Version: 2.4
Name: colorcet
Version: 3.2.1
Summary: Collection of perceptually uniform colormaps
Author-email: "James A. Bednar" <jbednar@anaconda.com>
Maintainer-email: "James A. Bednar" <jbednar@anaconda.com>
License-Expression: CC-BY-4.0
Project-URL: Issue Tracker, https://github.com/holoviz/colorcet/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen
Project-URL: Blog, https://blog.holoviz.org/
Project-URL: Discord, https://discord.gg/AXRHnJU6sP
Project-URL: Discourse, https://discourse.holoviz.org
Project-URL: Documentation, https://colorcet.holoviz.org
Project-URL: Funding, https://opencollective.com/holoviz
Project-URL: HoloViz, https://holoviz.org/
Project-URL: Homepage, https://colorcet.holoviz.org
Project-URL: Repository, https://github.com/holoviz/colorcet
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Development Status :: 5 - Production/Stable
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Provides-Extra: tests
Requires-Dist: pre-commit; extra == "tests"
Requires-Dist: pytest>=2.8.5; extra == "tests"
Requires-Dist: pytest-cov; extra == "tests"
Requires-Dist: packaging; extra == "tests"
Provides-Extra: tests-extra
Requires-Dist: colorcet[tests]; extra == "tests-extra"
Requires-Dist: pytest-mpl; extra == "tests-extra"
Provides-Extra: examples
Requires-Dist: numpy; extra == "examples"
Requires-Dist: holoviews; extra == "examples"
Requires-Dist: matplotlib; extra == "examples"
Requires-Dist: bokeh; extra == "examples"
Provides-Extra: tests-examples
Requires-Dist: colorcet[examples]; extra == "tests-examples"
Requires-Dist: nbval; extra == "tests-examples"
Provides-Extra: doc
Requires-Dist: colorcet[examples]; extra == "doc"
Requires-Dist: nbsite>=0.8.4; extra == "doc"
Requires-Dist: sphinx-copybutton; extra == "doc"
Provides-Extra: all
Requires-Dist: colorcet[tests]; extra == "all"
Requires-Dist: colorcet[tests_extra]; extra == "all"
Requires-Dist: colorcet[examples]; extra == "all"
Requires-Dist: colorcet[doc]; extra == "all"
Dynamic: license-file

<img src="https://raw.githubusercontent.com/holoviz/colorcet/main/doc/_static/logo.png" width="200"><br>

-----------------

# Colorcet: Collection of perceptually uniform colormaps

|    |    |
| --- | --- |
| Latest release | [![Github release](https://img.shields.io/github/release/holoviz/colorcet.svg?label=tag&colorB=11ccbb)](https://github.com/holoviz/colorcet/releases) [![PyPI version](https://img.shields.io/pypi/v/colorcet.svg?colorB=cc77dd)](https://pypi.python.org/pypi/colorcet) [![colorcet version](https://img.shields.io/conda/v/pyviz/colorcet.svg?colorB=4488ff&style=flat)](https://anaconda.org/pyviz/colorcet) [![conda-forge version](https://img.shields.io/conda/v/conda-forge/colorcet.svg?label=conda%7Cconda-forge&colorB=4488ff)](https://anaconda.org/conda-forge/colorcet) [![defaults version](https://img.shields.io/conda/v/anaconda/colorcet.svg?label=conda%7Cdefaults&style=flat&colorB=4488ff)](https://anaconda.org/anaconda/colorcet) |
| Python | [![Python support](https://img.shields.io/pypi/pyversions/colorcet.svg)](https://pypi.org/project/colorcet/) |
| Build Status | [![Linux/MacOS Build Status](https://github.com/holoviz/colorcet/workflows/tests/badge.svg?query=branch%3Amain)](https://github.com/holoviz/colorcet/actions/workflows/tests.yaml?query=branch%3Amain) |
| Coverage | [![codecov](https://codecov.io/gh/holoviz/colorcet/branch/main/graph/badge.svg)](https://codecov.io/gh/holoviz/colorcet) |
| Latest dev release | [![Github tag](https://img.shields.io/github/tag/holoviz/colorcet.svg?label=tag&colorB=11ccbb)](https://github.com/holoviz/colorcet/tags) [![dev-site](https://img.shields.io/website-up-down-green-red/https/holoviz-dev.github.io/colorcet.svg?label=dev%20website)](https://holoviz-dev.github.io/colorcet/) |
| Documentation | [![site](https://img.shields.io/website-up-down-green-red/http/colorcet.holoviz.org.svg)](https://colorcet.holoviz.org) |


## What is it?

Colorcet is a collection of
perceptually uniform colormaps for use with Python plotting programs like
[bokeh](https://bokeh.org),
[matplotlib](https://matplotlib.org),
[holoviews](https://holoviews.org), and
[datashader](https://github.com/bokeh/datashader) based on the
set of [perceptually uniform colormaps](https://arxiv.org/abs/1509.03700) created
by Peter Kovesi at the Center for Exploration Targeting.


## Installation

Colorcet supports Python 3.10 and greater on Linux, Windows, and Mac
and can be installed with conda:

```sh
conda install colorcet
```

or with pip:

```sh
python -m pip install colorcet
```

If you want to try out the latest features between releases, you can get the latest dev release by installing:

```sh
conda install -c pyviz/label/dev colorcet
```

For more information take a look at [Getting Started](https://colorcet.holoviz.org/getting_started).

## Learning more

You can see all the details about the methods used to create these colormaps in [Peter Kovesi's 2015 arXiv paper](https://arxiv.org/pdf/1509.03700v1.pdf).
Other useful background is available in a [1996 paper from IBM](https://web.archive.org/web/20161126173524/http://www.research.ibm.com/people/l/lloydt/color/color.HTM).

The Matplotlib project also has a number of relevant resources,
including an excellent
[2015 SciPy talk](https://www.youtube.com/watch?v=xAoljeRJ3lU), the
[viscm tool for creating maps like the four in mpl](https://github.com/matplotlib/viscm), the
[cmocean site](https://matplotlib.org/cmocean/) collecting a set of maps created by viscm,
and the [discussion of how the mpl maps were created](https://bids.github.io/colormap/).


## Samples

Some of the Colorcet colormaps that have short, memorable names (which are probably
the most useful ones) are visible here:

<img src="https://raw.githubusercontent.com/holoviz/colorcet/main/doc/assets/images/named.png" width="800"><br>

But the complete set of 100+ is shown in the [User Guide](https://colorcet.holoviz.org/user_guide).
