<div align="center">

PyPalettes

</div> <img src="https://github.com/y-sunflower/pypalettes/blob/main/images/logo.png?raw=true" alt="pypalettes logo" align="right" width="160px"/>

A dependency-free large (+2500) collection of colormaps and palettes for Python.

• All available palettes can be found in the Color Palette Finder.
• To learn more about how to use pypalettes, please refer to the official documentation.

This package is based on the R package paletteer, and all associated sub-packages (with original palettes) mentioned in the LICENSE file.

<br><br>

Installation

With pip:

pip install pypalettes

With conda:

conda install conda-forge::pypalettes

<br><br>

Quick start

pypalettes primarly offers 2 functions:

• load_palette("palette_name"): loads a list of colors (dependency-free)
• load_cmap("palette_name"): loads a colormap object (for matplotlib/seaborn/etc)

Continuous colormap for matplotlib/seaborn

import matplotlib.pyplot as plt
import numpy as np
from pypalettes import load_cmap

cmap = load_cmap("Sunset2", cmap_type="continuous")

data = np.random.randn(20, 20)

plt.imshow(data, cmap=cmap)
plt.colorbar()

Categorical palette

import matplotlib.pyplot as plt
import seaborn as sns
from pypalettes import load_palette

palette = load_palette("Fun")

df = sns.load_dataset("penguins")

g = sns.lmplot(
    data=df,
    x="bill_length_mm",
    y="bill_depth_mm",
    hue="species",
    palette=palette,
)

Your own colormap for matplotlib/seaborn

import matplotlib.pyplot as plt
from pypalettes import create_cmap
import numpy as np

cmap = create_cmap(
    colors=["#D57A6DFF", "#E8B762FF", "#9CCDDFFF", "#525052FF"],
    cmap_type="continuous",
)

x = np.linspace(0, 20, 1000)
y = np.sin(x)

plt.scatter(x, y, c=y, cmap=cmap)
plt.colorbar()

Going further

<br><br>

Features

• Add +2500 native palettes to matplotlib and seaborn
• Load, customise and combine +2500 palettes
• Create your own palettes

To find out more about using PyPalettes, use this PyPalettes guide.

<br><br>

Chart made with pypalettes

Click on the image to get the associated code!

<p> <a href="https://python-graph-gallery.com/web-map-with-custom-legend/" target="_blank"> <img src="https://raw.githubusercontent.com/holtzy/The-Python-Graph-Gallery/master/static/graph/web-map-with-custom-legend.png" width="30%" alt="choropleth map of europe" /> </a> <a href='https://python-graph-gallery.com/web-stacked-area-with-inflexion-arrows/' target="_blank"> <img src="https://raw.githubusercontent.com/holtzy/The-Python-Graph-Gallery/master/static/graph/web-stacked-area-with-inflexion-arrows.png" width="69%" alt="stacked area chart of natural disasters" /> </a> <br/> <a href='https://python-graph-gallery.com/591-arrows-with-inflexion-point/' target="_blank"> <img src="https://raw.githubusercontent.com/y-sunflower/pypalettes/main/images/chart_example_1.png" width="50%" alt="gapminder bubble chart" /> </a> <a href='https://python-graph-gallery.com/web-lollipop-with-colormap-and-arrow/' target="_blank"> <img src="https://github.com/holtzy/The-Python-Graph-Gallery/blob/master/static/graph/web-lollipop-with-colormap-and-arrow.png?raw=true" width="49%" alt="lollipop chart with colormap and arrow" /> </a> </p>

<br><br>

Acknowledgements

PyPalettes is highly inspired (and relies on for the first one) from

• the R package paletteer
• the python library palettable

A big thanks to Yan Holtz for creating the Color Palette Finder, a web app for browsing palettes

<br><br>