Implémentation de CIEDE2000 en C#
| Nombre de visites | 751 |
|---|---|
| Nombre de fichiers consultés | 547 + 376 |
Cette page prĂ©sente une implĂ©mentation de rĂ©fĂ©rence de la formule de diffĂ©rence de couleur CIEDE2000 en C#. 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.
La fonction ΔE2000 en C#
Considérons la plus courante et académique (Sharma, 2005) des deux formulations.
// Cette fonction écrite en C# 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.
static double ciede_2000(double l_1, double a_1, double b_1, double l_2, double a_2, double b_2) {
// Traite la formule de différence de couleurs CIEDE2000 en C# (.NET Core).
// k_l, k_c et k_h sont des facteurs paramĂ©triques quâon ajuste
// selon des recommandations propres au secteur industriel.
const double k_l = 1.0, k_c = 1.0, k_h = 1.0;
double 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é.
double c_1 = Math.Sqrt(a_1 * a_1 * n * n + b_1 * b_1);
double 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.
double h_1 = Math.Atan2(b_1, a_1 * n), h_2 = Math.Atan2(b_2, a_2 * n);
if (h_1 < 0.0) h_1 += 2.0 * Math.PI;
if (h_2 < 0.0) h_2 += 2.0 * Math.PI;
n = Math.Abs(h_2 - h_1);
// Prévient le branchement de dépendre du RoundingMode du langage de programmation.
if (Math.PI - 1E-14 < n && n < Math.PI + 1E-14)
n = Math.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.
double 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;
// if (h_m < Math.PI) h_m += Math.PI; else h_m -= Math.PI;
}
double 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.
double 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é.
double 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.
double 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.
double h = 2.0 * Math.Sqrt(c_1 * c_2) * Math.Sin(h_d) / (k_h * (1.0 + 0.0075 * n * t));
// Chroma.
double 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 Math.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 = 32.3 a1 = 41.7 b1 = -1.7
// L2 = 32.2 a2 = 35.7 b2 = 1.6
// CIE ÎE00 = 2.8793148397 (Bruce Lindbloom, Netflixâs VMAF, ...)
// CIE ÎE00 = 2.8793013851 (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 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* ?
Rendez-vous sur la page AWK, C, Dart, Java, JavaScript, Kotlin, Lua, PHP, Python, Ruby ou Rust oĂč un tel convertisseur (utilisant lâilluminant D65) est dĂ©jĂ implĂ©mentĂ© en plus de la fonction de comparaison de couleurs.
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.
| Couleur 1 | Couleur 2 | Valeur de ÎE2000 |
|---|---|---|
| 1 | ||
| 2 | ||
| 3 |
| Couleur 1 | Couleur 2 | Valeur 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 C#
// Compute the Delta E (CIEDE2000) color difference between two L*a*b* colors in C# (.NET Core)
double l1 = 95.3, a1 = 39.2, b1 = -1.7;
double l2 = 94.8, a2 = 45.0, b2 = 2.1;
double deltaE = ciede_2000(l1, a1, b1, l2, a2, b2);
Console.WriteLine(deltaE);
// .................................................. This shows a ΔE2000 of 2.8916930349
// As explained in the comments, compliance with Gaurav Sharma would display 2.8917067928Résultats des tests
Le driver écrit en langage C99, doté de 250 tests statiques précis, a prouvé que cette fonction C# est interopérable avec la fonction CIEDE2000 mise à disposition dans les autres langages de programmation.
CIEDE2000 Verification Summary :
First Verified Line : 65,44.1,69,8.3,-46.8,-22.9,72.86971426109767
Duration : 32.12 s
Successes : 10000000
Errors : 0
Average Delta E : 62.9416
Average Deviation : 4.2567882330146744e-15
Maximum Deviation : 1.1368683772161603e-13Fichiers à télécharger
Utilisez librement ces fichiers mis Ă disposition par Michel, mĂȘme Ă des fins commerciales.
| Fichier | Taille | Nombre de clics |
|---|---|---|
| ciede-2000.cs | 4 KB | 114 |
| ciede-2000-driver.cs | 5 KB | 105 |
| ciede-2000-random.cs | 6 KB | 102 |
| ciede-2000-single-precision.cs | 5 KB | 102 |
| test-cs.yml | 3 KB | 61 |
| vs-masuit-tools.yml | 5 KB | 63 |
| reference-dataset.txt | 4 KB | 376 |
| Cliquez sur cs.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.