end-reason

majiayu000 的头像作者 majiayu000

Oxford Nanopore 读取结束原因 QC 分析。在分析纳米孔测序质量、检查自适应采样效率、调查读取终止模式、诊断测序问题或对 POD5/Fast5 数据运行 QC 时使用。与 ont-experiments 集成,通过模式 B 编排进行来源跟踪。支持具有质量阈值的 signal_positive、unblock_mux_change、data_service_unblock_mux_change 分析。

📖 中文导读:Oxford Nanopore 读取结束原因 QC 分析。在分析纳米孔测序质量、检查自适应采样效率、调查读取终止模式、诊断测序问题或对 POD5/Fast5 数据运行 QC 时使用。与 ont-experiments 集成,通过模式 B 编排进行来源跟踪。支持具有质量阈值的 signal_positive、unblock_mux_change、data_service_unblock_mux_change 分析。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: end-reason description: Oxford Nanopore read end reason QC analysis. Use when analyzing nanopore sequencing quality, checking for adaptive sampling efficiency, investigating read termination patterns, diagnosing sequencing issues, or running QC on POD5/Fast5 data. Integrates with ont-experiments for provenance tracking via Pattern B orchestration. Supports signal_positive, unblock_mux_change, data_service_unblock_mux_change analysis with quality thresholds.

End Reason Analysis - ONT QC

Analyze Oxford Nanopore read end reasons for quality assessment and adaptive sampling efficiency.

Integration

Run through ont-experiments for provenance tracking:

ont_experiments.py run end_reasons exp-abc123 --json results.json --plot qc.png

Or standalone:

python3 end_reason.py /path/to/data --json results.json

End Reason Categories

End Reason Description Expected %
signal_positive Normal completion 80-95%
unblock_mux_change Adaptive sampling rejection 0-15%
data_service_unblock_mux_change Basecall-triggered rejection 0-10%
mux_change Pore mux change 1-5%
signal_negative Signal lost <5%

Quality Assessment

Status Criteria
✓ OK signal_positive ≥75%
⚠ CHECK signal_positive <75% or anomalies
✗ FAIL signal_positive <50%

Options

Option Description
--json FILE Output JSON summary
--csv FILE Output per-read CSV
--plot FILE Output bar chart (PNG/PDF)
--format FORMAT Force format (pod5, fast5, summary)
--quick Sample 10k reads only

Supported Formats

  • POD5 (fastest, recommended)
  • Fast5 (legacy)
  • sequencing_summary.txt

Output JSON

{
  "total_reads": 15000000,
  "quality_status": "OK",
  "signal_positive_pct": 90.0,
  "unblock_mux_pct": 8.0,
  "data_service_pct": 1.0,
  "end_reasons": {
    "signal_positive": {"count": 13500000, "pct": 90.0},
    "unblock_mux_change": {"count": 1200000, "pct": 8.0}
  }
}