film op• Data kinds: pairs → table
• Call: import fullseye as fs; fs.ledger.film_thickness_fft(spectrum, film='SIO2', window='hann', pad_factor=16) (implementation को सीधे call करना हो तो import filmoptics; filmoptics.film_thickness_fft(spectrum, film='SIO2', window='hann', pad_factor=16), registry से लेना हो तो opsoptics.get("film_thickness_fft"))
reflectance spectrum की interference fringes की अवधि से film की मोटाई (FFT विधि); dispersion को material table के n(λ) से सुधारा जाता है।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
spectrum: pairs(λ [nm], R)。等間隔でなくてよい。
film: 膜の材料(鍵・数値)。縞の位相は 4π n(λ) d / λ = 2π d x、x = 2 n(λ)/λ [1/nm] なので、x の等間隔格子に
取り直してから FFT すると、ピークの周波数がそのまま膜厚 d [nm] になる(分散の補正込み)。
window: "hann"(既定、漏れが小さい)/ "rect"(主ローブが細い)。
pad_factor: ゼロ詰めの倍率(ピークの位置を細かく読む。分解能は増えない)。
返り値 dict: thickness_nm / peak_amplitude / span_x(x の幅 Δx [1/nm])/ n_fringes(= d·Δx、帯域に入る縞の本数)/
resolution_nm(= 1/Δx、2 つの膜厚を見分ける幅)/ min_thickness_nm(この窓の主ローブの半幅 = 測れる下限の閉形式:
hann 2/Δx、rect 1/Δx)/ reliable(d ≥ min_thickness_nm)/ frequency_nm と magnitude(FFT の振幅スペクトル)。
★下限は閉形式で先に分かる: 帯域 λ₁〜λ₂ の縞の本数は 2 n̄ d (1/λ₁ − 1/λ₂)。窓の主ローブ(DC の山)よりピークが外に出ないと、FFT 法は DC に引きずられて系統的に外れる(薄い膜ではモデルあてはめを使う)。
optics के सभी ops गणना से पहले input की जाँच करते हैं (कुछ भी चुपचाप पास नहीं होता):
• Unit argument के नाम में ही लिखी होती है — _mm / _um / _deg / _mrad। mm और µm की गड़बड़ी crash नहीं करती, बल्कि "सही दिखने वाला पर गलत उत्तर" देती है, इसलिए नाम से इसे रोका जाता है। मान के आकार से unit का अनुमान बिल्कुल नहीं लगाया जाता।
• String से ValueError — float('50') सफल हो जाता है, इसलिए बिना parse किया config value length के रूप में निकल जाता (मापा गया: thin_lens('50', '200') सही दिखने वाला 66.667 mm लौटा रहा था)। bool को भी True == 1 वाले implicit promotion के रूप में अस्वीकार किया जाता है।
• complex / masked array से ValueError (केवल real-valued slots; imaginary part को चुपचाप छोड़ना या mask हटाना अस्वीकार)। हर input पर NaN/Inf से ValueError।
• शून्य से भाग और उससे जुड़े मामलों को नाम लेकर अस्वीकार किया जाता है: focal length 0, radius of curvature 0, refractive index <= 0, पूरी तरह opaque aperture (सब 0, इसलिए normalisation 0/0), ऐसा PSF जिसका योग <= 0 हो, S0 = 0 वाला Stokes vector, और front focal point पर रखा object (image अनंत पर)।
• केवल 2 ops non-finite value लौटाते हैं, और वह भी contract के रूप में लिखा हुआ: depth_of_field hyperfocal distance से आगे far_mm = inf (hyperfocal distance की परिभाषा यही है) और gaussian_beam waist पर wavefront_radius_mm = inf (plane wavefront की radius of curvature)। दोनों साथ में एक finite साथी (far_is_infinite / curvature_per_mm) भी लौटाते हैं। इसके अलावा कोई भी चुपचाप आया NaN/Inf अंदर ही पकड़ा जाता है और ValueError देता है — "float64 overflow हुआ" और "उत्तर अनंत है" अलग-अलग दावे हैं, इसलिए पहले को दूसरे का चेहरा पहनाकर नहीं लौटाया जाता।
• Size की सीमा: generate होने वाले grid के लिए optics.MAX_GRID (4096), दिए गए field/PSF/aperture के लिए optics.MAX_FIELD_ELEMENTS (2^24), ABCD element chain के लिए optics.MAX_SYSTEM_ELEMENTS (1024), Zernike के लिए MAX_ZERNIKE_TERMS (512) / MAX_ZERNIKE_ORDER (40) / MAX_ZERNIKE_BASIS (2^25)। छोटे argument से बहुत बड़ा internal allocation होने वाले रास्तों (मापा गया: n_max=40 × 4096² पर 108 GB) को fail-closed ढंग से बंद किया गया है।
• भौतिक रूप से असंभव states भी अस्वीकार: degree of polarisation > 1 वाला Stokes vector, ऋणात्मक transmittance, ऋणात्मक intensity, और n-|m| odd जैसे अमान्य Zernike indices।
• 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 में दिए गए हैं।
• poc_thin_film_reflectometry — py -3.11 examples/poc_thin_film_reflectometry.py
table को input के रूप में लेते हैं)abcd_matrix · wavefront_stats · sfr_from_edge · paraxial_trace · seidel_coefficients · spot_stats · tolerance_analysis · wavefront_from_opd
film)multilayer_reflectance · film_color · film_thickness_fit · film_thickness_map
*Provenance: filmoptics.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.