Gallium67CitrateQualityChecker
Gallium-67 Citrate Quality Checker
Gallium-67 Citrate Quality Checker — Ga-67 citrate — контроль качества
Gallium-67 Citrate Quality Checker — Ga-67 citrate — контроль качества
ℹ️ Утилита выполняет:
• Контроль радиохимической и радионуклидной чистоты, свободного галлия, pH, стерильности, эндотоксинов и активности.
• Проверку структуры input.csv и числовых значений
• Формирование LabWare-совместимого output.json
• Детерминированный итог PASS / FAIL / ERROR
⚠️ КРИТИЧНО: Любое несоответствие должно быть проверено квалифицированным специалистом до использования результата в рабочем процессе.
Использование:
Gallium67CitrateQualityChecker.exe → демо-режим (вывод в консоль)
Gallium67CitrateQualityChecker.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,RadiochemicalPurityPercent,RadionuclidicPurityPercent,FreeGalliumPercent,pH,EndotoxinsEUPerVial,SterilityTest,ActivityMBq
Пример:
GA67-001,98,99.9,1,6.5,20,0,180
— ЗАЧЕМ ЭТО НУЖНО?
Контроль радиохимической и радионуклидной чистоты, свободного галлия, pH, стерильности, эндотоксинов и активности.
Утилита входит в пакет «RPH: визуализация инфекции и воспаления» и может применяться как самостоятельная проверка или как элемент более широкого workflow ядерной медицины.
⚠️ КРИТИЧЕСКИ ВАЖНО:
• RadiochemicalPurity: >=95
• RadionuclidicPurity: >=99
• FreeGallium: <=5
• pH: 4-8
• Endotoxins: <=175
• Sterility: =0
• Activity: >0
Ключевые особенности утилиты:
• Один исполняемый файл .NET 6 и один Program.cs
• Полный пример input.csv с проходной, пограничной и отрицательной строками
• LabWare-совместимый JSON: Header, Samples, Results, Status, StatusCode, ErrorMessage, Description и DescriptionEN
• CultureInfo.InvariantCulture для числовых значений
• Явные результаты по каждому параметру и пустой ErrorMessage для PASS
Критические параметры:
• RadiochemicalPurity: >=95
• RadionuclidicPurity: >=99
• FreeGallium: <=5
• pH: 4-8
• Endotoxins: <=175
• Sterility: =0
• Activity: >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,RadiochemicalPurityPercent,RadionuclidicPurityPercent,FreeGalliumPercent,pH,EndotoxinsEUPerVial,SterilityTest,ActivityMBq GA67-001,98,99.9,1,6.5,20,0,180 GA67-002,95,99.5,5,5.5,150,0,80 GA67-003,82,97,15,3,300,1,0
URS & FS — пользовательские требования и функциональная спецификация
URS — требования пользователя
- Утилита должна запускаться без аргументов в демонстрационном режиме и с двумя аргументами
input.csv output.json. - Обязательный CSV-заголовок:
BatchNumber,RadiochemicalPurityPercent,RadionuclidicPurityPercent,FreeGalliumPercent,pH,EndotoxinsEUPerVial,SterilityTest,ActivityMBq. - Числовые значения должны разбираться через
CultureInfo.InvariantCulture. - Каждая строка должна формировать отдельный объект Samples в LabWare-совместимом JSON.
- Статусы должны быть PASS, FAIL или ERROR; для PASS поле ErrorMessage должно быть пустым.
- Утилита должна применять правила конкретного workflow и выводить результат каждого параметра.
- Повторный запуск с теми же данными и версией должен давать идентичный результат.
- Некорректный заголовок, число колонок или тип значения должен приводить к ERROR, а не к PASS.
Полный пример input.csv
BatchNumber,RadiochemicalPurityPercent,RadionuclidicPurityPercent,FreeGalliumPercent,pH,EndotoxinsEUPerVial,SterilityTest,ActivityMBq GA67-001,98,99.9,1,6.5,20,0,180 GA67-002,95,99.5,5,5.5,150,0,80 GA67-003,82,97,15,3,300,1,0
FS — функциональная спецификация
Main()выбирает демонстрационный или файловый режим.LoadData()проверяет точный заголовок и преобразует каждую строку вRecord.Evaluate()возвращает именованный кортеж с номером партии, продуктом, параметрами, итогом и рекомендациями RU/EN.AddCheck()создаёт элементы Results с фактическим значением, единицей, пределом и IsWithinSpec.RunWithFiles()формирует Header/Samples и сериализует результат через Newtonsoft.Json.- Глобальная ошибка преобразуется в SampleResult со статусом ERROR и кодом -1.
Реализованные правила
RadiochemicalPurity: >=95RadionuclidicPurity: >=99FreeGallium: <=5pH: 4-8Endotoxins: <=175Sterility: =0Activity: >0
Полный пример input.csv
BatchNumber,RadiochemicalPurityPercent,RadionuclidicPurityPercent,FreeGalliumPercent,pH,EndotoxinsEUPerVial,SterilityTest,ActivityMBq GA67-001,98,99.9,1,6.5,20,0,180 GA67-002,95,99.5,5,5.5,150,0,80 GA67-003,82,97,15,3,300,1,0
Минимальные OQ-сценарии
- PASS для первой строки.
- Обработка пограничной второй строки.
- FAIL для третьей строки.
- ERROR при изменённом заголовке.
- ERROR при нечисловом значении.
- Идентичный JSON-результат при повторном запуске.
Входит в пакеты
PetRad QC Suite
Пакет специализированных утилит для контроля качества радиофармпрепаратов: ПЭТ, SPECT, терапевтические радионуклиды, генераторы и расчёты распада.
ОткрытьPetRad3: расширенный PET/SPECT и радиофармацевтический QC-пакет
Подборка утилит для контроля PET/SPECT радиофармпрепаратов, генераторных и циклотронных радионуклидов, меченых соединений, радиохимической чистоты, прорыва, стерильности и эндотоксинов.
ОткрытьРадиология
Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.
ОткрытьRPH: визуализация инфекции и воспаления
Контроль Ga-67 citrate, Tc-99m sulesomab и Tc-99m besilesomab, а также acquisition антигранулоцитарной сцинтиграфии.
ОткрытьRPH isotope family: Ga/Ge
Ga-67, Ga-68 и Ge-68: generator, radiolabelling, PET/SPECT и purity workflows.
ОткрытьRPH: меченые лейкоциты — приготовление, выпуск и визуализация
Мечение лейкоцитов Tc-99m HMPAO, эффективность мечения, жизнеспособность и восстановление клеток, свободная активность, время и температура процесса, выпуск перед реинъекцией.
ОткрытьRPH organ/system: кровь, клетки и костный мозг
WBC/RBC/platelet labelling, blood volume, survival, blood-pool и cellular release workflows.
ОткрытьRPH organ/system: лимфатическая система, инфекция и воспаление
Sentinel node, lymphoscintigraphy, nanocolloid, labelled leukocytes, granulocyte и inflammatory imaging.
ОткрытьRPH use case: меченые клетки и blood-pool workflows
Лейкоциты, эритроциты, тромбоциты и autologous cell workflows: эффективность мечения, жизнеспособность, свободная активность, восстановление и release перед reinjection.
ОткрытьRPH workflow: генераторы и изотопная чистота
Generator eluate, breakthrough, radionuclidic purity, isotope mix и starting radionuclides.
ОткрытьRPH workflow: imaging QC и количественная интерпретация
Acquisition, uptake, clearance, perfusion, transit, ejection fraction, segmentation и quantitative imaging.
ОткрытьRPH workflow: product release QC
Assay, purity, sterility, endotoxins, pH, impurities, appearance и batch-release checks.
ОткрытьRPH: объединённый радиофармацевтический QC-пакет
RPH объединяет PetRad, PetRad2 и PetRad3 в один обзорный пакет для PET/SPECT, терапевтических радионуклидов, генераторов, меченых соединений, расчётов распада, стерильности, эндотоксинов и радиохимической/радионуклидной чистоты.
Открыть