Implémentation de CIEDE2000 en Python

Version de la fonction : v1.0.0
Statistiques du site
Nombre de visites1 087
Nombre de fichiers consultés1 143 + 373

Cette page prĂ©sente une implĂ©mentation de rĂ©fĂ©rence de la formule de diffĂ©rence de couleur CIEDE2000 en Python. Si vous souhaitez assurer une compatibilitĂ© parfaite (Ă  la dixiĂšme dĂ©cimale) avec certaines implĂ©mentations tierces, vous devrez peut-ĂȘtre modifier les commentaires dans le code source. Pour vous faciliter la tĂąche, le lien suivant automatise cette opĂ©ration.

Diagramme de la formule CIEDE2000 complĂšte avec les composants L*a*b* et les ajustements

La fonction ΔE2000 en Python

Considérons la plus courante et académique (Sharma, 2005) des deux formulations.

# Cette fonction écrite en Python est placée dans le domaine public et
# n’est pas affiliĂ©e Ă  la CIE (Commission Internationale de l’Éclairage).

# L’implĂ©mentation CIEDE2000 classique qui accepte deux couleurs L*a*b* et renvoie leur diffĂ©rence.
# La composante "L" varie de 0 à 100. "a" et "b", non bornées, sont souvent projetées entre -128 et 127.
def ciede_2000(l_1, a_1, b_1, l_2, a_2, b_2) :
	from math import pi, sqrt, atan2, sin, exp
	# Traite la formule de différence de couleurs CIEDE2000 en Python.
	# k_l, k_c et k_h sont des facteurs paramĂ©triques qu’on ajuste
	# selon des recommandations propres au secteur industriel.
	k_l = k_c = k_h = 1.0
	n = (sqrt(a_1 * a_1 + b_1 * b_1) + sqrt(a_2 * a_2 + b_2 * b_2)) * 0.5
	n = n * n * n * n * n * n * n
	# Un facteur impliquant la chroma moyenne Ă  la puissance 7,
	# conçu pour modéliser plus précisément son influence.
	n = 1.0 + 0.5 * (1.0 - sqrt(n / (n + 6103515625.0)))
	# Application du facteur de correction de la chroma pour compenser sa non-linéarité.
	c_1 = sqrt(a_1 * a_1 * n * n + b_1 * b_1)
	c_2 = sqrt(a_2 * a_2 * n * n + b_2 * b_2)
	# La fonction atan2 est prĂ©fĂ©rĂ©e Ă  atan car elle calcule l’angle d’un
	# point (x, y) dans tous les quadrants, en tenant compte du signe de x et y.
	h_1 = atan2(b_1, a_1 * n)
	h_2 = atan2(b_2, a_2 * n)
	h_1 += 2.0 * pi * (h_1 < 0.0)
	h_2 += 2.0 * pi * (h_2 < 0.0)
	n = abs(h_2 - h_1)
	# Prévient le branchement de dépendre du RoundingMode du langage de programmation.
	if pi - 1E-14 < n and n < pi + 1E-14 :
		n = pi
	# Lorsque les angles de teinte sont dans différents quadrants,
	# la moyenne arithmétique simple peut donner un angle incorrect,
	# les lignes suivantes prennent en compte cette correction angulaire.
	h_m = (h_1 + h_2) * 0.5
	h_d = (h_2 - h_1) * 0.5
	if pi < n :
		h_d += pi
		# 📜 La formulation de Sharma n’utilise pas la ligne suivante, mais plutît celle d’aprùs.
		# Note : ces deux variantes ne diffÚrent que de ±0,0003 sur la différence de couleur finale.
		h_m += pi
		# h_m += pi if h_m < pi else -pi
	p = 36.0 * h_m - 55.0 * pi
	n = (c_1 + c_2) * 0.5
	n = n * n * n * n * n * n * n
	# Le terme de correction de la rotation de teinte ajuste le comportement
	# de l’algorithme, d’autant plus si la comparaison porte sur des teintes bleues.
	r_t = -2.0 * sqrt(n / (n + 6103515625.0)) \
			* sin(pi / 3.0 * exp(p * p / (-25.0 * pi * pi)))
	n = (l_1 + l_2) * 0.5
	n = (n - 50.0) * (n - 50.0)
	# Luminosité.
	l = (l_2 - l_1) / (k_l * (1.0 + 0.015 * n / sqrt(20.0 + n)))
	# Ces coefficients modulent l’influence des composantes
	# harmoniques dans le calcul de la différence de teinte.
	t = 1.0	+ 0.24 * sin(2.0 * h_m + pi * 0.5) \
		+ 0.32 * sin(3.0 * h_m + 8.0 * pi / 15.0) \
		- 0.17 * sin(h_m + pi / 3.0) \
		- 0.20 * sin(4.0 * h_m + 3.0 * pi / 20.0)
	n = c_1 + c_2
	# Teinte.
	h = 2.0 * sqrt(c_1 * c_2) * sin(h_d) / (k_h * (1.0 + 0.0075 * n * t))
	# Chroma.
	c = (c_2 - c_1) / (k_c * (1.0 + 0.0225 * n))
	# Retourner la racine carrée assure que dE00 représente une distance
	# gĂ©omĂ©trique (comprise entre 0 et environ 185) dans l’espace CIELAB.
	return sqrt(l * l + h * h + c * c + c * h * r_t)

#    Projet GitHub : https://github.com/michel-leonard/ciede2000-color-matching
#   Tests en ligne : https://michel-leonard.github.io/ciede2000-color-matching

# L1 = 56.7   a1 = 35.7   b1 = 1.8
# L2 = 56.4   a2 = 30.4   b2 = -1.5
# CIE ΔE00 = 2.9300617784 (Bruce Lindbloom, Netflix’s VMAF, ...)
# CIE ΔE00 = 2.9300753540 (Gaurav Sharma, OpenJDK, ...)
# Écart entre les implĂ©mentations ≈ 1.4e-5

# Voir les commentaires du code source pour passer d’une de ces variantes d’implĂ©mentation de ΔE*00 Ă  l’autre.

ParamĂštres k_l, k_c et k_h

Les paramĂštres k_l, k_c et k_h de CIEDE2000 sont des facteurs de pondĂ©ration appliquĂ©s aux termes luminositĂ© (ΔL*), chroma (ΔC*) et teinte (ΔH*). Ils sont dĂ©finis comme des constantes dans le code source. Leur valeur par dĂ©faut est 1, ce qui correspond aux conditions d’observation standard recommandĂ©es par la Commission internationale de l’éclairage (CIE). En pratique, il peut ĂȘtre nĂ©cessaire d’ajuster ces coefficients en fonction de conditions spĂ©cifiques : par exemple, k_l = 2 est parfois utilisĂ© pour donner plus de poids aux diffĂ©rences de luminositĂ© (cas frĂ©quent dans l’industrie textile), tandis que k_c ou k_h peuvent ĂȘtre rĂ©duits pour augmenter la tolĂ©rance aux variations de saturation ou de teinte, en fonction des besoins. Selon le contexte, ces coefficients sont gĂ©nĂ©ralement compris entre 0,5 et 2.

Précision et fiabilité du code source

La diffĂ©rence entre la formulation acadĂ©mique de Sharma et la formulation simplifiĂ©e de Lindbloom ne dĂ©passe pas ±0,0003 sur le ΔE2000 final. Cela correspond Ă  la diffĂ©rence habituellement mesurĂ©e entre deux implĂ©mentations 32 bits et est imperceptible Ă  l’Ɠil humain. Nos implĂ©mentations 64 bits, toutes cohĂ©rentes entre elles, garantissent au moins 10 dĂ©cimales correctes, de sorte que le choix d’une formulation par rapport Ă  l’autre est un dĂ©tail technique. La formule par dĂ©faut sur cette page est celle qui est le plus souvent prĂ©sentĂ©e dans la communautĂ©, elle est lĂ©gĂšrement plus facile Ă  vectoriser.

✎ Si vous constatez que les commentaires dans le code source ne correspondent pas aux commentaires en anglais, veuillez en informer l’auteur de la page afin que cela soit corrigĂ©.

Comment convertir les couleurs RGB en L*a*b* ?

Vous devrez utiliser l’espace colorimĂ©trique intermĂ©diaire XYZ pour la conversion, et si vous avez besoin d’aide, le code source est fourni au bas de cette page (en utilisant le point blanc D65 formalisĂ© en 1964).

Plages de valeurs dans CIELAB et interprĂ©tation du ΔE2000

Dans l’espace colorimĂ©trique CIELAB, la composante L* reprĂ©sente la luminositĂ© et varie de 0 (noir) Ă  100 (blanc). Les composantes a* et b* dĂ©crivent les axes de couleur : a* s’étend du vert au rouge, tandis que b* va du bleu au jaune. Dans la pratique, les valeurs de a* et b* se situent dans la plage -128 Ă  +127, mĂȘme si elles peuvent lĂ©gĂšrement dĂ©passer ces limites selon les conversions colorimĂ©triques.

Exemple de deux couleurs présentant une différence à peine perceptible (JND) selon CIEDE2000
Couleur 1Couleur 2Valeur de ΔE2000
1
2
3
Exemples de valeurs CIEDE2000 calculées entre deux couleurs distinctes
Couleur 1Couleur 2Valeur de ΔE2000
5
10
15

Le ΔE2000 (CIEDE2000) quantifie la diffĂ©rence perceptuelle entre deux couleurs : 0 signifie deux couleurs identiques, et des valeurs plus Ă©levĂ©es (jusqu’à environ 185 dans les cas extrĂȘmes) indiquent une diffĂ©rence plus marquĂ©e. Par exemple, une valeur ΔE2000 autour de 5 correspond Ă  des couleurs proches, tandis qu’une valeur autour de 15 correspond Ă  des couleurs clairement distinctes.

Exemple d’utilisation en Python

# L*a*b* coordinates for first color
l1, a1, b1 = 29.2, 9.8, 3.7
# L*a*b* coordinates for second color
l2, a2, b2 = 31.8, 25.6, -4.6

delta_e = ciede_2000(l1, a1, b1, l2, a2, b2)
print(delta_e)

# .................................................. This shows a ΔE2000 of 6.5165064755
# As explained in the comments, compliance with Gaurav Sharma would display 6.5164865319

Résultats des tests

Le driver écrit en langage C99, doté de 250 tests statiques précis, a prouvé que cette fonction Python est interopérable avec la fonction CIEDE2000 mise à disposition dans les autres langages de programmation.

CIEDE2000 Verification Summary :
  First Verified Line : 73,42,15,53.7,-9.04,-51.3,51.254604281273956
             Duration : 54.14 s
            Successes : 10000000
               Errors : 0
      Average Delta E : 62.9478
    Average Deviation : 3.4565876161352096e-15
    Maximum Deviation : 8.5265128291212022e-14

Fichiers à télécharger

Utilisez librement ces fichiers mis Ă  disposition par Michel, mĂȘme Ă  des fins commerciales.

Statistiques du site : téléchargements
FichierTailleNombre de clics
ciede-2000.py4 KB126
ciede-2000-driver.py5 KB119
ciede-2000-numpy.py10 KB5
ciede-2000-random.py5 KB127
compare-hex-colors.py8 KB171
compare-rgb-colors.py8 KB169
test-py.yml3 KB86
vs-colormath.yml4 KB76
vs-colour-science.yml5 KB192
vs-mathics.yml4 KB72
reference-dataset.txt4 KB373
Cliquez sur py.zip pour télécharger tous ces fichiers dans une archive.

Communauté

Que pensez-vous de ce code source ou de CIEDE2000 ? Votre avis nous intĂ©resse ! Ce site web spĂ©cialisĂ© comporte un livre d’or qui inclut dĂ©jĂ  9 messages dont 1 en français. Faites-y un tour et partagez votre avis.