Implémentation de CIEDE2000 en Ruby

Version de la fonction : v1.0.0
Statistiques du site
Nombre de visites629
Nombre de fichiers consultés735 + 380

Cette page prĂ©sente une implĂ©mentation de rĂ©fĂ©rence de la formule de diffĂ©rence de couleur CIEDE2000 en Ruby. 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 Ruby

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

# Cette fonction écrite en Ruby 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)
	# Traite la formule de différence de couleurs CIEDE2000 en Ruby.
	# 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 = (Math.sqrt(a_1 * a_1 + b_1 * b_1) + Math.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 - Math.sqrt(n / (n + 6103515625.0)))
	# Application du facteur de correction de la chroma pour compenser sa non-linéarité.
	c_1 = Math.sqrt(a_1 * a_1 * n * n + b_1 * b_1)
	c_2 = Math.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 = Math.atan2(b_1, a_1 * n)
	h_2 = Math.atan2(b_2, a_2 * n)
	h_1 += 2.0 * Math::PI if h_1 < 0.0
	h_2 += 2.0 * Math::PI if h_2 < 0.0
	n = (h_2 - h_1).abs
	# Prévient le branchement de dépendre du RoundingMode du langage de programmation.
	n = Math::PI if Math::PI - 1E-14 < n && n < Math::PI + 1E-14
	# 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 Math::PI < n
		h_d += Math::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 += Math::PI
		# h_m += h_m < Math::PI ? Math::PI : -Math::PI
	end
	p = 36.0 * h_m - 55.0 * Math::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 * Math.sqrt(n / (n + 6103515625.0)) \
		* Math.sin(Math::PI / 3.0 * Math.exp(p * p / (-25.0 * Math::PI * Math::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 / Math.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 * Math.sin(2.0 * h_m + Math::PI * 0.5) \
		+ 0.32 * Math.sin(3.0 * h_m + 8.0 * Math::PI / 15.0) \
		- 0.17 * Math.sin(h_m + Math::PI / 3.0) \
		- 0.20 * Math.sin(4.0 * h_m + 3.0 * Math::PI / 20.0)
	n = c_1 + c_2
	# Teinte.
	h = 2.0 * Math.sqrt(c_1 * c_2) * Math.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.
	Math.sqrt(l * l + h * h + c * c + c * h * r_t)
end

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

# L1 = 65.7   a1 = 54.9   b1 = -2.4
# L2 = 66.9   a2 = 48.8   b2 = 2.4
# CIE ΔE00 = 3.1475316605 (Bruce Lindbloom, Netflix’s VMAF, ...)
# CIE ΔE00 = 3.1475185150 (Gaurav Sharma, OpenJDK, ...)
# Écart entre les implĂ©mentations ≈ 1.3e-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 la formule CIEDE2000 sont des facteurs de pondĂ©ration appliquĂ©s respectivement aux composantes de luminositĂ© (ΔL*), de chroma (ΔC*) et de teinte (ΔH*). Dans le code source, ils sont dĂ©finis comme des constantes dont la valeur par dĂ©faut est 1, ce qui correspond aux conditions d’observation standard prĂ©vues 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 rĂ©sumĂ©, ces coefficients varient gĂ©nĂ©ralement entre 0,5 et 2, la valeur la plus courante Ă©tant 1.

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. L’implĂ©mentation prĂ©sentĂ©e sur cette page est en 64 bits et garantit au moins 10 dĂ©cimales exactes ; le choix d’une formulation plutĂŽt qu’une autre relĂšve donc d’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 des incohĂ©rences aprĂšs avoir comparĂ© les textes français et anglais, veuillez en informer l’auteur de la page afin que des corrections puissent ĂȘtre apportĂ©es.

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* sont presque toujours comprises entre -128 et +127, bien que la norme ne fixe pas de limite officielle pour ces deux composantes.

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’à 185 et plus) 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. Lorsque la valeur ΔE2000 dépasse 40, les couleurs comparées n’ont pratiquement plus rien en commun, et nous ne pouvons plus en tirer d’informations précises.

Exemple d’utilisation en Ruby

# Compute the Delta E (CIEDE2000) color difference between two L*a*b* colors in Ruby

# Color 1: l1 = 62.6   a1 = 19.4   b1 = -1.8
# Color 2: l2 = 62.5   a2 = 24.5   b2 = 3.3

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

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

Résultats des tests

Notre programme de tests, écrit en C99, comprend 250 tests statiques précis. Les résultats montrent que cette fonction CIEDE2000 en Ruby est interopérable avec les 41 autres langages de programmation.

CIEDE2000 Verification Summary :
  First Verified Line : 4.54,-122,-35,10,116.6,91.92,86.21001308276066766
             Duration : 45.80 s
            Successes : 10000000
               Errors : 0
      Average Delta E : 62.9465
    Average Deviation : 3.4328080100731738e-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.rb4 KB99
ciede-2000-driver.rb5 KB115
ciede-2000-random.rb5 KB98
compare-hex-colors.rb8 KB99
compare-rgb-colors.rb8 KB107
vs-model.rb5 KB97
test-rb.yml3 KB56
vs-colorscore.yml4 KB64
reference-dataset.txt4 KB380
Cliquez sur rb.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.