awb_gains — GFX2D isp op

• Data kinds: rgb → vector

• Call: import fullseye as fs; fs.ledger.awb_gains(rgb, method='gray_world', percentile=99.0) (implementation को सीधे call करना हो तो import gfx2d; gfx2d.awb_gains(rgb, method='gray_world', percentile=99.0), registry से लेना हो तो opsgfx2d.get("awb_gains"))

उपयोग

g_G = 1 के साथ white-balance gain (g_R, g_G, g_B) का अनुमान लगाता है।

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

method="gray_world": the scene averages to grey, so g_c = mean_G / mean_c (Buchsbaum, 1980). method="white_patch": the brightest surfaces are white, so g_c = P_G / P_c with P the *percentile* (default 99, i.e. not the single hottest pixel) of each channel. Both are closed forms; neither is right for every scene (a red wall breaks gray-world, a coloured light breaks white-patch) and the docstring says so rather than picking one silently. Apply with rgb_apply_gains or, on the mosaic, raw_apply_gains.

Ground truth: after applying gray-world gains the three channel means are equal to 1e-12; after white-patch gains the three percentiles are equal. Raises ValueError: unknown *method*, a channel whose statistic is 0 (no gain can be defined), or a *percentile* outside (0, 100].

संदर्भ (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 जुड़ता है (vector को input के रूप में लेते हैं)

rgb_apply_gains · raw_apply_gains

इसी category के (isp)

raw_black_level · raw_dead_pixel_mask · raw_dead_pixel_correct · lens_shading_gain · lens_shading_correct · 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.