顏色與醒目標示
primary:主要保留峰或主要保留化合物。
secondary:次要保留峰或次要保留化合物。
same_name_diff_rt_group = yes:同名但 RT 不同,且目前保留為獨立峰。
merged:此列已合併到其他主峰。
background:背景峰、污染峰或不納入分析的列。
review:待人工確認。
needs_manual_review = yes:此列需要人工檢查。
mode_limited / stop_excluded / not_in_final:因模式限制、STOP 或人工決策而暫不納入 final。
*_peak_count >= 2:同一 sample 的同一最終化合物由 2 個以上 peak 構成。
total_peak_count:只有在低於輸入分析樣品數的 1/4 時才會醒目標示。
mode
full_mode:同一 sample 的 peak 與 library 候選完整可對位,可進完整主流程。
html_only_mode:只有 library / HTML 候選層,只做名稱候選整理與 Area% 觀察,不做最終命名。
csv_only_mode:只有 peak table / CSV,只做 RT、area、height、pct 比較,不做最終命名。
suggested_status
primary:系統建議的主要保留峰。
secondary:系統建議保留,但屬次要或非主要共識峰。
review:系統不敢自動定案,需要人工確認。
background:疑似背景峰 / 汙染峰 / artifact。
final_status
primary:最終主要保留化合物。
secondary:最終保留,但屬次要峰或次要版本。
review:人工仍未解決,不進最終完成版。
background:最終判定為背景 / 汙染,不進最終完成版。
merged:已合併到其他 final_cluster_id,本列不再單獨進 Final Summary。
not_in_final / mode_limited / stop_excluded:不納入最終完成版的特殊狀態。
manual_action
accept_suggested:接受系統建議。
keep_original_top1:採用 top1 原名。
force_name:人工強制指定名稱。
keep_separate:保留為獨立峰。
mark_secondary:人工降為 secondary。
mark_background:人工標示為 background。
split_cluster:從 cluster 中選部分 member peaks 拆成新的 child cluster。
undecided:暫不決定。
merge_action
keep_separate:同名不同 RT 保留獨立,不合併。
merge_to_primary:同名不同 RT 的非主峰合併到主峰。
primary_keep:該群為該名稱主峰,不會被別人合併。
conflict_level
low:名稱 / CAS 衝突低,系統較能自動建議。
high:名稱 / CAS 衝突高,需人工特別檢查。
基本欄位
sample:樣品名稱。
peak_no:該樣品內的 peak 編號。
peak_id:單一 peak 的唯一識別碼;Peak Override 以此為主鍵。
rt_ref:單一 peak 的原始 RT。
rt_mean:同一 RT cluster 內各 peak 彙整後的代表 RT。
qual:library 比對品質分數。
candidate_rank:候選順位;1、2、3 通常分別對應 top1、top2、top3。
RT / raw_area / height / Area_pct:peak 層原始數值欄位,分別對應保留時間、峰面積、峰高與面積百分比。
命名與同名不同 RT
original_name:匯入時保留的原始名稱。
suggested_name:系統在 RT-first 規則下產生的建議顯示名稱。
chosen_base_name:標準化後的基礎名稱;若同名不同 RT 需保留獨立峰,後續可能再加上 (RT)。
final_name / display_name:套用人工決策、merge 決策與 Peak Override 後,最終真正顯示的名稱。
canonical_rule_basis:本群建議名稱採用的標準化依據;常見值如 name_first 或 cas_first。
same_name_diff_rt_group:同名但 RT 不同的群組標記;yes 時會以紫色提示。
primary_for_name:同名不同 RT 群組內,哪一個 cluster 被判為該名稱的主要保留峰;常見值為 yes / no / not_set。
other_same_name_rts / other_same_name_clusters:列出其他同名 RT 與 cluster,供人工判斷要保留獨立還是合併。
name_changed_any:該列名稱是否已相對原始名稱發生變動。
Final 追蹤欄位
cluster_id:RT 分群後的內部 cluster 編號。
final_cluster_id:最終完成版的內部唯一 ID;Final Clean Detail / Final Summary 以此彙整。
merged_into_final_cluster_id:若本列已併入主峰,這裡顯示被併入的 final_cluster_id。
included_in_final:是否進 Final Clean Detail / Final Summary;常見值如 yes / no,若為合併列也可能顯示合併狀態。
included_in_final_pct_denominator:是否納入最終百分比分母。
include_final_preference / include_denominator_preference:Manual Review 的人工偏好設定;常見值為 auto / yes / no。
excluded_from_summary_reason:未進 Final Summary 的直接原因說明。
excluded_from_summary:是否被排除在 Final Summary 之外;常見值為 yes / no。
suggested_reason / adjustment_reason / final_reason / rename_reason:各階段理由欄位,依序對應自動建議、人工調整、最終整合與改名原因。
note:流程補充註記,可能包含 merge、manual action、peak override 等操作痕跡。
審核 / 風險 / 解析
needs_manual_review:此列因衝突、同名不同 RT 或 HTML/CSV 警示而需要人工確認。
html_csv_mismatch:HTML / CSV 對位結果;yes = 有警示,stop = 嚴重不一致,no = 無警示。
background_class:背景判定來源;常見值如 background / artifact / candidate / unknown。
parser_status:單一檔案解析結果;常見值如 parsed / empty / parse_error / unsupported / auxiliary_pdf。
候選與來源欄位
top1_name / top2_name / top3_name:保留的前三個候選名稱;應與對應 CAS / Qual / library 欄位一起閱讀。
top1_cas / top2_cas / top3_cas:前三候選對應的 CAS。
top1_qual / top2_qual / top3_qual:前三候選對應的 Qual。
top1_library / top2_library / top3_library:前三候選對應的 library 來源。
top_candidates:前三候選的原始結構化資料。
all_original_names / all_cas:同一 RT cluster 內彙整出的全部原始名稱 / CAS。
source_cluster_ids / source_peak_ids / source_rts:Final Clean Detail / Final Summary 回溯來源時使用的 cluster、peak 與 RT 清單。
sample_presence:該 final compound 出現在多少個樣品中。
Final Clean Detail / Final Summary 欄位
final_area:最終保留後的面積;若有 merge,會將子峰面積併入主峰。
final_height:最終保留後的峰高。
recalculated_pct:依最終保留化合物重新計算後的百分比。
*_peak_count:某一 sample 中,該 final compound 由多少個 peak 組成。
total_peak_count:該 final compound 在全部樣品中累計由多少個 peak 組成。
Peak Override
Peak Override 是針對單一 peak_id 的覆寫層,不影響全域規則,也不必先拆 cluster 才能使用。
override_name:只覆寫單一 peak 的最終名稱。
override_status:只覆寫單一 peak 的最終狀態。
include_final / include_denominator:只針對單一 peak 覆寫是否納入 final 與分母。
peak_override_applied:最終結果是否真的套用了 Peak Override。
peak_override_note:Peak Override 套用時記錄的原因與覆寫內容摘要。
note:Peak Override 的人工備註。
優先序:Peak Override > Manual Review(cluster) > Auto suggestion。