lmcinnes / lmcinnes/umap

[Documentation] Update RGBa parameter example to a perceptual colorspace like CIELab?

Open
#602 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
8.3k
Forks
871
Avg merge
1d 13h
Merged PRs (30d)
5

Description

In the [documentation about parameters](https://umap-learn.readthedocs.io/en/latest/parameters.html), 4-dimensional RGBa color coordinates are visualized in 2D, and colored, to showcase how various UMAP parameters affect the final reduction. However, RGBa is not a perceptual color space, which means readers' intuitions about which points should be grouped together based on color similarity will be off.

One could instead convert the RGBa coordinates to CIELab (a perceptual colorspace). One way to do this is to go from RGBa to RGB, and then RGB to CIELab (a perceptual color space) via the color transformation functions found here: https://scikit-image.org/docs/dev/api/skimage.color.html. There might be other ways to do this conversion as well.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the parameters documentation linked in the issue and inspect the RGBa visualization example. Read the scikit-image color transformation documentation to compare the proposed RGB-to-CIELab route with available alternatives. Done means the example uses an appropriate perceptual colorspace and the rendered documentation remains clear.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
data-visualization, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.