Metadata-Version: 2.2
Name: colorir
Version: 2.1.3
Summary: A python package for easy management of colors and palettes.
Home-page: https://github.com/aleferna12/colorir
Author: aleferna
Author-email: alexandrepchfernandes@gmail.com
License: MIT
Project-URL: Documentation, https://colorir.readthedocs.io/en/latest/
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: numpy>=1.25
Requires-Dist: networkx>=3.3
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

Colorir
=======

.. image:: docs/source/_static/image/readme_palette_picker.png
    :width: 800px

What is colorir?
----------------

colorir is a package used to create and manipulate color palettes.

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:

.. code-block:: python

    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
    palette  # Shows the palette we created in the terminal

.. image:: docs/source/_static/image/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:

.. code-block:: python

    import matplotlib.pyplot as plt

    plt.pie([0.25, 0.15, 0.20, 0.20, 0.20], colors=palette)
    plt.show()

.. image:: docs/source/_static/image/readme_pie_chart.png
    :width: 300px

For more information (including use-cases and examples), see colorir's documentation `here <https://colorir.readthedocs.io/en/latest/>`_.
