Lacking documentation on colour spaces

[gerritholl]

Code Sample, a minimal, complete, and verifiable piece of code

# Your code here
hcl2rgb(6, 0.2, 0.2) # valid
hcl2rgb(6, 0.3, 0.2) # invalid

Problem description

I'm looking for a cylindrical colourspace to visualise a vector quantity. The hue should describe the angle (direction), and some form of brightness or lightness would describe the magnitude.

Apparently, hcl may be superior to hsv for this purpose, and trollimage implements HCL but not HSV. Unfortunately, the documentation makes it hard to tell if HCL fits my needs, and also hard to use.

The documentation on colorspaces describes what functions exist to convert between colorspaces, but it would be useful if it could also:

• Describe the colour spaces
• Provide references
• Describe the range of accepted input values
• Provide expert advice on the purposes of the

At present, I don't know how to use a function like hcl2rgb, or whether the

Expected Output

I would like to see that the documentation on colourspaces gives a bit of an overview on what colourspaces exist, what they're good for, how I can use them, and where I can read more about them. A bit like how the colourmap documentation does for colourmaps.

Versions of Python, package at hand and relevant dependencies

trollimage 1.9.0