phase_fractions — DRIVE pxrd op

• データ種: signal × signal × table → table

• 呼び出し: import fullseye as fs; fs.ledger.phase_fractions(two_theta, intensity, dictionary, background_order=4, sigma=None, lattice_tolerance=0.0, phases=None) (実装を直接呼ぶなら import pxrd; pxrd.phase_fractions(two_theta, intensity, dictionary, background_order=4, sigma=None, lattice_tolerance=0.0, phases=None)、台帳から引くなら opsdrive.get("phase_fractions"))

使い方

非負の最小二乗(NNLS)で混合物の相分率を出す(背景は Chebyshev の多項式で同時に当てる)。

y ≈ Σ sₚ Rₚ(2θ) + Σ cₖ Tₖ(2θ)、sₚ >= 0、cₖ は符号自由(scipy.optimize.lsq_linear の BVLS)。体積分率 vₚ ∝ sₚ、重量分率 Wₚ ∝ sₚ ρₚ(module の docstring)。sigma を渡せば 1/σ で重みを付ける。lattice_tolerance > 0 なら相ごとに格子の倍率を 1 ± tolerance の中で黄金分割の座標降下で追い込む(参照の格子定数と試料の格子定数がずれていると、山が半分ずれた参照は倍率が下がり分率が偏る —— 罠の門を参照)。phases で辞書の一部の名前だけを使う。

返り値(dict): names・scale・volume_fraction・weight_fraction・lattice_scale・fit・ background・residual・rwp(重みつきの相対残差)・two_theta・wavelength。

Raises ValueError: 長さの不一致、辞書の格子と 2θ の不一致、背景の次数が負、未知の相の名前。

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• poc_pxrd_phase_peel — py -3.11 examples/poc_pxrd_phase_peel.py

型が繋がる次の op(table を入力に取れる)

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

同カテゴリ(pxrd)

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

*Provenance: pxrd.py — DRIVE operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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