Skip to main content

Color palettes for scientific purposes

Project description

ArtSciColor

PyPI version License: GPL v3 Open Source? Yes! DOI

Creating a python package with color palettes and utilities for their use in matplotlib, seaborn, plotly, and others.

:construction: WORK IN PROGRESS :construction:

R users or Python users who don't want to install the package but still want to use the palettes, can download them in CSV form from the dataset's permalink!

Installation

The package is available through pypi, so it can be installed by running:

pip install ArtSciColor

Usage

To use a color palette simply load the package and run:

import ArtSciColor as art

hexPalette = art.getSwatch(SWATCH_ID)

where the SWATCH_ID should match one of the palettes available in our package (see the following section for more info).

Available Swatches

Have a look at currently-available palettes by selecting your favorite artist or category, and use one through its ID!

Art

Miro, Kandinsky, Kirchner, Matisse, Picasso, Signac, Warhol, Nolde, Monet, VanGogh, EdnaAndrade, DarbyBannard, UmbertoBoccioni, Magritte

Movies

Studio Ghibli, Disney

Gaming

Splatoon1, Splatoon2, Splatoon3

Other

chipdelmal, lospec, institutions, coolors, color-hex, and schemecolor

Full dataframe in CSV for available for download here!

How are the palettes generated?

Getting palette colors is a common exercise for people getting started into clustering methods. The most widely-used algorithm for this task is k-means, but in this package the algorithm and its parameters can be provided as long as they adhere to scikit-learn's standards. Most of the curated palettes were calculated through the agglomerative clustering algorithm as follows:

from sklearn.cluster import AgglomerativeClustering
# Read image and setup number of desired clusters
img = art.readCV2Image(fPath)
CLST_NUM=4
# Clustering algorithm
CLUSTERING = {
    'algorithm': AgglomerativeClustering, 
    'params': {'n_clusters': CLST_NUM} 
}
(pixels, labels) = art.calcDominantColors(
    img, 
    cFun=CLUSTERING['algorithm'], 
    cArgs=CLUSTERING['params']
)

Other algorithms such as DBSCAN and HDBSCAN, Spectral Clustering, OPTICS, etc; can also be used.

Notes and Sources

This package was initially inspired by Blake R Mills' R packages (MoMA Colors and MetBrewer). Most palettes or original artworks are sourced from: NGA, wikiart, staedelemuseum, filmartgallery, coolors, schemecolor, color-hex, inkipedia, lospec; so please visit and support their work!


Coded by: Héctor M. Sánchez C.

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

ArtSciColor-0.3.3.8.tar.gz (79.3 kB view details)

Uploaded Source

Built Distribution

ArtSciColor-0.3.3.8-py3-none-any.whl (75.9 kB view details)

Uploaded Python 3

File details

Details for the file ArtSciColor-0.3.3.8.tar.gz.

File metadata

  • Download URL: ArtSciColor-0.3.3.8.tar.gz
  • Upload date:
  • Size: 79.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for ArtSciColor-0.3.3.8.tar.gz
Algorithm Hash digest
SHA256 2e820448a3cfc7feba0ca1b464a28240c655bcc8b010f44d248b86859e9182eb
MD5 dbae1b4c9df3e6c3a4fab14e6c10ca31
BLAKE2b-256 e3c54593f00fb1452c672a01f9bd24a7fdf19d6f2da393d1dba276411eb2caf1

See more details on using hashes here.

File details

Details for the file ArtSciColor-0.3.3.8-py3-none-any.whl.

File metadata

File hashes

Hashes for ArtSciColor-0.3.3.8-py3-none-any.whl
Algorithm Hash digest
SHA256 6d746d483d3cec6245f04dbdc6c096520df23d493cb0c4df2aad1dffc8af473a
MD5 bda887f2654f64762b5e5cccd96e81a7
BLAKE2b-256 2e5936d684b70f548c769bbb12e72e4ed0c189ac7092475eee14c1da27fa37bf

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