Please see : http://colormap.readthedocs.io/ for an up-to-date documentation.
- version:
Python 3.9, 3.10, 3.11, 3.12
- 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/main/notebooks
What is it ?
colormap package provides utilities to convert colors between RGB, HEX, HLS, HUV and a framework to easily create and build colormaps for matplotlib. All matplotlib colormaps and some R colormaps are also available altogether. The plot_colormap method (see below) is handy to quickly pick up a colormaps and the test_colormap is useful to see a live version of the new colormap.
Installation
pip install colormap
Usage examples
convert RGB to HEX:
from colormap import rgb2hex, hex2rgb
hex_color = rgb2hex(255, 0, 0) # Red color in HEX
print(hex_color) # Output: "#ff0000"
rgb_color = hex2rgb("#ff0000") # Convert back to RGB
print(rgb_color) # Output: (255, 0, 0)
Generate a Custom colormap:
Create your own colormap. For instance, 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( {'red':[1,1,0], 'green':[0,1,.39], 'blue':[0,1,0]})
cmap = c.test_colormap(mycmap)
Even simpler if the colormap is linear using color’s name:
from colormap import Colormap
c = Colormap()
mycmap = c.cmap_linear('red', 'white', 'green(w3c)')
cmap = c.test_colormap(mycmap)
Visualise existing matplotlib colormap:
from colormap import plot_colormap, plot_category
plot_colormap("viridis")
Using the Colormap instance, you can see all valid names using:
c.colormaps
Matplotlib is very well known in the PYthon ecosystem and has categorised colormaps into categories such as a “diverging”. To visualise all of them:
plot_category('diverging')
Other sets of colormaps are : sequentials, sequentials2, misc, diverging, qualitative
See online documentation for details: http://colormap.readthedocs.io/
changelog
Version |
Description |
|---|---|
1.3.0 |
|
1.2.0 |
|
1.1.0 |
|
1.0.6 |
|
1.0.5 |
|
Metadata
Release files for colormap 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| colormap-1.3.0.tar.gz | 17.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| colormap-1.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 34.4 kB
Release files / colormap-1.3.0.tar.gz
| Download URL | colormap-1.3.0.tar.gz |
|---|---|
| Size | 17.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8df95ee498257aeabd3c8f42b55eac9a095fbfa05fbcbe5ac751fc95d71b00da
|
|
BLAKE2b-256 checksum How to use checksums |
27d69e425638d5c46926e9c508731284fd5a04043f63f8a4a4850947933da885
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Release files / colormap-1.3.0-py3-none-any.whl
| Download URL | colormap-1.3.0-py3-none-any.whl |
|---|---|
| Size | 17.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75a158fdc2d06e81bb92568d070119f1a55a8028050dffbb1de196020a11292b
|
|
BLAKE2b-256 checksum How to use checksums |
c5f4c53ac42d8933014ad96266fe6ea86af2c96fa186f209d4f80f3ce227a55a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Security for colormap 1.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.