doseunif op• 資料種類:any × scalar × scalar → table
• 呼叫: import fullseye as fs; fs.ledger.dose_cv_from_sizes(sizes, dose_mg: 'float', density: 'float', estimator: 'str | None' = None, frame=None, ci: 'float' = 0.9, n_boot: 'int' = 400, seed: 'int' = 0) -> 'dict'(要直接呼叫實作,import doseunif; doseunif.dose_cv_from_sizes(sizes, dose_mg: 'float', density: 'float', estimator: 'str | None' = None, frame=None, ci: 'float' = 0.9, n_boot: 'int' = 400, seed: 'int' = 0) -> 'dict';從台帳取用則 opsdrive.get("dose_cv_from_sizes"))
由實測粒徑求 1 劑含量的 CV(僅考慮顆粒數的漲落，Poisson)及其偏差與區間。
sizes 有 2 種形式:
• 1-D 陣列 = 以個數為基準的粒徑樣本 [µm] (如 grind.particle_image_d50 的 diameters)。estimator: "lognormal"(預設 —— 由 ln d 的平均與變異數得 D63 = exp(m + 4.5 v))/ "moment"(直接用 D63³ = Σd⁶/Σd³。平均無偏,但受少數大顆粒支配,中位數偏低)。傳入 frame = (H_px, W_px, pitch_um) 時,對捨棄接觸邊緣顆粒的量測(particle_image_d50 的 border="exclude": 捨棄落在外圈像素上的顆粒)中大顆粒的遺漏,用 Miles–Lantuéjoul 權重 1 / (((H−2)p − d)((W−2)p − d)) 修正(省略則平均偏低約 −5 %,見模組開頭)。區間為 ci(雙側)的百分位 bootstrap (n_boot 次,兩種估計量)與對數常態的 delta 法(Kish 有效數 n_eff,Var ln CV = (9v/n_eff + 364.5 v²/(n_eff − 1))/4)。
• dict(edges、volume) = 雷射繞射的體積基準表(grind.particle_size_read / grind.particle_size_synth)。estimator: "histogram"(預設 —— 把恆等式 D63³ = E_v[d³] 按區間以「對 ln d 均勻」積分,不假設分布形狀)/ "lognormal"(σ = ln(D84/D16)/2、D63 = D50 exp(1.5σ²))。表中沒有顆粒數,因此不給出樣本區間(ci_bootstrap 為 None)。coarse_share = E_v[d³] 中 D90 以上區間所佔比例(對粗尾的依賴程度)。
回傳: cv(所選估計量)、d63、各估計量的 cv_*、d63_*、sigma_ln、d_number_median(樣本)/ d50_volume(表)、particles_per_dose、n、n_eff、top1pct_share_d6(樣本: 最大 1 % 顆粒在 Σd⁶ 中所佔比例)、ci_bootstrap、ci_delta、estimator、source("sample" / "psd")、edge_corrected。Raises ValueError: 顆粒少於 10、非有限、非正、表損壞(與 grind.particle_size_dx 相同的檢查)、frame 中放不下的顆粒、拼寫錯誤。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
• poc_dose_uniformity_from_grinding — py -3.11 examples/poc_dose_uniformity_from_grinding.py
table 作為輸入)course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same
doseunif)dose_cv_lognormal · grind_time_for_dose_cv
*Provenance: doseunif.py — DRIVE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.