detector_calibrate — DRIVE pxrd op

• Data kinds: image2d × signal × table → table

• Call: import fullseye as fs; fs.ledger.detector_calibrate(image, d_spacings, geometry_guess, n_azimuth=180, fit_tilt=True, min_rings=2) (implementation को सीधे call करना हो तो import pxrd; pxrd.detector_calibrate(image, d_spacings, geometry_guess, n_azimuth=180, fit_tilt=True, min_rings=2), registry से लेना हो तो opsdrive.get("detector_calibrate"))

उपयोग

ज्ञात standard (जैसे Si) के ring से detector का केंद्र, दूरी और झुकाव calibrate करता है।

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

d_spacings は標準の面間隔 [Å] の list(強い順でなくてよい)、geometry_guess には少なくとも pixel と

wavelength、分かっていれば cx・cy・distance・tilt・tilt_dir を入れる。手順:

1. 中心が無ければ明るい画素の重心から始め、最も強い環を光線に沿って拾い、円の当てはめで中心を 3 回更新する。

2. 距離が無ければ、半径方向のプロファイルの最初の山を d の候補(小さい 2θ から 4 本)に当て、他の環の予測と観測の山が最も多く一致する組を選ぶ。

3. 現在の幾何で各環の位置を n_azimuth 本の光線上で予測し、窓の中の強度の重心で点を拾い、scipy.optimize.least_squares で (cx, cy, distance, tilt の 2 成分) を 2θ の残差 [deg] で当てる。窓を縮めながら 3 回。傾きは回転ベクトルの 2 成分 tilt·(cos φ, sin φ) で解く(傾き 0 で φ が不定になる特異点を避ける)。

返り値(dict): 幾何(cx・cy・distance・pixel・wavelength・tilt・tilt_dir)に

rms_two_theta_deg・n_points・n_rings・rings_deg・ok(rms が画素 1/4 の角 0.25·pixel/distance 未満

かつ環 >= min_rings)を足したもの。

Raises ValueError: 像が 2-D でない、d が 1 本も無い、pixel / wavelength が無い、環が min_rings 本見つからない。

संदर्भ (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 करते हैं)

• poc_pxrd_phase_peel — py -3.11 examples/poc_pxrd_phase_peel.py

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

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

इसी category के (pxrd)

cif_read · cubic_prototype · powder_reflections · scherrer_size · debye_ring_image · detector_two_theta · azimuthal_integrate · diffraction_peaks


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

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