raw_black_level — GFX2D isp op

• Data kinds: image2d → image2d

• Call: import fullseye as fs; fs.ledger.raw_black_level(raw, offsets, white=1.0, pattern='RGGB') (implementation को सीधे call करना हो तो import gfx2d; gfx2d.raw_black_level(raw, offsets, white=1.0, pattern='RGGB'), registry से लेना हो तो opsgfx2d.get("raw_black_level"))

उपयोग

Bayer frame पर black-level compensation: हर colour channel के लिए (raw - offset) / (white - offset), [0, 1] पर clip किया गया।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

A sensor's dark output is not zero (pedestal + dark current); every later stage that multiplies (gains, CCM) would scale that pedestal into a colour cast, so this runs first. *offsets* is a scalar, 3 values (R, G, B) or 4 values (R, G1, G2, B) in the same [0, 1] units as *raw*; *white* is the saturation level, so a pixel at *white* maps to exactly 1.

Ground truth: a frame built as offset + k * signal comes back as k * signal / (white - offset) to 1e-15; a pixel at the offset maps to 0. Raises ValueError: non-finite input, an offset >= white, or an unknown *pattern*.

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• raw_to_display_isp — py -3.11 examples/raw_to_display_isp.py

वे अगले ops जिनसे type जुड़ता है (image2d को input के रूप में लेते हैं)

shadow_cast_2d · dither · raw_dead_pixel_mask · raw_dead_pixel_correct · lens_shading_gain · lens_shading_correct · raw_apply_gains · raw_demosaic_bilinear

इसी category के (isp)

raw_dead_pixel_mask · raw_dead_pixel_correct · lens_shading_gain · lens_shading_correct · awb_gains · rgb_apply_gains · raw_apply_gains · raw_demosaic_bilinear


*Provenance: gfx2d.py — GFX2D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.