TRTDosimetryCalculator

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

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

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

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

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

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

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

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

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

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

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

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

Пример CSV

PatientID,Radionuclide,TargetOrgan,AdministeredActivityMBq,TimePoint1Hr,Activity1MBq,TimePoint2Hr,Activity2MBq,TimePoint3Hr,Activity3MBq,MassKg,SValueGyPerBqS
PT-2026-NET-07,Lu177,Kidneys,7400.0,4.0,250.0,24.0,180.0,72.0,90.0,0.30,4.5e-06

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

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

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

{
  "utility": "TRTDosimetryCalculator",
  "api": "TRT Dosimetry Calculator",
  "batchNumber": "",
  "overallStatus": "PASS|WARNING|FAIL",
  "checkedAtUtc": "2026-05-18T00:00:00Z",
  "checks": [
    {
      "parameter": "PatientID",
      "value": "PT-2026-NET-07",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "Radionuclide",
      "value": "Lu177",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "TargetOrgan",
      "value": "Kidneys",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "AdministeredActivityMBq",
      "value": "7400.0",
      "unit": "MBq",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "TimePoint1Hr",
      "value": "4.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "Activity1MBq",
      "value": "250.0",
      "unit": "MBq",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "TimePoint2Hr",
      "value": "24.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "Activity2MBq",
      "value": "180.0",
      "unit": "MBq",
      "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-сценариев.