Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Welcome to python-colorspace's documentation!

python-colorspace is a python package to create and handle colors and color palettes in python. Based on the Hue-Chroma-Luminance (HCL) color space effective color palettes can be designed and implemented in your own daily workflow.

This package is based on the code and ideas of the R colorspace package as it has often been requested by python enthusiasts. More information and an interactive interface can also be found on

The package itself can be found on github this documentation is also available on ReadTheDocs.


.. toctree::
    :maxdepth: 2


Other Packages and Further Reading

More information and further reading:

  • more information about the HCL color space, introduction to the colorspace packages (in R and python), and some interactive tools to define effective HCL-based color palettes, pick colors, and check existing plots and figures for possible problems in terms of color vision deficiencies.
  • A list of scientific articles which provide more detailed insights, e.g.
  • The end of the rainbow: an open letter to the climate science community by Ed Hawkins, Doug McNeall, David Stephenson, Jonny Williams & Dave Carlson.
  • Better Figures: Constructive criticism of the graphics of climate science by Doug McNeall.

Scientific articles with more detailed insights:

Some other packages providing color maps in python (on top of the default color maps) wich might be of interest:

  • seaborn: statistical data visualization. The package also provides access to a range of (mostly) well specified. color palettes.
  • palettable: color palettes for python. Formely known as brewer2mpl. Provides a range of color palettes including "Brewer2" and "Carto" palettes.
  • the source of the brewer colors, interactive webpage by Cynthia Brewer, Mark Harrower and The Pennsylvania State University.

Known issues


White point implemented but might require some additional testing.


.. todolist::