5a24289898fd
nrc-metrics.py
#!/usr/bin/env python3
"""Compare colour NR exports using spatial quadrants and one fixed reference mask.
PNG comparisons assess the displayed result, not an unclipped float ground truth.
Usage: python3 tools/nrc-metrics.py REF.png VARIANT.png ... [--crop X Y W H]
"""
import argparse
import json
from pathlib import Path
import numpy as np
from PIL import Image
def linear(p):
p = np.asarray(p, dtype=np.float64) / 255.0
return np.where(p <= 0.04045, p / 12.92, ((p + 0.055) / 1.055) ** 2.4)
def lab(p):
p = linear(p)
xyz = p @ np.array([[0.4124, 0.2126, 0.0193], [0.3576, 0.7152, 0.1192], [0.1805, 0.0722, 0.9505]])
xyz /= np.array([0.95047, 1.0, 1.08883])
f = np.where(xyz > 0.008856, np.cbrt(xyz), 7.787 * xyz + 16 / 116)
return np.stack((116 * f[..., 1] - 16, 500 * (f[..., 0] - f[..., 1]), 200 * (f[..., 1] - f[..., 2])), axis=-1)
def tiles(reference):
"""Four actual 48x48 quadrants; tiles selected only on the reference."""
result = []
for y in range(0, reference.height - 95, 192):
for x in range(0, reference.width - 95, 192):
p = linear(reference.crop((x, y, x + 96, y + 96)))[::4, ::4]
luminance = p @ np.array([0.2126, 0.7152, 0.0722])
mean = luminance.mean()
lightness = 116 * (np.cbrt(mean) if mean > 0.008856 else 7.787 * mean + 16 / 116) - 16
quadrants = luminance.reshape(2, 12, 2, 12).mean(axis=(1, 3))
if 6 <= lightness <= 25 and np.ptp(quadrants) < 0.15 * mean:
result.append((x, y))
return result[:60]
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("files", nargs="+")
parser.add_argument("--crop", nargs=4, type=int, default=[1325, 2085, 360, 240])
args = parser.parse_args()
reference = Image.open(args.files[0]).convert("RGB")
regions = tiles(reference)
x, y, w, h = args.crop
box = (x, y, x + w, y + h)
if x < 0 or y < 0 or w <= 0 or h <= 0 or x + w > reference.width or y + h > reference.height:
parser.error("crop must lie inside the image")
ref_lab = lab(reference.crop(box))
mask = ref_lab[..., 0] > 20
if not mask.any():
parser.error("crop contains no reference pixels with L* > 20")
reference_ab = ref_lab[..., 1:][mask].mean(axis=0)
reference_c = np.linalg.norm(ref_lab[..., 1:][mask], axis=-1).mean()
records = []
for file in args.files:
image = Image.open(file).convert("RGB")
if image.size != reference.size:
parser.error(f"size differs from reference: {file}")
spreads, blotches, means = [], [], []
for tx, ty in regions:
patch = np.asarray(image.crop((tx, ty, tx + 96, ty + 96)))
ab = lab(patch)[..., 1:]
spreads.append(np.sqrt(ab.var(axis=(0, 1)).sum()))
blocks = ab.reshape(12, 8, 12, 8, 2).mean(axis=(1, 3))
blotches.append(np.sqrt(blocks.var(axis=(0, 1)).sum()))
means.append(linear(patch).mean(axis=(0, 1)))
ab = lab(image.crop(box))[..., 1:][mask]
mean_ab = ab.mean(axis=0)
records.append({
"file": str(Path(file)), "flat_tiles": len(regions),
"spread": float(np.mean(spreads)) if spreads else None,
"blotch": float(np.mean(blotches)) if blotches else None,
"dark_rgb": np.mean(means, axis=0).tolist() if means else None,
"crop_mean_ab": mean_ab.tolist(),
"crop_mean_colour_delta": float(np.linalg.norm(mean_ab - reference_ab)),
"crop_mean_chroma_percent": float(100 * np.linalg.norm(mean_ab) / max(np.linalg.norm(reference_ab), 1e-12)),
"crop_pixel_chroma_percent": float(100 * np.linalg.norm(ab, axis=-1).mean() / max(reference_c, 1e-12)),
"crop_hue_delta_degrees": float(np.degrees(np.arctan2(np.sin(np.arctan2(mean_ab[1], mean_ab[0]) - np.arctan2(reference_ab[1], reference_ab[0])), np.cos(np.arctan2(mean_ab[1], mean_ab[0]) - np.arctan2(reference_ab[1], reference_ab[0]))))),
})
print(json.dumps({"reference": args.files[0], "crop": args.crop, "results": records}, indent=2))
if __name__ == "__main__":
main()
No file is open. Choose one in the tree, or press Ctrl+O (⌘O on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.