cif_read — DRIVE pxrd op

• 資料種類:any → table

• 呼叫: import fullseye as fs; fs.ledger.cif_read(cif, name=None, default_b=0.5)(要直接呼叫實作,import pxrd; pxrd.cif_read(cif, name=None, default_b=0.5);從台帳取用則 opsdrive.get("cif_read"))

用法

讀取 CIF(晶體結構的標準格式)，回傳展開到晶胞內全部原子的「物相」。

cif 為檔案路徑或 CIF 本文(字串。若含 data_ 或 _cell_length_a 則視為本文)。

讀取內容: _cell_length_a/b/c、_cell_angle_alpha/beta/gamma、對稱操作的迴圈(_space_group_symop_operation_xyz 或 _symmetry_equiv_pos_as_xyz,若無則只有恆等)、原子的迴圈(_atom_site_fract_x/y/z、_atom_site_type_symbol(若無則取標籤開頭的元素符號)、_atom_site_occupancy (預設 1)、_atom_site_U_iso_or_equiv 或 _atom_site_B_iso_or_equiv(若無則 default_b [Ų]))。數值不確定度的括號(4.76050(5))會去掉。對稱操作以自製的小型語法分析讀取,不使用 eval。

回傳值(dict,相): name、cell(a, b, c [Å], α, β, γ [deg])、volume [ų]、atoms(展開後原子的

list: type、xyz、occ、B)、cell_mass [g/mol]、density [g/cm³]、notes(以中性原子代替的離子等)、source(若有 DOI 與 COD 編號)。為 powder_reflections 與 phase_dictionary 的輸入。

Raises ValueError: 沒有晶格常數、非數值,無法讀取對稱操作,沒有原子,沒有散射因子的元素。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_pxrd_phase_peel — py -3.11 examples/poc_pxrd_phase_peel.py

型別可銜接的下一個運算子(可接受 table 作為輸入)

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

同類別(pxrd)

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

*Provenance: pxrd.py — DRIVE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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