color-plate-visualizer

Easy visualization of color plates using Plotly. Create, customize, and visualize color palettes with seamless gradients.

Table of Contents

• Introduction
• Quickstart
  • display_color_plate
  • gradient
• Installation
• Usage Examples
• License

Introduction

"color-plate-visualizer" is a Python library designed for the easy visualization and creation of color palettes. It provides functionalities to display color palettes and create gradients between colors. The repository is built on Plotly, a popular open-source graphing library, and offers a user-friendly way to work with color schemes in design, art, or any creative application. Special thanks to the Plotly project for providing the underlying visualization capabilities.

Quickstart

display_color_plate

Displays a horizontal bar plot representing the given colors.

Parameters

• colors: A list of color codes in hexadecimal format.

Example

from visualizer import display_color_plate
colors = ['#19D3F3', '#FF6692', '#7D5DEF', '#FF97FF', '#FFA500']
display_color_plate(colors)

gradient

Generates a gradient between the given colors.

Parameters

• colors: The original list of color codes.
• n_sampled: The desired number of colors in the final gradient list.
• shuffle_before_grad: (Optional) Shuffle the original colors before creating the gradient. Default is False.
• start_with_original: (Optional) Include the original colors at the beginning of the final gradient list. Default is True.

Example

from visualizer import gradient
colors = ['#19D3F3', '#FF6692', '#7D5DEF', '#FF97FF', '#FFA500']
gradient_colors = gradient(colors, n_sampled=9)

Installation

You can install the "color-plate-visualizer" by cloning the repository or downloading the source code.

1. Clone the repository or download the ZIP file.
2. Navigate to the directory and install the required dependencies.

   pip install plotly colour

Usage Examples

You can find comprehensive examples in the example.py file, demonstrating how to visualize color palettes and create custom gradients.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Credits

Built with love by Yotam Nahum, utilizing the Plotly project for visualization. Special thanks to the Plotly team for their outstanding work.