DVHComparator

1. Область применения

Утилита DVH Comparator применяется для объекта DVH Comparator. Источником истины для структуры входных данных является фактический input.csv; критерии контроля задаются исполняемым модулем и предметным описанием.

Утилита не использует машинное обучение; решение формируется детерминированными правилами.

Категории: Radiation physics

Теги: activity, brachytherapy, dosimetry, radiopharma, source calibration, TG-43

2. Режимы запуска

DVHComparator.exe                            → демо-режим
DVHComparator.exe input.csv output.json      → сравнение данных (первая запись)

3. Ключевые контролируемые области

• pH и физико-химические параметры
• радиоактивность, распад и радиохимическая чистота

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

6. Контракт входных данных input.csv

Источник истины для схемы входа — фактический заголовок input.csv. Имена колонок технические и не переводятся.

Пример CSV

PatientID,StructureName,MetricType,PlanValue,RefValue,TolerancePercent,ToleranceAbsolute
PT-2026-LUNG-01,PTV_60,D95,58.5,60.0,3.0,1.0

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

8. Выходной контракт output.json

Выходной файл должен быть пригоден для автоматической обработки, аудита и сопоставления с исходной строкой input.csv.

{
  "utility": "DVHComparator",
  "api": "DVH Comparator",
  "batchNumber": "",
  "overallStatus": "PASS|WARNING|FAIL",
  "checkedAtUtc": "2026-05-18T00:00:00Z",
  "checks": [
    {
      "parameter": "PatientID",
      "value": "PT-2026-LUNG-01",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "StructureName",
      "value": "PTV_60",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "MetricType",
      "value": "D95",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "PlanValue",
      "value": "58.5",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "RefValue",
      "value": "60.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "TolerancePercent",
      "value": "3.0",
      "unit": "%",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "ToleranceAbsolute",
      "value": "1.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    }
  ],
  "criticalFindings": [],
  "sourceFile": "input.csv"
}

9. Тестовые сценарии OQ/PQ

10. QA/QC, CSV и управление изменениями

• Перед применением на производстве клиент фиксирует версию исполняемого файла, контрольную сумму, версию спецификации/монографии, тестовый CSV, ожидаемый JSON и результаты IQ/OQ.
• Нельзя менять имена колонок без обновления валидатора и тестовых сценариев.
• Исходный CSV, output.json и версия утилиты должны храниться вместе как пакет доказательств.
• Любое изменение правил контроля должно проходить change control и повторную проверку OQ-сценариев.