IonTorrentRunAcceptanceChecker

URS & FS — спецификация пользователя и функциональная спецификация

Документ описывает контролируемый интерфейс и поведение утилиты IonTorrentRunAcceptanceChecker для сценария Ion Torrent Run Acceptance Checker.

Предметные ограничения и критические параметры

• • AQ20 Bases: Количество баз с качеством ≥Q20 — мера полезного выхода секвенирования.
• • Uniformity: Равномерность покрытия целевых регионов — критично для панелей ампликонного типа.
• ⚠️ ВАЖНО:
• • Ion Torrent имеет уникальный профиль ошибок: гомополимерные indels составляют >60% всех ошибок.
• • Поликлональность >30% необратимо снижает качество данных и не компенсируется глубиной.
• • Перегрузка чипа (ISP density > max) вызывает каскадное ухудшение всех метрик.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Polyclonal ≤30%: Превышение = разбавление template или деградация ISPs.
• • AQ20 ≥ Min: Ниже порога = недостаточно данных для надежного variant calling.
• • Uniformity ≥80%: Для ампликонных панелей ниже 80% = проблемы с праймерами или PCR.
• • Raw Accuracy ≥98.5%: Ниже = деградация химии или изношенный чип.
• Критические параметры:
• • Polyclonal Rate: ≤ 30%
• • AQ20 Bases: ≥ Panel-specific minimum
• • Uniformity: ≥ 80%
• • On-Target Rate: ≥ 70%
• • Raw Accuracy: ≥ 98.5%

URS — пользовательские требования

Контракт input.csv

RunID,ChipType,PanelName,ISP_Density_K_mm2,MinISP_Density,MaxISP_Density,Polyclonal_Percent,MaxPolyclonal_Percent,AQ20_Bases_Million,MinAQ20_Bases_Million,Mean_Read_Length_bp,MinMeanReadLength_bp,Uniformity_Percent,MinUniformity_Percent,Duplication_Rate_Percent,MaxDuplication_Rate_Percent,On_Target_Rate_Percent,MinOnTarget_Rate_Percent,Raw_Accuracy_Percent,MinRawAccuracy_Percent,Total_Reads_Million,MinTotal_Reads_Million,ControlSequence_Pass,Phasing_Score,MaxPhasing_Score
ION-2026-RUN-001,530,Oncomine Comprehensive Assay v3,680,200,1200,18.5,30.0,2800,500,185,100,92.5,80.0,15.2,40.0,88.0,70.0,99.4,98.5,12,5,true,0.8,1.5
ION-2026-RUN-002,520,AmpliSeq Cancer Hotspot v2,1350,200,1200,42.0,30.0,380,500,142,100,65.0,80.0,55.0,40.0,58.0,70.0,97.8,98.5,4,5,false,2.1,1.5
ION-2026-RUN-003,510,BRCA1/2 Panel,450,200,1200,28.0,30.0,620,500,165,100,82.0,80.0,35.0,40.0,75.0,70.0,99.1,98.5,6,5,true,1.2,1.5

Правила валидации входных данных

FS — функциональная спецификация

Пример output.json

{
  "utilityId": "iontorrentrunacceptancechecker",
  "utilityFolder": "IonTorrentRunAcceptanceChecker",
  "package": "LiquidBiopsy",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "RunID",
      "value": "ION-2026-RUN-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "ChipType",
      "value": "530",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "PanelName",
      "value": "Oncomine Comprehensive Assay v3",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "ISP_Density_K_mm2",
      "value": "680",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    },
    {
      "parameter": "MinISP_Density",
      "value": "200",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-005"
    },
    {
      "parameter": "MaxISP_Density",
      "value": "1200",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-006"
    },
    {
      "parameter": "Polyclonal_Percent",
      "value": "18.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-007"
    },
    {
      "parameter": "MaxPolyclonal_Percent",
      "value": "30.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-008"
    },
    {
      "parameter": "AQ20_Bases_Million",
      "value": "2800",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-009"
    },
    {
      "parameter": "MinAQ20_Bases_Million",
      "value": "500",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-010"
    },
    {
      "parameter": "Mean_Read_Length_bp",
      "value": "185",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-011"
    },
    {
      "parameter": "MinMeanReadLength_bp",
      "value": "100",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-012"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "audit": {
    "inputHash": "sha256:<calculated at runtime>",
    "rulesVersion": "<utility executable version>",
    "documentation": "IonTorrentRunAcceptanceChecker.documentation.html"
  }
}

Матрица трассируемости

IQ/OQ/PQ тестовые сценарии

QA/QC и change control

• Не менять имена колонок без обновления валидатора, документации и тестового набора.
• Хранить input.csv, output.json, версию исполняемого файла и контрольную сумму.
• Перед продуктивным использованием провести IQ/OQ/PQ или эквивалентную CSV/CSA-проверку.
• Критические пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.
• Утилита предоставляет формализованный QC decision support, но окончательное решение выпуска остаётся за QA/QP и утверждёнными процедурами.