Реализация CIEDE2000 на PowerShell

На этой странице представлена эталонная реализация формулы цветовой разницы CIEDE2000 на PowerShell. Если вы хотите получить точное совпадение со сторонними реализациями до 10 знаков после запятой, вам может потребоваться внести некоторые изменения в исходный код, в частности, закомментировать и разкомментировать несколько строк, которые могут быть применены автоматически по ссылке ниже.

Функция ΔE2000 в PowerShell

Рассмотрим более распространенную и академическую (Sharma, 2005) из двух формулировок.

# This function written in PowerShell is not affiliated with the CIE (International Commission on Illumination),
# and is released into the public domain. It is provided "as is" without any warranty, express or implied.

# The classic CIE ΔE2000 implementation, which operates on two L*a*b* colors, and returns their difference.
# "l" ranges from 0 to 100, while "a" and "b" are unbounded and commonly clamped to the range of -128 to 127.
function ciede_2000 {
	param(
		[double]$l_1, [double]$a_1, [double]$b_1,
		[double]$l_2, [double]$a_2, [double]$b_2
	)
	# Working in PowerShell with the CIEDE2000 color-difference formula.
	# k_l, k_c, k_h are parametric factors to be adjusted according to
	# different viewing parameters such as textures, backgrounds...
	$k_l = 1.0
	$k_c = 1.0
	$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
	# A factor involving chroma raised to the power of 7 designed to make
	# the influence of chroma on the total color difference more accurate.
	$n = 1.0 + 0.5 * (1.0 - [math]::Sqrt($n / ($n + 6103515625.0)))
	# Application of the chroma correction factor.
	$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)
	# atan2 is preferred over atan because it accurately computes the angle of
	# a point (x, y) in all quadrants, handling the signs of both coordinates.
	$h_1 = [math]::Atan2($b_1, $a_1 * $n)
	$h_2 = [math]::Atan2($b_2, $a_2 * $n)
	$h_1 = $h_1 + 2.0 * [math]::PI * ($h_1 -lt 0.0)
	$h_2 = $h_2 + 2.0 * [math]::PI * ($h_2 -lt 0.0)
	$n = [math]::Abs($h_2 - $h_1)
	# Cross-implementation consistent rounding.
	if (([math]::PI - 1E-14) -lt $n -and $n -lt ([math]::PI + 1E-14)) {
		$n = [math]::PI
	}
	# When the hue angles lie in different quadrants, the straightforward
	# average can produce a mean that incorrectly suggests a hue angle in
	# the wrong quadrant, the next lines handle this issue.
	$h_m = ($h_1 + $h_2) * 0.5
	$h_d = ($h_2 - $h_1) * 0.5
	if ([math]::PI -lt $n) {
		$h_d += [math]::PI;
  		# 📜 Sharma’s formulation doesn’t use the next line, but the one after it,
		# and these two variants differ by ±0.0003 on the final color differences.
		$h_m += [math]::PI;
  		# $h_m += if ($h_m -lt [Math]::PI) { [Math]::PI } else { -[Math]::PI }
	}
	$p = 36.0 * $h_m - 55.0 * [math]::PI
	$n = ($c_1 + $c_2) * 0.5
	$n = $n * $n * $n * $n * $n * $n * $n
	# The hue rotation correction term is designed to account for the
	# non-linear behavior of hue differences in the blue region.
	$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)
	# Lightness.
	$l = ($l_2 - $l_1) / ($k_l * (1.0 + 0.015 * $n / [math]::Sqrt(20.0 + $n)))
	# These coefficients adjust the impact of different harmonic
	# components on the hue difference calculation.
	$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
	# Hue.
	$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))
	# Returning the square root ensures that dE00 accurately reflects the
	# geometric distance in color space, which can range from 0 to around 185.
	return [math]::Sqrt($l * $l + $h * $h + $c * $c + $c * $h * $r_t)
}

# GitHub Project : https://github.com/michel-leonard/ciede2000-color-matching
#   Online Tests : https://michel-leonard.github.io/ciede2000-color-matching

# L1 = 51.5   a1 = 45.3   b1 = 4.8
# L2 = 51.1   a2 = 39.1   b2 = -3.9
# CIE ΔE00 = 5.1828681439 (Bruce Lindbloom, Netflix’s VMAF, ...)
# CIE ΔE00 = 5.1828865362 (Gaurav Sharma, OpenJDK, ...)
# Deviation between implementations ≈ 1.8e-5

# See the source code comments for easy switching between these two widely used ΔE*00 implementation variants.

Точность и надежность исходного кода

Разница между формулировками Шармы и Линдблума никогда не превышает ±0,0003 по финальному ΔE2000, что соответствует обычной разнице между двумя 32-битными реализациями и незаметно для невооружённого глаза. Наши 64-битные реализации, все согласованные между собой, гарантируют как минимум 10 правильных десятичных знаков, поэтому выбор одной формулы вместо другой в основном зависит от желаемой совместимости. Наиболее часто используется формула, которая по умолчанию отображается на этой странице (ее микродостоинство в том, что она основана на сообществе и при векторизации легче своего аналога).

✎ Если вы обнаружили в исходном коде комментарий, который не соответствует другому языку, пожалуйста, сообщите об этом автору сайта, который изучит ваше предложение и включит его в исходный код.

Как преобразовать цвета RGB в L*a*b*?

Перейдите на страницу AWK, C, Dart, Java, JavaScript, Kotlin, Lua, PHP, Python, Ruby или Rust, где такой конвертер (с использованием осветителя D65) уже реализован в дополнение к функции сравнения цветов.

Диапазоны значений в CIELAB и интерпретация ΔE2000

В цветовом пространстве CIELAB компонент L* обозначает светлоту и обычно изменяется от 0 (черный) до 100 (белый). Компоненты a* и b* описывают цветовые оси: a* идет от зеленого к красному, а b* — от синего к желтому. На практике значения a* и b* чаще всего находятся в диапазоне от -128 до +127, хотя в зависимости от конверсии они могут немного выходить за эти пределы.

Параметры k_l, k_c и k_h

Параметры k_l, k_c и k_h являются весовыми коэффициентами, применяемыми к компонентам яркости (ΔL*), хроматичности (ΔC*) и оттенка (ΔH*) в формуле CIEDE2000. Их значение по умолчанию — 1, что соответствует стандартным условиям наблюдения, рекомендованным Международная комиссия по освещению. На практике эти коэффициенты настраиваются для отражения конкретных условий: например, k_l = 2 иногда используется для придания большего веса различиям яркости (часто в печати), тогда как k_c или k_h могут быть уменьшены для повышения допустимости вариаций насыщенности или оттенка в зависимости от требований контроля качества. В зависимости от контекста эти коэффициенты обычно варьируются от 0,5 до 2.

ΔE2000 (CIEDE2000) измеряет воспринимаемую разницу между двумя цветами: 0 означает идентичные цвета, а более высокие значения (до примерно 185 в крайних случаях) показывают большую разницу. Например, значение ΔE2000 около 5 означает близкие цвета, а около 15 — явно разные.

Пример использования в PowerShell

Иногда необходимо : Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

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

. .\ciede-2000.ps1

$dE = ciede_2000 26.2 31.1 4.9 26.1 26.8 -3.7
Write-Output $dE

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

Результаты испытаний

Драйвер, написанный на языке C99, с помощью 250 точных статических тестов доказал, что эта функция PowerShell совместима с функцией CIEDE2000, доступной на других языках программирования.

CIEDE2000 Verification Summary :
  First Verified Line : 22,-120,28,87.18,-87,-33.18,67.02466305752021
             Duration : 1221.15 s
            Successes : 10000000
               Errors : 0
      Average Delta E : 63.0540
    Average Deviation : 4.1e-15
    Maximum Deviation : 1.6e-13

Файлы для загрузки

Не стесняйтесь использовать эти файлы, предоставленные Мишелем, даже в коммерческих целях.

Сообщество

Если вы хотите оставить своё мнение об этом исходном коде PowerShell или о CIEDE2000 в целом, то в гостевой книге уже есть 1 сообщения на русском языке и 9 сообщений в целом, так что, пожалуйста, дайте нам знать, что вы думаете по этому поводу.