连续课程
连续课程按方法开发、定量解释、交付与管理主线组织。
SpectroDive Workshop
本页以 环境准备、panel 设计、RT calibration、
analysis setup、absolute quantification、refinement、
report / QC / command line 七个任务组织 SpectroDive 的实操主线。
Roadmap
每个任务都围绕目标、输入、输出与检查点展开,离开本页后仍可据此复原完整 targeted workflow。
| 任务 | 输入 | 输出 | 通过标准 |
|---|---|---|---|
| 任务 1 环境准备 | raw、panel 来源、目录、标准品信息 | 可复用的项目工作目录和输入清单 | 能说清哪些文件是复用的,哪些是本次新建的 |
| 任务 2 panel 设计 | library / FASTA / sequence list | 字段完整的 assay panel | 能解释任意一行 panel 记录的意义 |
| 任务 3 calibration / export | panel、calibration run、仪器信息 | scheduled 或更高阶方法文件 | 能说明 split 与调度依据 |
| 任务 4 analysis setup | raw、panel、schema、conditions | 结构正确的 analysis experiment | 知道接下来软件按什么逻辑提取和比较 |
| 任务 5 absolute quant | calibration curves、workflow type、reference information | 带边界解释的绝对定量结果 | 能区分能检出与能稳定定量 |
| 任务 6 refinement | review 结果、pending changes、panel | 完成回写的方法改进 | 知道哪些动作改显示,哪些动作改方法 |
| 任务 7 report / QC / CLI | analysis 结果、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 必须在开工前准备 |
Task 2
这一任务围绕 panel 关键字段展开。Q1 / Q3、iRT、proteotypic peptide 与 response factor 共同决定采集、调度、定量与报表质量。
完成后,需要能够对任意一条 panel 记录解释其采集与分析含义。
| 字段 | 检查方式 | 如果出错会怎样 |
|---|---|---|
Q1 / Q3 | 核对理论 m/z 与导入值是否一致 | transition 可能无法被正确调度或提取 |
iRT | 确认是否来自经验值或可靠预测 | scheduled window 会偏移,峰提取效率下降 |
ProteinId / ModifiedSequence | 确认身份和修饰命名是否统一 | report 和后续 refinement 会混乱 |
ResponseFactor | 如果要做绝对定量,提前核对是否齐全 | 后续 Analysis 阶段很难补救 |
可抽取 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
第三个任务围绕 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 和触发阈值优化,而不是直接正式采集 |
这一任务的产出是可解释的方法文件。需要能够说明是否需要 split panel、每个 split 的 transitions 数量、scheduled window 的来源,以及当前 workflow 是否启用了 SureQuant 或其他触发逻辑。
同时需要能够区分 unscheduled、scheduled 与更高阶 workflow 的方法设计差异。
Task 4
第四个任务进入 Analysis Perspective,需要完成 raw file 导入、panel 选择、analysis schema 选择与 condition annotation,并明确软件接下来的提取、评分与比较逻辑。
iRT kit 自动检测也在这里连接 RT calibration、scheduled acquisition 与 QC 基础设施。
| setup 元素 | 常见漏项 | 后果 |
|---|---|---|
| panel 版本 | analysis 用的是否就是刚导出方法用的那一版 | 方法和分析对象可能不一致 |
| analysis schema | 默认 extraction / quantification 规则是否匹配项目 | 结果结构会偏离预期 |
| conditions | replicates、fractions、groups 是否完整录入 | 后续比较和 report 解释会出错 |
| iRT detection | 是否真的被正确识别并纳入处理 | 调度与 QC 解释会失真 |
Task 5
这一任务围绕 calibration curve set、workflow type、reference channel、LLOQ、ULOQ、LOD 与稀释系数展开,同时要求能够区分有效线性范围内与不适合正式报告的样本。
AbsoluteAmount 与 AbsoluteAmountRangeLimitted 的区别在这里进入正式定量层。
| 结果类型 | 该怎么解释 | 报告适用性 |
|---|---|---|
| 低于 LOD | 说明有弱信号或接近背景,但不具稳定定量意义 | 不适合 |
| 落在 LLOQ-ULOQ 间 | 处于可稳定定量区间 | 适合 |
| 超出 ULOQ 或被 range-limited | 要优先看受限字段和线性区间提示 | 需谨慎,通常不直接用原始值 |
合格标准包含三部分。第一,能够指出哪些 calibrant points 用于建立线性区间,哪些点因低于 LOD 或超出范围而不进入正式定量。第二,能够说明当前 experiment type 属于 label-free、labeled、spike-in 或 inverted spike-in 中的哪一类,以及参考通道是谁。第三,能够判断何时应在报告中优先使用 AbsoluteAmountRangeLimitted,而不是直接输出 AbsoluteAmount。
Task 6
第六个任务是 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 Transitions | panel 定义与下一次方法 | 会 |
这一步要区分 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 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 逻辑下重复运行 |