rgb_to_xyz — IMGMETRICS `colorspace` op

• Datenarten: rgbimage → rgb

• Aufruf: import fullseye as fs; fs.ledger.rgb_to_xyz(rgb) (die Implementierung direkt: import imgmetrics; imgmetrics.rgb_to_xyz(rgb); aus dem Register: opsimgmetrics.get("rgb_to_xyz"))

Verwendung

sRGB ((..., 3)) → CIE XYZ. Zuerst wird die Übertragungsfunktion entfernt, dann die Matrix angewendet.

Ablauf: srgb_to_linear normiert Integer-dtypes auf [0, 1] und entfernt dabei die Übertragungsfunktion (IEC 61966-2-1), dann wird auf lineares RGB die 3x3-Matrix sRGB (D65)→XYZ angewendet. Weiß (1, 1, 1) wird auf (0.9505, 1.0, 1.0890) abgebildet (Skala mit Y auf 1 normiert).

• Eingabe: beliebige Form, solange die letzte Achse 3 ist (1 Farbe (3,), eine Farbtabelle (N, 3), ein Bild (H, W, 3)). Integer-dtypes (uint8/uint16 usw.) werden durch das dtype-Maximum geteilt. float außerhalb von [0, 1] ergibt MetricContractError (Untertyp von ValueError, siehe oben). Achtung: Übergibt man lineare Werte mit bereits entferntem Gamma, wird das Gamma doppelt entfernt.

• Rückgabewert: float64 in derselben Form wie die Eingabe.

• Fehler: letzte Achse nicht 3 / float außerhalb von [0, 1] / nicht endlich.

Üblicherweise folgt xyz_to_lab (zusammen rgb_to_lab).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie image_difference_metrics

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• colorimetry — Farbmetrik und Spektren — Farbe ist nur durch Spektrum × Lichtart × Beobachter bestimmt

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• image_quality_metrics — py -3.11 examples/image_quality_metrics.py

Typkompatible Folge-Operatoren (nehmen `rgb` als Eingabe)

xyz_to_lab · luma_limited_u8 · rank_data · tid2013_index

Gleiche Kategorie (`colorspace`)

rgb_to_lab · lab_to_rgb · xyz_to_lab

*Provenance: imgmetrics.py — IMGMETRICS Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

rgb_to_xyz — IMGMETRICS colorspace op