This site is being rebuilt as documentation. Performance figures shown on the previous site are withdrawn. Figures will be published on one evidence page, generated from one file. Each figure there will name its dataset, its size (n), and whether that data was used to fit, tune or design the model.

Helmlab

Helmlab defines color spaces for generating colors (gradients, palettes, gamut mapping) and for measuring color differences, and publishes their reference code.

Current definition: Helmlab 2026

Helmlab 2026 is defined by the outputs of helmlab 1.0.0 on npm and PyPI; 1.0.1 and 1.0.2 give the same outputs. The specification writes the definition out step by step, with test vectors and conformance levels for other implementations.

IdentifierWhat it names
helmgenGenSpace in Lab coordinates, for generating colors
helmgenlchGenSpace in LCh coordinates (lightness, chroma, hue)
helmlab-metricMetricSpace in its base form, for measuring color differences
ΔE helmlabColor difference computed from helmlab-metric coordinates
helmlab-metric-neutral (reserved)MetricSpace with the neutral correction (Appendix B); hl.metric in the helmlab package returns this form

Install

npm i helmlab
pip install helmlab

API reference: API.md. Changes by version: CHANGELOG.md.

Other implementations

These libraries are maintained outside Helmlab: Color.js, ColorAide and color-space.

Known issues