Image color clustering library for extracting N dominant colors from image
ImageToColors is a Image color clustering library for extracting N dominant colors from image and provide list of extracted colors in HEX format.THe prime purpose of this library is to provide quick colors extraction. It has
ExtractColors() function which deals with clustering it also operate image according to their sizes for fast and secure clustering. It also provides
HEXtoRGB() conversion function.For Graphical analysis
ImageToColors gives you
ClusterAnalaysis() using this function one can analyze color values along with each color percentage present in given image
The easiest way to install the library is to execute
pip install ImageToColors
(note that you need network access to do it this way; if you do not have the pip tool installed -- see: https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/).
Alternatively, you can
download_ the library source archive, unpack it,
cd to the unpacked directory and execute the following command
python setup.py install
It is also possible to use the library without installing it: as its code is contained in a single file (
IMageToColors.py), you can just copy it into your project.
It takes 2 arguments
cluster value which is nothing but the integer value for number of colors want to extract.
ExtractColors() takes any image having
.png any one of them extension.It returns a list of hex color code list.
['#46a947', '#ed3723', '#0b66b5', '#af60a8', '#fbbf10']
It takes single
HEX colors list argument and convert returns a
RGB colors code list
[(70, 169, 71), (237, 55, 35), (11, 102, 181), (175, 96, 168), (251, 191, 16)]
It takes extracted
HEX colors list and plot the donut graph showing color code and percentage of colors present in given image.
from ImageToColors.ImageToColors import * img = "image.jpg" # .png or .jpg clust = 5 # Cluster value nothing but the how many dominant colors user want to extract #to print extracted colors list use ExtractColors() function HEXlist= ExtractColors(img,clust) print(HEXlist) # To convert Hex color list to RGB use HEXtoRGB RGBlist = HEXtoRGB(HEXlist) print(RGBlist) #For graphical analysis use ClusterAnalysis() ClusterAnalysis(HEXlist)
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
Distributed under the MIT License. See for more information.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for ImageToColors-1.1-py3-none-any.whl