Utilities to ease manipulation of matplotlib colormaps and color codecs (e.g., hex2rgb)


Keywords
hex2web, web2hex, hex2rgb, rgb2hex, rgb2hsv, hsv2rgb, rgb2hls, hls2rgb, colormap, colors
License
Other
Install
pip install colormap==1.0.6

Documentation

COLORMAP documentation

Please see : http://colormap.readthedocs.io/ for an up-to-date documentation.

https://github.com/cokelaer/colormap/actions/workflows/ci.yml/badge.svg?branch=master https://coveralls.io/repos/cokelaer/colormap/badge.png?branch=master
version: Python 3.8, 3.9, 3.10, 3.11
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 is useful to see test a new colormap.

Installation

pip install colormap

Example

  • Create your own colormap from red to green colors with intermediate color as whitish (diverging map from red to green):

    c = Colormap()
    mycmap = c.cmap( {'red':[1,1,0], 'green':[0,1,.39], 'blue':[0,1,0]})
    cmap = c.test_colormap(mycmap)
    
  • Even simpler if the colormap is linear:

    c = Colormap()
    mycmap = c.cmap_linear('red', 'white', 'green(w3c)')
    cmap = c.test_colormap(mycmap)
    

https://colormap.readthedocs.io/en/latest/_images/quickstart-6.png

  • check out the available colormaps:

    c = Colormap()
    c.plot_colormap('diverging')
    

https://colormap.readthedocs.io/en/latest/_images/quickstart-4.png

See online documentation for details: http://colormap.readthedocs.io/

changelog

Version Description
1.0.6
  • Fix a matplotlib deprecation
  • Fix RTD documentation
1.0.5
  • remove Python3.6 and added Python3.10 to CI action
  • Fix issue in setup reported in #14
  • add requirements in MANIFEST
  • applied black on all files