Scientific colormaps for python, with no dependencies beyond numpy.
With cmap, you can use any of the colormaps from
matplotlib,
cmocean,
colorbrewer,
crameri,
seaborn, and a host
of other collections in your python code, without having to install matplotlib
or any other dependencies beyond numpy.
:book: See the complete catalog
There are a number of python libraries that provide or require colormaps or basic color support, but they all either depend on matplotlib, provide a specialized set of colormaps intended to extend those provided by matplotlib, or roll their own colormap solution that vendors/duplicates other libraries.
cmap is a lightweight library that provides a large collection of colormaps
with no dependencies beyond numpy. It provides exports to a number of known
third-party colormap objects, allowing it to be used across a wide range of
python visualization libraries. The intention is to provide a library that can
be used by any python library that needs colormaps, without forcing the user to
install matplotlib (while still being compatible with matplotlib and other
libraries that use matplotlib colormaps).
cmap is strictly typed and fully tested, with a focus on good developer
experience.
pip install cmap
conda install -c conda-forge cmap
See Documentation for full details.
cmap.ColorThe cmap.Color object is a simple wrapper around a tuple of RGBA scalars, with
a few convenience methods for converting to other color objects.
from cmap import Color
red = Color("red") # or a variety of other "color like" inputs
cmap.ColormapThe cmap.Colormap object is a callable that can map a scalar value (or numpy
array of values) to an RGBA color (or a numpy array of RGBA colors). API is
intended to mimic the behavior of a
matplotlib.colors.Colormap
object (without requiring matplotlib)
In [1]: import cmap
# or a variety of other "colormap like" inputs
In [2]: cmap1 = cmap.Colormap(["red", "green", "blue"])
In [3]: cmap1(np.linspace(0,1,5))
Out[3]:
array([[1. , 0. , 0. , 1. ],
[0.50393701, 0.24900417, 0. , 1. ],
[0. , 0.50196078, 0. , 1. ],
[0. , 0.24900417, 0.50393701, 1. ],
[0. , 0. , 1. , 1. ]])
Note that the input array must be normalized from 0-1, so if you're applying a colormap
to an integer array (like an image) you must apply any contrast limits and rescale to
0-1 before passing it to a Colormap.
The cmap.Colormap object has convenience methods that export it to a number of known
third-party colormap objects, including:
See documentation for details.
If you would like to see support added for a particular library, please open an issue or PR.
Other libraries providing colormaps:
FAQs
Scientific colormaps for python, without dependencies
We found that cmap demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket’s threat research team has detected six malicious npm packages typosquatting popular libraries to insert SSH backdoors.
Security News
MITRE's 2024 CWE Top 25 highlights critical software vulnerabilities like XSS, SQL Injection, and CSRF, reflecting shifts due to a refined ranking methodology.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.