This package provides Python functionality for creating custom colormaps which are perfectly perceptually uniform.
The project came up as a result of there being too few easily accessible perceptually uniform colormaps, so I wanted to have a go at creating a good library where users can easily create their own. I wasn't quite happy with colormaps such as viridis
, plasma
or magma
from matplotlib
, so I started making some algorithmic colormaps.
To stay as true as possible to the lightness achieved by a true grayscale colormap, but add more information with colors, the perceptual range of colormaps is optimized to be as high as possible.
create_custom_colormap()
: Create your own colormap.get_colormap()
: Get a named colormap from the library -- an instance ofmatplotlib.colors.LinearSegmentedColormap
.get_available_colormaps()
: Lists all available local and internal colormaps.
run: python ./perfect_cmaps/customize_cmap.py --num_points 21 --lightness linear
or a similar command
This specifies that your colormap will have 21 control points, which will later be interpolated for desired granularity, and that the colormap will have a linear lightness profile.
create_colormap.mp4
To test out your colormap, you can use the function get_colormap()
or use the main function from colormaps.py
:
python ./perfect_cmaps/colormaps.py --colormap test_colormap -n 1000 --interpolation quadratic --smoothing 0.03
Here' the colormap was named test_colormap
, and we specify the colormap to have 1000 points, with quadratic interpolation and some amount of smoothing applied.
Here's a compilation of some colormaps generated with this library, compared with some standard colormaps available in matplotlib
:
The top two colormaps, viridis
and cividis
have a lower perceptual range, and thus look less clear -- almost like there's a filter on them. The colormaps generated with perfect-cmaps
are crisper and offer a maximal perceptual range. Additionally, the perceptual limitation for the standard colormaps is especially visible when for example a background in grayscale is very white, in which case the standard colormaps are in this case yellow and clearly do not cover the entire lightness spectrum.
The algorithmically created ectotherm
colormap in fact covers 100 % of the perceptual range, while adding more information through colors. It ranges from completely black to completely white, while adding colors in between and maintaining truly linearly increasing lightness. This is one of my favorites! The other two displayed custom colormaps mimic viridis
and cividis
, but with a higher perceptual range. The standard ectotherm
colormap is linear in luminance, whereas the ectotherm_l
colormap is linear in lightness. I recommend the ectotherm_l
colormap for general use.
You may have heard that standard RGB colormaps should be avoided. Well, common RGB colormaps are indeed not at all perceptually uniform, but if you design them right, you can still have a useful colormap with much color information, perceptual range and true perceptual uniformity.
Thanks to Nanoscience.com for letting me use the grayscale images as examples! Find them at https://www.nanoscience.com/techniques/scanning-electron-microscopy/.
These custom generated colormaps are theoretically perceptually uniform, but note that some screen settings may show colormap artifacts, making the colormaps appear less perceptually uniform. This may happen at lower computer screen lighting, for example.