telecentric op• Data kinds: table → table
• Call: import fullseye as fs; fs.ledger.chief_ray_angle(system, field_mm=5.0, object_shift_mm=0.0) (implementation को सीधे call करना हो तो import telecentric; telecentric.chief_ray_angle(system, field_mm=5.0, object_shift_mm=0.0), registry से लेना हो तो opsoptics.get("chief_ray_angle"))
*field_mm* ऊँचाई के object point से stop के केंद्र से गुज़रने वाली वास्तविक chief ray: object side का झुकाव (telecentricity) और image पर उसकी स्थिति।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
入射瞳を経由せず、絞りの面で光線の高さが 0 になる打ち出しの傾きを Newton 法で探す(口径を外した複製で狙い、最後に口径つきで追って蹴られを判定する)。だから入射瞳が無限遠(物体側テレセン)でも物体の裏(ハイパーセントリック)でも同じ式で動く。*object_shift_mm* は物体をレンズへ近づける量(正 = 高い面)。
返り値: object_angle_deg(物体側の主光線の傾き。光軸から離れる向きが正に符号を揃える: 通常のレンズは負、物体側テレセンは 0、ハイパーセントリックは正)・object_slope(dy/dz そのもの)・image_angle_deg(像側)・ image_y_mm(固定した像面での高さ)・magnification(image_y / field)・pupil_distance_mm (物体面から主光線が光軸と交わる点 = 実光線の入射瞳までの距離。正 = レンズ側、平行なら inf)・ valid(口径つきで像面まで届いたか)・stop_residual_mm・iterations。
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_optics_drawings — py -3.11 examples/poc_optics_drawings.py
• poc_telecentric_metrology — py -3.11 examples/poc_telecentric_metrology.py
table को input के रूप में लेते हैं)abcd_matrix · wavefront_stats · sfr_from_edge · paraxial_trace · seidel_coefficients · spot_stats · tolerance_analysis · wavefront_from_opd
telecentric)telecentric_lens · magnification_vs_depth · telecentricity_error · defocus_spot_vs_depth · vignetting_vs_field · lens_equivalent_pinhole
*Provenance: telecentric.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.