Cr51BloodVolumeCalculator

Cr-51 Blood Volume Calculator

medical-devices radiopharmaceuticals nuclear-medicine cr-51 red-blood-cells blood-volume cell-survival indicator-dilution
Открыть подборку

Cr-51 Blood Volume Calculator — Cr-51 — расчёт объёма крови

Cr-51 Blood Volume Calculator — Cr-51 — расчёт объёма крови

ℹ️  Утилита выполняет:
    • Расчёт общего объёма крови и объёма эритроцитов методом разведения индикатора с поправкой на гематокрит.
    • Проверку структуры input.csv и числовых значений
    • Формирование LabWare-совместимого output.json
    • Детерминированный итог PASS / FAIL / ERROR

⚠️  КРИТИЧНО: Любое несоответствие должно быть проверено квалифицированным специалистом до использования результата в рабочем процессе.

Использование:
  Cr51BloodVolumeCalculator.exe                            → демо-режим (вывод в консоль)
  Cr51BloodVolumeCalculator.exe input.csv output.json      → оценка ваших данных

Формат input.csv:
BatchNumber,NetInjectedActivityKcpm,SampleActivityKcpm,SampleVolumeMl,VenousHematocritFraction,BodyHematocritCorrectionFactor,MinExpectedBloodVolumeMl,MaxExpectedBloodVolumeMl

Пример:
  CR51-BV-001,1000,2.5,5,0.45,0.91,2500,7000

— ЗАЧЕМ ЭТО НУЖНО?
Расчёт общего объёма крови и объёма эритроцитов методом разведения индикатора с поправкой на гематокрит.
Утилита входит в пакет «RPH Cr-51: масса, объём и выживаемость эритроцитов» и может применяться как самостоятельная проверка или как элемент более широкого workflow ядерной медицины.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• SampleActivityConcentration: >0
• BloodVolume: within protocol range
• RedCellVolume: >0

Ключевые особенности утилиты:
• Один исполняемый файл .NET 6 и один Program.cs
• Полный пример input.csv с проходной, пограничной и отрицательной строками
• LabWare-совместимый JSON: Header, Samples, Results, Status, StatusCode, ErrorMessage, Description и DescriptionEN
• CultureInfo.InvariantCulture для числовых значений
• Явные результаты по каждому параметру и пустой ErrorMessage для PASS

Критические параметры:
• SampleActivityConcentration: >0
• BloodVolume: within protocol range
• RedCellVolume: >0

💡 Советы по использованию:
1. Перед рабочим применением сверьте пределы с утверждённой спецификацией, инструкцией препарата, локальным SOP и конфигурацией оборудования.
2. Храните исходный input.csv вместе с output.json и версией исполняемого файла.
3. Для клинических расчётов используйте только проверенные исходные данные и утверждённый профиль протокола.
4. FAIL означает необходимость review, а не автоматическое медицинское решение.
5. Изменение лимитов должно проходить change control и повторную верификацию.

⚠️ Особенность: Утилита реализует детерминированный CSV → LabWare-compatible JSON workflow и не заменяет утверждённую методику, спецификацию, SOP или медицинское заключение.

Референсные пределы в этой версии являются консервативным стартовым профилем проекта FUZKK. Они должны быть подтверждены владельцем процесса до OQ/PQ и производственного применения.

input.csv

BatchNumber,NetInjectedActivityKcpm,SampleActivityKcpm,SampleVolumeMl,VenousHematocritFraction,BodyHematocritCorrectionFactor,MinExpectedBloodVolumeMl,MaxExpectedBloodVolumeMl
CR51-BV-001,1000,2.5,5,0.45,0.91,2500,7000
CR51-BV-002,900,1.8,5,0.4,0.91,2500,7000
CR51-BV-003,300,0.1,5,0.25,0.91,2500,7000

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

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

  • Утилита должна запускаться без аргументов в демонстрационном режиме и с двумя аргументами input.csv output.json.
  • Обязательный CSV-заголовок: BatchNumber,NetInjectedActivityKcpm,SampleActivityKcpm,SampleVolumeMl,VenousHematocritFraction,BodyHematocritCorrectionFactor,MinExpectedBloodVolumeMl,MaxExpectedBloodVolumeMl.
  • Числовые значения должны разбираться через CultureInfo.InvariantCulture.
  • Каждая строка должна формировать отдельный объект Samples в LabWare-совместимом JSON.
  • Статусы должны быть PASS, FAIL или ERROR; для PASS поле ErrorMessage должно быть пустым.
  • Утилита должна применять правила конкретного workflow и выводить результат каждого параметра.
  • Повторный запуск с теми же данными и версией должен давать идентичный результат.
  • Некорректный заголовок, число колонок или тип значения должен приводить к ERROR, а не к PASS.

Полный пример input.csv

BatchNumber,NetInjectedActivityKcpm,SampleActivityKcpm,SampleVolumeMl,VenousHematocritFraction,BodyHematocritCorrectionFactor,MinExpectedBloodVolumeMl,MaxExpectedBloodVolumeMl
CR51-BV-001,1000,2.5,5,0.45,0.91,2500,7000
CR51-BV-002,900,1.8,5,0.4,0.91,2500,7000
CR51-BV-003,300,0.1,5,0.25,0.91,2500,7000

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

  1. Main() выбирает демонстрационный или файловый режим.
  2. LoadData() проверяет точный заголовок и преобразует каждую строку в Record.
  3. Evaluate() возвращает именованный кортеж с номером партии, продуктом, параметрами, итогом и рекомендациями RU/EN.
  4. AddCheck() создаёт элементы Results с фактическим значением, единицей, пределом и IsWithinSpec.
  5. RunWithFiles() формирует Header/Samples и сериализует результат через Newtonsoft.Json.
  6. Глобальная ошибка преобразуется в SampleResult со статусом ERROR и кодом -1.

Реализованные правила

  • SampleActivityConcentration: >0
  • BloodVolume: within protocol range
  • RedCellVolume: >0

Полный пример input.csv

BatchNumber,NetInjectedActivityKcpm,SampleActivityKcpm,SampleVolumeMl,VenousHematocritFraction,BodyHematocritCorrectionFactor,MinExpectedBloodVolumeMl,MaxExpectedBloodVolumeMl
CR51-BV-001,1000,2.5,5,0.45,0.91,2500,7000
CR51-BV-002,900,1.8,5,0.4,0.91,2500,7000
CR51-BV-003,300,0.1,5,0.25,0.91,2500,7000

Минимальные OQ-сценарии

  • PASS для первой строки.
  • Обработка пограничной второй строки.
  • FAIL для третьей строки.
  • ERROR при изменённом заголовке.
  • ERROR при нечисловом значении.
  • Идентичный JSON-результат при повторном запуске.

Входит в пакеты

PetRad QC Suite

Пакет специализированных утилит для контроля качества радиофармпрепаратов: ПЭТ, SPECT, терапевтические радионуклиды, генераторы и расчёты распада.

Открыть

PetRad3: расширенный PET/SPECT и радиофармацевтический QC-пакет

Подборка утилит для контроля PET/SPECT радиофармпрепаратов, генераторных и циклотронных радионуклидов, меченых соединений, радиохимической чистоты, прорыва, стерильности и эндотоксинов.

Открыть

Радиология

Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.

Открыть

RPH Cr-51: масса, объём и выживаемость эритроцитов

Расчёт массы эритроцитов и объёма крови, контроль эффективности мечения Cr-51, поправки на элюцию, анализ кривой восстановления и контроль времени отбора проб.

Открыть

RPH isotope family: labelled cells and blood

In-111 и Cr-51 для labelled cells, blood volume, RBC/WBC и survival workflows.

Открыть

RPH organ/system: кровь, клетки и костный мозг

WBC/RBC/platelet labelling, blood volume, survival, blood-pool и cellular release workflows.

Открыть

RPH use case: меченые клетки и blood-pool workflows

Лейкоциты, эритроциты, тромбоциты и autologous cell workflows: эффективность мечения, жизнеспособность, свободная активность, восстановление и release перед reinjection.

Открыть

RPH: объединённый радиофармацевтический QC-пакет

RPH объединяет PetRad, PetRad2 и PetRad3 в один обзорный пакет для PET/SPECT, терапевтических радионуклидов, генераторов, меченых соединений, расчётов распада, стерильности, эндотоксинов и радиохимической/радионуклидной чистоты.

Открыть