Scientific colormaps for making accessible, informative and 'cmashing' plots
Project description
CMasher: Scientific colormaps for making accessible, informative and cmashing plots
The CMasher package provides a collection of scientific colormaps to be used by different Python packages and projects, mainly in combination with matplotlib, showcased in the online documentation. The colormaps in CMasher are all designed to be perceptually uniform sequential, most of them are color-vision deficiency (CVD; color blindness) friendly and they cover a wide range of different color combinations to accommodate for most applications. It offers several alternatives to commonly used colormaps, like chroma and rainforest for jet; sunburst for hot; neutral for binary; and fusion and redshift for coolwarm. If you cannot find your ideal colormap here, then please open an issue, provide the colors and/or style you want, and I will try to create one to your liking! Let’s get rid of all bad colormaps in the world together!
If you use CMasher for your work, then please star the repo, such that I can keep track of how many users it has and more easily raise awareness of bad colormaps.
Colormap overview
Below is an overview of all the colormaps that are currently in CMasher. For more information, see the online documentation.
Installation & Use
How to install
CMasher can be found in the PyPI system, so pip install cmasher should suffice.
Example use
The colormaps shown above can be accessed by simply importing CMasher (which automatically executes the import_cmaps function on the cmasher/colormaps directory). This makes them available in CMasher’s cm module, in addition to registering them in matplotlib’s cm module (with added 'cmr.' prefix to avoid name clashes). So, for example, if one were to use the rainforest colormap, this could be done with:
# Import CMasher to register colormaps
import cmasher as cmr
# Import packages for plotting
import matplotlib.pyplot as plt
import numpy as np
# Access rainforest colormap through CMasher
cmap = cmr.rainforest
# Access rainforest colormap through MPL
# CMasher colormaps in MPL have an added 'cmr.' prefix
cmap = 'cmr.rainforest'
# Generate some data to plot
x = np.random.rand(100)
y = np.random.rand(100)
z = x**2+y**2
# Make scatter plot of data with colormap
plt.scatter(x, y, c=z, cmap=cmap, s=300)
plt.show()Accessing the colormaps in other packages than matplotlib would require reading in the text-files in the cmasher/colormaps directory, which contain the normalized RGB values (multiply by 255 for regular 8-bit values) of every colormap, and registering them in the package manually. For those that are interested, the viscm source files that were used for creating the colormaps can also be found in the cmasher/colormaps directory in the repo (the source files are not provided with the package distribution).
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file cmasher-1.1.5.tar.gz.
File metadata
- Download URL: cmasher-1.1.5.tar.gz
- Upload date:
- Size: 228.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/2.7.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | bdb4f2436fb47a461ddc8e7f50a8e412075f92cbc5cf55e77a30165c7747336b |
|
| MD5 | 710268bf522263a1d0270b894a3cf4e2 |
|
| BLAKE2b-256 | 71bd7c54499f5fb1dcee8f766581f815602897964cfe6907cf2f1b4020c7cc13 |
File details
Details for the file cmasher-1.1.5-py3-none-any.whl.
File metadata
- Download URL: cmasher-1.1.5-py3-none-any.whl
- Upload date:
- Size: 232.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.7.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7bbecf7c9209984c345acc92861429da71fa3fa0c53982cb1ff675e84fc91489 |
|
| MD5 | e219cf9a97f0f35c1cd7e013b2aa171c |
|
| BLAKE2b-256 | 8110b2cb26876349061ce2fb0e02ef3a8a5cb9ce6124dfeceb776deab81b93a9 |
File details
Details for the file cmasher-1.1.5-py2-none-any.whl.
File metadata
- Download URL: cmasher-1.1.5-py2-none-any.whl
- Upload date:
- Size: 232.7 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/2.7.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | fd03e579941150cc135fdc31ef1f68d7c76f206608d23940e5e82bffc81294b8 |
|
| MD5 | 13b7de51f92eb60eaf92814f2b2fd4db |
|
| BLAKE2b-256 | 19e7cbfb5810f0e82af2cc7b6b801b662dd9873b1524708bdb145e1a141de722 |
