Skip to main content

A python package for easy management of colors and palettes.

Project description

docs/source/images/readme_palette_picker.png

What is colorir?

colorir is a package used to create and manipulate palettes and colors. What makes colorir different from other similar packages like colour and palettable is that colorir focuses on personalization and interoperability: you can create your own color palettes and use them with any other python package such as matplotlib, tkinter or flask.

Main features

  • Create color schemes and save them to use in different projects

  • Interpolate colors in different formats (such as RGB, CIELab etc) to make gradients and color maps

  • Have access to a curated selection of unique color palettes and color names

  • Easily visualize swatches of colors in the terminal

Getting started

It is very easy to create an original and attractive color palette with colorir:

import colorir as cl
grad = cl.PolarGrad(["ffff00", "ff00ff"])  # Creates a gradient from yellow to magenta
palette = cl.StackPalette(grad.n_colors(5))  # Samples 5 colors along the gradient and creates a palette with them
palette *= cl.HCLab(1, 0.5, 1)  # Desaturates the palette 50% to get a more pleasing look
cl.swatch(palette)  # Shows the palette we created in the terminal
docs/source/images/readme_palette.png

colorir also works seamlessly with other python packages and you don’t have to convert colorir objects to pass them as input to other frameworks:

import matplotlib.pyplot as plt

plt.pie([0.25, 0.15, 0.20, 0.20, 0.20], colors=palette)
plt.show()
docs/source/images/readme_pie_chart.png

For more information (including use-cases and examples), see colorir’s documentation here.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

colorir-2.0.3.tar.gz (45.1 kB view details)

Uploaded Source

Built Distribution

colorir-2.0.3-py3-none-any.whl (2.8 kB view details)

Uploaded Python 3

File details

Details for the file colorir-2.0.3.tar.gz.

File metadata

  • Download URL: colorir-2.0.3.tar.gz
  • Upload date:
  • Size: 45.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.8.18

File hashes

Hashes for colorir-2.0.3.tar.gz
Algorithm Hash digest
SHA256 ee7061d1841e496a9d0e0bd26809bcadbf6e0fc0029fb68be7aca895d2c0f795
MD5 9d76ff6703e7b2139eda413f57f73e16
BLAKE2b-256 c158256ff69aa59c7fd891e0fd8cac0283802ddbcfa0552af0f23172179a0b15

See more details on using hashes here.

File details

Details for the file colorir-2.0.3-py3-none-any.whl.

File metadata

  • Download URL: colorir-2.0.3-py3-none-any.whl
  • Upload date:
  • Size: 2.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.8.18

File hashes

Hashes for colorir-2.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 bd59f2e12632903af08156ed064cdcabe1a5665d2682e5897b9b8161ccfb0584
MD5 fddfe30f91528d741ca486cfe6f2db5b
BLAKE2b-256 5eef6ecb973802564225750770ff051483a74db9a1490c84bcc23fcb70affc47

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page