Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JosephBARBIERDARNAL/pypalettes
A large (+2500) collection of color maps for Python
https://github.com/JosephBARBIERDARNAL/pypalettes
cmap color matplotlib visualization
Last synced: 23 days ago
JSON representation
A large (+2500) collection of color maps for Python
- Host: GitHub
- URL: https://github.com/JosephBARBIERDARNAL/pypalettes
- Owner: JosephBARBIERDARNAL
- License: other
- Created: 2024-05-30T18:46:27.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-09-09T17:31:02.000Z (2 months ago)
- Last Synced: 2024-09-09T21:43:54.396Z (2 months ago)
- Topics: cmap, color, matplotlib, visualization
- Language: Python
- Homepage: https://python-graph-gallery.com/color-palette-finder/
- Size: 39.4 MB
- Stars: 204
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.note
Awesome Lists containing this project
README
# PyPalettes
A large (**+2500**) collection of color maps for Python.
- All available palettes can be found [on the dedicated website](https://python-graph-gallery.com/color-palette-finder/).
- To learn more about how to use `pypalettes`, please refer to the [official documentation](https://python-graph-gallery.com/introduction-to-pypalettes/).
> This package is based on the R package [paletteer](https://github.com/EmilHvitfeldt/paletteer), and all associated sub-packages (with original palettes) mentioned in the file [LICENSE](LICENSE.note).
## Installation
_Note: pypalettes requires **Python 3.9** or above._
You can install `pypalettes` directly from PyPI with:
```bash
pip install --upgrade pypalettes
```
Alternatively you can install the **development version** with:
```bash
pip install git+https://github.com/JosephBARBIERDARNAL/pypalettes.git
```
## Quick start
Once the `cmap` is loaded, you can use it as any other color map in `matplotlib` or `seaborn`.
```python
import matplotlib.pyplot as plt
from pypalettes import load_cmap
import seaborn as sns
import numpy as np
data = np.random.rand(10, 12)
cmap = load_cmap('Anemone', cmap_type='continuous')
sns.heatmap(data, cmap=cmap)
plt.show()
```
## Getting started
- Load a color map:
```python
from pypalettes import load_cmap
cmap = load_cmap('Chaetodon_sedentarius')
cmap
```
- Transform a qualitative color map into a continuous one:
```python
from pypalettes import load_cmap
cmap = load_cmap('Chaetodon_sedentarius', cmap_type='continuous')
cmap
```
- Invert a color map:
```python
from pypalettes import load_cmap
cmap = load_cmap('Chaetodon_sedentarius', reverse=True)
cmap
```
- Get hex values of a color map:
```python
from pypalettes import get_hex
get_hex('pupitar')
```
`['#7098C0FF',
'#88C0E8FF',
'#285880FF',
'#B8E0F8FF',
'#F8F8F8FF',
'#404060FF',
'#A8A8A8FF',
'#C8C8D0FF',
'#B04000FF']`
- Get rgb values of a color map:
```python
from pypalettes import get_rgb
get_rgb('AirNomads')
```
`[(255, 153, 51),
(194, 72, 65),
(255, 255, 51),
(139, 91, 69),
(135, 175, 209),
(238, 176, 90),
(219, 197, 160)]`
- Combine multiple colormaps
```python
from pypalettes import get_hex
get_hex(['Alacena', 'Antique'])
```
`['#693829FF',
'#894B33FF',
'#A56A3EFF',
'#CFB267FF',
'#D9C5B6FF',
'#9CA9BAFF',
'#5480B5FF',
'#3D619DFF',
'#405A95FF',
'#345084FF',
'#855C75FF',
'#D9AF6BFF',
'#AF6458FF',
'#736F4CFF',
'#526A83FF',
'#625377FF',
'#68855CFF',
'#9C9C5EFF',
'#A06177FF',
'#8C785DFF',
'#467378FF',
'#7C7C7CFF']`
> More examples can be found in this [**introduction to PyPalettes**](https://python-graph-gallery.com/introduction-to-pypalettes/).
## Chart made with `pypalettes`
*Click on the image to get the associated code!*
## Contributing
### Installation for contributions
1. **Fork the Repository:**
Fork this repository to your GitHub account.
2. **Clone the Repository:**
```bash
git clone https://github.com/JosephBARBIERDARNAL/pypalettes.git
cd pypalettes
```
3. **Set Up a Virtual Environment:**
- **Mac/Linux:**
```bash
python3 -m venv venv
source venv/bin/activate
```
- **Windows:**
```cmd
python -m venv venv
venv\Scripts\activate
```
4. **Install Dependencies:**
```bash
pip install -r requirements-dev.txt
pip install -e .
```
5. **Create a Feature Branch:**
```bash
git checkout -b feature-name
```
6. **Start Coding!**
Since the core code of the library is currently quite short and simple, it does not require any major changes. However, if you feel like you have a good idea/suggestion, please [open an issue](https://github.com/JosephBARBIERDARNAL/pypalettes/issues).
BUT, more palettes is one easy way to make `pypalettes` better! Here is the best way to get started:
Then open your code editor and open `parsers/list_manual_palettes.py`. You will find a dictionnary of dictionnary of manually defined palettes. Add yours at the end with the following elements:
- `"name"`: the name of your palette
- `"palette"`: the colors of your palette, in the following format: `["['#123456', '#654321', '#162534']"]`
- `"source"`: where does your palette come from? If you created it, your name or a link to your portfolio is valid!
- `"kind"`: the kind of your palette. View examples [here](https://python-graph-gallery.com/color-palette-finder/)
- `"paletteer-kind"`: just put `"unknown"`
For a large number of palettes, please [open an issue](https://github.com/JosephBARBIERDARNAL/pypalettes/issues) first.
## Acknowledgements
`PyPalettes` is **highly** inspired (and relies on for the first one) from
- the R package [paletteer](https://github.com/EmilHvitfeldt/paletteer)
- the python library [palettable](https://github.com/jiffyclub/palettable).
A big thanks to [Yan Holtz](https://www.yan-holtz.com/) for:
- Creating the [web app for browsing palettes](https://python-graph-gallery.com/color-palette-finder/)
- Hosting the [documentation](https://python-graph-gallery.com/introduction-to-pypalettes/) and [examples](#chart-made-with-pypalettes) on the **Python Graph Gallery**
- Providing valuable feedback on the code and design of the API
## How data has been collected
99% of the palettes come from the [Paletteer R package](https://github.com/EmilHvitfeldt/paletteer).
Learn more in the [dedicated directory](parsers/README.md).