Colormap¶
| version: | Python 3.6, 3.7, 3.8, 3.9 |
|---|---|
| contributions: | Please join https://github.com/cokelaer/colormap |
| issues: | Please use https://github.com/cokelaer/colormap/issues |
| notebook: | Please see https://github.com/cokelaer/colormap/tree/master/notebooks |
What is it ?¶
colormap package provides simple utilities to convert colors between RGB, HEX, HLS, HUV and a class to easily build colormaps for matplotlib. All matplotlib colormaps and some R colormaps are available altogether. The plot_colormap method (see below) is handy to quickly pick up a colormaps and the test_colormap function is useful to see/test a new colormap.
Installation¶
Prerequisites¶
You will need to install Python (linux and mac users should have it installed already). We recommend also to install ipython, which provides a more flexible shell alternative to the python shell itself. colormap requires matplotlib and easydev, which are available on pypi and installed automatically with this package.
Examples¶
Using the Colormap class¶
Create your own colormap from red to green colors with intermediate color as whitish (diverging map from red to green):
from colormap import Colormap
c = Colormap()
mycmap = c.cmap_linear('red', 'white', 'green(w3c)')
c.test_colormap(mycmap)
(Source code, png, hires.png, pdf)
Using the aliases¶
Without creating an instance of Colormap, you can use these functions:
from colormap import cmap_builder, test_cmap
mycm = cmap_builder('red', 'black', 'yellow')
test_cmap(mycm)
(Source code, png, hires.png, pdf)
Visualise set of colormap¶
Another convenient feature is to look at a set of colormaps altogether:
c = Colormap()
c.plot_colormap('diverging')
Other set names are:
- sequentials2,
- misc
- diverging
- diverging_black
- qualitative
See user guide for details.