Tc99mMAARadiochemicalPurityChecker
Tc-99m MAA Radiochemical Purity Checker
Tc-99m MAA Radiochemical Purity Checker
Tc-99m MAA Radiochemical Purity Checker
ℹ️ Utility performs:
• Separate control of bound Tc-99m, free pertechnetate and hydrolysed-reduced technetium.
• input.csv structure and numeric-value validation
• LabWare-compatible output.json generation
• Deterministic PASS / FAIL / ERROR status
⚠️ CRITICAL: Any nonconformity shall be reviewed by qualified personnel before the result is used in an operational workflow.
Usage:
Tc99mMAARadiochemicalPurityChecker.exe → demonstration mode (console output)
Tc99mMAARadiochemicalPurityChecker.exe input.csv output.json → evaluate user data
Input format:
BatchNumber,RadiochemicalPurityPercent,FreePertechnetatePercent,HydrolyzedReducedTcPercent,TimeSincePreparationMin
Example:
MAA-RCP-001,96,2,2,30
— WHY IS THIS NEEDED?
Separate control of bound Tc-99m, free pertechnetate and hydrolysed-reduced technetium.
The utility belongs to “RPH Tc-99m MAA Lung Perfusion and Radioembolization Planning QC Suite” and can be used as a standalone check or as part of a wider nuclear-medicine workflow.
⚠️ CRITICAL:
• RadiochemicalPurity: >=90
• FreePertechnetate: <=5
• HydrolyzedReducedTc: <=5
• ComponentBalance: 95-105
• UseTime: <=360
Key features:
• One .NET 6 executable and one Program.cs
• Complete input.csv example with passing, boundary and failing records
• LabWare-compatible JSON: Header, Samples, Results, Status, StatusCode, ErrorMessage, Description and DescriptionEN
• CultureInfo.InvariantCulture for numeric values
• Explicit result for every parameter and empty ErrorMessage for PASS
Critical parameters:
• RadiochemicalPurity: >=90
• FreePertechnetate: <=5
• HydrolyzedReducedTc: <=5
• ComponentBalance: 95-105
• UseTime: <=360
💡 Usage tips:
1. Before operational use, reconcile limits with the approved specification, product information, local SOP and equipment configuration.
2. Retain the source input.csv together with output.json and the executable version.
3. For clinical calculations, use only verified source data and an approved protocol profile.
4. FAIL requires review and is not an automatic medical decision.
5. Limit changes require change control and renewed verification.
⚠️ Note: The utility implements a deterministic CSV-to-LabWare-compatible-JSON workflow and does not replace an approved method, specification, SOP or medical judgement.
The reference limits in this version are a conservative FUZKK project starting profile. They shall be confirmed by the process owner before OQ/PQ and production use.input.csv
BatchNumber,RadiochemicalPurityPercent,FreePertechnetatePercent,HydrolyzedReducedTcPercent,TimeSincePreparationMin MAA-RCP-001,96,2,2,30 MAA-RCP-002,91,5,4,240 MAA-RCP-003,82,12,6,500
URS & FS — user requirements and functional specification
URS — User Requirements Specification
- The utility shall run without arguments in demonstration mode and with two arguments:
input.csv output.json. - Mandatory CSV header:
BatchNumber,RadiochemicalPurityPercent,FreePertechnetatePercent,HydrolyzedReducedTcPercent,TimeSincePreparationMin. - Numeric values shall be parsed with
CultureInfo.InvariantCulture. - Each row shall create a separate Samples object in LabWare-compatible JSON.
- Status shall be PASS, FAIL or ERROR; ErrorMessage shall be empty for PASS.
- The utility shall apply workflow-specific rules and return a result for every parameter.
- Repeated execution with the same data and version shall produce an identical result.
- An invalid header, column count or value type shall produce ERROR, never PASS.
Complete input.csv example
BatchNumber,RadiochemicalPurityPercent,FreePertechnetatePercent,HydrolyzedReducedTcPercent,TimeSincePreparationMin MAA-RCP-001,96,2,2,30 MAA-RCP-002,91,5,4,240 MAA-RCP-003,82,12,6,500
FS — Functional Specification
Main()selects demonstration or file mode.LoadData()validates the exact header and converts each row intoRecord.Evaluate()returns a named tuple containing batch number, product, parameters, overall result and RU/EN recommendations.AddCheck()creates Results items with measured value, unit, limit and IsWithinSpec.RunWithFiles()builds Header/Samples and serializes the result with Newtonsoft.Json.- A global exception becomes a SampleResult with ERROR status and code -1.
Implemented rules
RadiochemicalPurity: >=90FreePertechnetate: <=5HydrolyzedReducedTc: <=5ComponentBalance: 95-105UseTime: <=360
Complete input.csv example
BatchNumber,RadiochemicalPurityPercent,FreePertechnetatePercent,HydrolyzedReducedTcPercent,TimeSincePreparationMin MAA-RCP-001,96,2,2,30 MAA-RCP-002,91,5,4,240 MAA-RCP-003,82,12,6,500
Minimum OQ scenarios
- PASS for the first row.
- Boundary-record processing for the second row.
- FAIL for the third row.
- ERROR for an altered header.
- ERROR for a non-numeric value.
- Identical JSON result on repeated execution.
Included in packages
PetRad QC Suite
A specialised utility package for radiopharmaceutical quality control: PET, SPECT, therapeutic radionuclides, generators and decay calculations.
OpenPetRad3: expanded PET/SPECT and radiopharmaceutical QC package
A curated suite for PET/SPECT radiopharmaceuticals, generator and cyclotron radionuclides, labelled compounds, radiochemical purity, breakthrough, sterility and endotoxin control.
OpenRadiology QC Suite
QC package for radiology and diagnostic imaging: radiopharmaceuticals, PET/SPECT, contrast media, iodinated and gadolinium products, plus particle, sterility and endotoxin checks.
OpenRPH isotope family: Tc-99m
Tc-99m radiopharmaceuticals, kit preparation, generator control, SPECT workflows and calculation utilities.
OpenRPH organ/system: oncology and theranostics
Tumour imaging, PSMA/FAPI/receptor tracers, immuno-PET, targeted radionuclide therapy and radioembolization.
OpenRPH organ/system: pulmonary and ventilation
Lung perfusion, MAA, V/Q, aerosol, xenon ventilation, shunt and pulmonary dosimetry.
OpenRPH Pulmonary Ventilation and Perfusion QC Suite
Tc-99m DTPA aerosol and Technegas control, aerosol-deposition review, V/Q mismatch evaluation and V/Q acquisition completeness.
OpenRPH Tc-99m MAA Lung Perfusion and Radioembolization Planning QC Suite
Quality control of Tc-99m MAA, particle size and count, suspension stability, lung perfusion studies, lung-shunt estimation, pre-therapy dosimetry and concordance with Y-90 distribution.
OpenRPH use case: Tc-99m MAA, V/Q and radioembolization
Macroaggregated albumin: particle size and count, radiochemical purity, resuspension, lung perfusion, lung shunt and pre-therapy Y-90 planning.
OpenRPH workflow: dosimetry and therapy planning
Activity planning, absorbed dose, organ dose, lung shunt, preplanning and therapy verification.
OpenRPH workflow: imaging QC and quantitative interpretation
Acquisition, uptake, clearance, perfusion, transit, ejection fraction, segmentation and quantitative imaging.
OpenRPH workflow: product release QC
Assay, purity, sterility, endotoxins, pH, impurities, appearance and batch-release checks.
OpenRPH: combined radiopharmaceutical QC package
RPH combines PetRad, PetRad2 and PetRad3 into one umbrella package for PET/SPECT, therapeutic radionuclides, generators, labelled compounds, decay calculations, sterility, endotoxins and radiochemical/radionuclidic purity.
Open