ΩOmicSolution蛋白质组学技术平台

SpectroDive Workshop

SpectroDive Workshop / 上机实操页

本页以 环境准备panel 设计RT calibrationanalysis setupabsolute quantificationrefinementreport / QC / command line 七个任务组织 SpectroDive 的实操主线。

7 个上机任务 贴合 Prepare / Analysis / Report 真顺序 兼顾绝对定量与方法优化 上机与复盘主课

可快速定位某个任务、字段问题或复核环节。

Roadmap

实操路线与任务结构

每个任务都围绕目标、输入、输出与检查点展开,离开本页后仍可据此复原完整 targeted workflow。

任务 输入 输出 通过标准
任务 1 环境准备raw、panel 来源、目录、标准品信息可复用的项目工作目录和输入清单能说清哪些文件是复用的,哪些是本次新建的
任务 2 panel 设计library / FASTA / sequence list字段完整的 assay panel能解释任意一行 panel 记录的意义
任务 3 calibration / exportpanel、calibration run、仪器信息scheduled 或更高阶方法文件能说明 split 与调度依据
任务 4 analysis setupraw、panel、schema、conditions结构正确的 analysis experiment知道接下来软件按什么逻辑提取和比较
任务 5 absolute quantcalibration curves、workflow type、reference information带边界解释的绝对定量结果能区分能检出与能稳定定量
任务 6 refinementreview 结果、pending changes、panel完成回写的方法改进知道哪些动作改显示,哪些动作改方法
任务 7 report / QC / CLIanalysis 结果、schema、QC history、CLI 参数可交付输出和可复用运行方式能把这次成功经验迁移到下次项目
任务训练的统一结构

每个任务都需要说明三件事:输入是什么,改变的是哪一层对象,最终输出的是什么。Task 2 的输出是可继续 split、calibrate、export 的 assay panel;Task 5 的输出是带线性范围解释的 absolute quantification 结果。

只要这三层结构明确,整条靶向验证流程就能被重新组织出来。

Task 1

环境准备与目录规划

第一步不该是直接导入 raw file,而是确认本地环境是否具备跑 targeted workflow 的基础。需要明确三件事:第一,panel 是从 spectral library、FASTA 还是 sequence list 来;第二,原始数据、kit 文件、共享目录和结果输出目录分别在哪;第三,这次项目是否需要 absolute quantification,因此是否要提前准备 calibrant runs 和相关标准样本。

环境准备完成后,需要清楚区分哪些输入可以复用,哪些必须重建。这样目录规划就从“找文件”进入正式项目视角。

必须确认的内容 当前阶段的意义
panel 来源后面所有 method export 和 review 的逻辑都受它影响
本地目录与 shared resources若路径混乱,后面 raw、kit、QC 和结果都难追踪
是否做绝对定量如果要做,标准品和 calibrant runs 必须在开工前准备
任务 1 的标准检查单
  • 确认运行环境符合本地磁盘空间、RAM、Temporary Directory 与 Local Search Archives 的基本要求。
  • 确认 raw files、search archives、panel kit files 和结果目录尽量都放在本地盘,而不是不稳定的网络盘或虚拟机共享盘。
  • 确认这次项目的输入属于哪一类:现成 panel、需要从库生成 panel、还是需要先准备 FASTA / sequence list。
  • 如果项目涉及绝对定量,提前确认 calibrant runs、dilution factors 和标准品信息是否齐全。

Task 2

Panel 设计与字段检查

这一任务围绕 panel 关键字段展开。Q1 / Q3、iRT、proteotypic peptide 与 response factor 共同决定采集、调度、定量与报表质量。

完成后,需要能够对任意一条 panel 记录解释其采集与分析含义。

字段 检查方式 如果出错会怎样
Q1 / Q3核对理论 m/z 与导入值是否一致transition 可能无法被正确调度或提取
iRT确认是否来自经验值或可靠预测scheduled window 会偏移,峰提取效率下降
ProteinId / ModifiedSequence确认身份和修饰命名是否统一report 和后续 refinement 会混乱
ResponseFactor如果要做绝对定量,提前核对是否齐全后续 Analysis 阶段很难补救
Panel 字段与方法后果

可抽取 1 条 precursor、2-3 条 transitions 做字段拆解。Q1 / Q3 对应采集和提取的 m/z 坐标;iRT 对应 scheduling 与分析速度;RelativeFragmentIntensity 会影响 detection sensitivity;ModifiedSequence 与 ProteinId 则把靶点身份绑定到后续 scoring 和 reporting 上。如果有绝对定量需求,还要额外检查 response factor、protein scaling factor 和单位字段是否完备。

这一步常见的偏差,是把 panel 当成“导入成功就行”的表格。更准确的标准是:能够拿出任意一行,说明它如何影响采集、识别、定量和报表。

Task 3

RT calibration 与 method export

第三个任务围绕 calibration run 指定、scheduled window 设计与 method export 展开。并发 transitions、dwell time 与 panel split 在这里共同决定导出质量。

SureQuant 与其他高级 workflow 也在这一层定义触发逻辑与阈值结构。

操作 产出判断
split panel当前并发 transitions 是否已经高到需要拆 panel
RT calibration当前调度是线性、非线性、library-based 还是 survey / DIA-based
method export此刻更适合 unscheduled、scheduled 还是更高阶 workflow
SureQuant是否需要 survey run 和触发阈值优化,而不是直接正式采集
RT calibration 与 method export 的产出

这一任务的产出是可解释的方法文件。需要能够说明是否需要 split panel、每个 split 的 transitions 数量、scheduled window 的来源,以及当前 workflow 是否启用了 SureQuant 或其他触发逻辑。

同时需要能够区分 unscheduled、scheduled 与更高阶 workflow 的方法设计差异。

Task 4

Analysis setup

第四个任务进入 Analysis Perspective,需要完成 raw file 导入、panel 选择、analysis schema 选择与 condition annotation,并明确软件接下来的提取、评分与比较逻辑。

iRT kit 自动检测也在这里连接 RT calibration、scheduled acquisition 与 QC 基础设施。

setup 元素 常见漏项 后果
panel 版本analysis 用的是否就是刚导出方法用的那一版方法和分析对象可能不一致
analysis schema默认 extraction / quantification 规则是否匹配项目结果结构会偏离预期
conditionsreplicates、fractions、groups 是否完整录入后续比较和 report 解释会出错
iRT detection是否真的被正确识别并纳入处理调度与 QC 解释会失真
Analysis setup 的四个检查点
  • 当前 analysis 用的 panel 是什么,它和前面 method export 用的是不是同一个定义版本。
  • analysis schema 中哪些默认设置会影响 scoring、quantification 和后分析。
  • conditions、replicates、fractions 和 correction factors 是否已经准确录入。
  • iRT kit 是否被正确检测到,以及这是否影响后续的 processing speed、specificity 与 automated QC。

Task 5

Absolute quantification

这一任务围绕 calibration curve set、workflow type、reference channel、LLOQ、ULOQ、LOD 与稀释系数展开,同时要求能够区分有效线性范围内与不适合正式报告的样本。

AbsoluteAmountAbsoluteAmountRangeLimitted 的区别在这里进入正式定量层。

结果类型 该怎么解释 报告适用性
低于 LOD说明有弱信号或接近背景,但不具稳定定量意义不适合
落在 LLOQ-ULOQ 间处于可稳定定量区间适合
超出 ULOQ 或被 range-limited要优先看受限字段和线性区间提示需谨慎,通常不直接用原始值
任务 5 的合格标准

合格标准包含三部分。第一,能够指出哪些 calibrant points 用于建立线性区间,哪些点因低于 LOD 或超出范围而不进入正式定量。第二,能够说明当前 experiment type 属于 label-free、labeled、spike-in 或 inverted spike-in 中的哪一类,以及参考通道是谁。第三,能够判断何时应在报告中优先使用 AbsoluteAmountRangeLimitted,而不是直接输出 AbsoluteAmount

Task 6

Review 与 refinement

第六个任务是 Workshop 的核心。需要在树状结构中 review peaks、对 fragments 做 accept / reject / exclude 等判断,并最终执行 fragment refinement 或 iRT refinement。refinement 完成后,panel 会更新回 Prepare Perspective,这正是 targeted 方法学的闭环能力。

commit changes 在这一环节决定 panel 是否真的被回写。界面上的修改只有进入 commit 和 refinement 流程,才会成为下一轮方法定义的一部分。

动作 它主要影响什么 是否会改变后续方法
hide当前显示不会
exclude当前 quant / report 参与度通常不直接改 panel 定义
delete对象保留与否可能,取决于后续是否 commit / refine
Refine Assay Transitionspanel 定义与下一次方法
任务 6 的训练目标

这一步要区分 3 类动作:一类只影响显示,例如 hide;一类影响 quantification / reporting,例如 exclude;一类会改变 panel 定义,例如 delete 和 refinement。完成 review 之后,还要知道什么时候需要 Process Pending Changes,什么时候需要 Refine Assay Transitions,以及从 SPE 加载的 SureQuant / HybridDIA 何时还要先 re-extract raw data。

Task 7

Report、QC 与 Command Line

最后一个任务围绕 report schema、QC history 与 command line 的三类使用场景展开。这一层负责把一次 targeted analysis 继续推进到客户交付、长期 QC 和重复运行。

Normal Report 与 Run Pivot Report 的适用场景、glossary 中的术语、report fields、method design 与 QC 指标会在这里汇到同一条交付链中。

最后产物 你应该能解释什么
Normal / Run Pivot Report当前交付结构与对象层、阅读方式之间的对应关系
QC history这次成功是否能被放进长期平台历史中继续解释
CLI 模板下次项目能否在相同 schema / report / calibration 逻辑下重复运行

连续课程

连续课程按方法开发、定量解释、交付与管理主线组织。

连续课程

进入模块总览

继续查看章节索引、附录与 figure atlas。

查看模块总览

任务 7 的完成标准
  • 能说明当前项目更适合导出 Normal Report 还是 Run Pivot Report,以及原因。
  • 能解释 QC history 对长期平台运行的价值,而不把它视作“额外图表”。
  • 知道 command line 至少支持哪三类动作:运行分析、加载保存实验输出报告、合并 calibration curve sets。
  • 能把 report fields 与 glossary 里的概念对应起来,例如 q-value、Cscore、AbsoluteAmountRangeLimitted、dwell time、cycle time 等。