StorageVialSurfaceQualityChecker

Storage Vial Surface Quality Checker

medical_devices Hyperpolarized Xenon RPH Xe-129 medical gases CSV→JSON URS & FS rule-based
Open selection

Utility description: Storage Vial Surface Quality Checker

Storage Vial Surface Quality Checker — HP-Xe Storage Vial Surface Quality Analyzer

ℹ️  Utility evaluates suitability of glass containers for hyperpolarized xenon storage:
    • Wall relaxivity activity
    • Anti-relaxation coating uniformity
    • Paramagnetic impurity content
    • Surface roughness

⚠️  CRITICAL: Glass contains iron that kills polarization!
    Without special coating (Cs, Silane), gas will depolarize in seconds.

Usage:
  StorageVialSurfaceQualityChecker.exe                            → demo mode (console output)
  StorageVialSurfaceQualityChecker.exe input.csv output.json      → evaluate your data

Input format:
BatchNumber,ProductName,Relaxivity_ms,Paramag_ppm,Coating_Percent,Roughness_nm,Pressure_Bar,Max_Relaxivity,Min_Coating

Example:
  VIAL-2026-001,Cs-Coated Vial,50,0.1,98,10,1,100,95

— WHY IS THIS NEEDED?
Vial surface quality is critical for hyperpolarization preservation:
• Xenon atoms constantly collide with vessel walls
• Ordinary glass contains paramagnetic ions (Fe3+) that instantly destroy spin orientation
• Special coatings (cesium, organosilanes) are used to prevent this
• Any coating defects or roughness lead to local rapid signal loss
• Vial quality control helps avoid spoiling entire batch of expensive gas

⚠️  CRITICAL:
• Wall relaxivity activity must be minimal (low rate)
• Coating must cover ≥95% of surface without gaps
• Paramagnetic impurities must be absent (< 1 ppm)
• Roughness must be minimal to reduce collision frequency

Key features:
• Anti-relaxation coating efficiency assessment
• Glass paramagnetic contamination detection
• Surface geometry control (roughness)
• Polarization lifetime prediction in given vessel

Critical parameters:
• Relaxivity Rate: ≤100 (unit dependent)
• Coating Uniformity: ≥95%
• Paramagnetic Impurities: < 1 ppm
• Roughness: < 50 nm

💡 Usage tips:
1. Use NMR relaxometry methods to assess coating quality
2. Perform visual inspection for microcracks and chips
3. Store vials in inert atmosphere before gas filling
4. Avoid inner surface contact with metal tools
5. Regularly test new glass batches from suppliers

⚠️ Note: Unlike standard chemical ware where only cleanliness matters, here quantum "friendliness" of surface is important. Even perfectly clean glass may be unsuitable due to its magnetic properties. The utility helps select only those vessels capable of preserving gas quantum state.

input.csv

BatchNumber,ProductName,Relaxivity_ms,Paramag_ppm,Coating_Percent,Roughness_nm,Pressure_Bar,Max_Relaxivity,Min_Coating
VIAL-2026-001,Cs-Coated Glass Vial,50,0.1,98,10,1,100,95
VIAL-2026-002,Bare Glass Vial (Bad),500,15.0,0,200,1,100,95
VIAL-2026-003,Silane-Coated Vial,80,0.5,96,25,1,100,95

URS & FS — user requirements and functional specification

URS & FS — User Requirements and Functional Specification

This document defines the controlled interface and behaviour of StorageVialSurfaceQualityChecker for “Storage Vial Surface Quality Checker”. Limits from the source description are an initial configuration and shall be reconciled with the approved specification, study protocol, equipment instructions and local SOPs before production use.

Domain constraints and critical parameters

  • Relaxivity Rate: ≤100 (unit dependent)
  • Coating Uniformity: ≥95%
  • Paramagnetic Impurities: < 1 ppm
  • Roughness: < 50 nm

URS — User Requirements Specification

IDRequirementCriticalityAcceptance criterion
URS-001The utility shall accept input.csv with the exact headers defined by the data contract.HighThe file is processed without manual header renaming.
URS-002The utility shall perform a deterministic assessment for “Storage Vial Surface Quality Checker”.HighPASS / WARNING / FAIL is produced for each row.
URS-003Required fields, types, ranges, units and data consistency shall be validated before domain rules.HighSchema errors are separated from nonconformities.
URS-004Critical limits from the description and approved local configuration shall create a critical finding.HighA critical rule violation results in FAIL.
URS-005The result shall be written to machine-readable output.json.HighJSON contains source values, checks, warnings and failures.
URS-006The conformity decision shall not use machine learning.MediumThe result is reproducible from explicit rules and inputs.
URS-007Traceability of batch, source file, rule version and final status shall be retained.HighQA/QC can reproduce the decision.
URS-008The utility shall have exactly one primary portal tag: medical_devices.MediumThe other api / instrumental / medical_devices tags are absent.
URS-009Documentation shall support IQ/OQ/PQ or equivalent CSA/CSV verification.MediumThe contract, test scenarios and change-control rules are supplied with the utility.

input.csv data contract

#FieldTypeUnitSamplePurpose
1BatchNumberstringas specifiedVIAL-2026-001Batch/lot identifier for traceability.
2ProductNamestringas specifiedCs-Coated Glass VialName of the controlled product, gas, procedure or equipment.
3Relaxivity_msdecimalas specified50Controlled input.csv field: Relaxivity ms.
4Paramag_ppmdecimalppm0.1Controlled input.csv field: Paramag ppm.
5Coating_Percentdecimal%98Controlled input.csv field: Coating Percent.
6Roughness_nmdecimalnm10Controlled input.csv field: Roughness nm.
7Pressure_Bardecimalas specified1Delivery-circuit pressure; a patient and equipment safety parameter.
8Max_Relaxivitydecimalas specified100Controlled input.csv field: Max Relaxivity.
9Min_Coatingdecimal°C95Controlled input.csv field: Min Coating.
BatchNumber,ProductName,Relaxivity_ms,Paramag_ppm,Coating_Percent,Roughness_nm,Pressure_Bar,Max_Relaxivity,Min_Coating
VIAL-2026-001,Cs-Coated Glass Vial,50,0.1,98,10,1,100,95
VIAL-2026-002,Bare Glass Vial (Bad),500,15.0,0,200,1,100,95
VIAL-2026-003,Silane-Coated Vial,80,0.5,96,25,1,100,95

FS — Functional Specification

IDFunctionImplementation
FS-001CLI executionStorageVialSurfaceQualityChecker.exe supports demo mode and input.csv output.json mode.
FS-002CSV importRead UTF-8 CSV and validate header, column count and order.
FS-003Schema validationValidate required values, empties, types and basic plausibility.
FS-004Domain rule engineApply explicit rules for “Storage Vial Surface Quality Checker” and locally approved limits.
FS-005Status aggregationFAIL for a critical finding; WARNING for a non-critical deviation; PASS for conformity.
FS-006JSON exportWrite source values, applied rules, statuses, warnings, failures and configuration version.
FS-007Audit supportRetain a result structure suitable for review, investigation, IQ/OQ and change control.
FS-008Integration contractLIMS/ELN/MES or an instrument wrapper creates CSV; the utility returns JSON.

output.json example

{
  "utilityId": "storage-vial-surface-quality-checker",
  "primaryTag": "medical_devices",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "VIAL-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ProductName",
      "value": "Cs-Coated Glass Vial",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Relaxivity_ms",
      "value": "50",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Paramag_ppm",
      "value": "0.1",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Coating_Percent",
      "value": "98",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Roughness_nm",
      "value": "10",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Pressure_Bar",
      "value": "1",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Max_Relaxivity",
      "value": "100",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "warnings": [],
  "criticalFindings": []
}

OQ/PQ test scenarios

IDScenarioExpected result
OQ-001Valid example rowPASS or an allowed WARNING under local rules.
OQ-002Required column missingSchema error; domain checks do not mask it.
OQ-003Non-numeric value in numeric fieldType-conversion error.
OQ-004Critical parameter outside its limitFAIL and a critical finding.
OQ-005Boundary valueThe result follows the configured ≤ / ≥ / < / > operator.
PQ-001Real site dataAgreed QA/QC review retaining CSV, JSON, version and checksum.

QA/QC and change control

  • Do not change column names without updating the validator, documentation and test set.
  • Retain input.csv, output.json, executable version, rule version and checksums.
  • Before production use, verify local limits and execute IQ/OQ/PQ or equivalent CSA.
  • Changes affecting patient safety, dosimetry, gas composition, polarization or equipment require documented impact assessment.

Included in packages

Rph Hyperpolarized Xenon Lifecycle QC Suite

29 utilities for the hyperpolarized xenon lifecycle: isotope composition and gas purity, SEOP and polarization, T1/storage/transport, safe blending and delivery, MRI/SPECT QC, dosimetry, scavenging, recovery and recycling.

Open

RPH isotope family: xenon and gas tracers

Xe-127, Xe-129 and Xe-133 for ventilation, hyperpolarized imaging, gas QC and safety.

Open

RPH organ/system: pulmonary and ventilation

Lung perfusion, MAA, V/Q, aerosol, xenon ventilation, shunt and pulmonary dosimetry.

Open

RPH use case: xenon, ventilation and medical gases

Xe-129, Xe-133, Xe-127, hyperpolarization, SEOP, T1, mixing, scavenging, transport, recovery and ventilation imaging.

Open

RPH workflow: instruments, devices and radiation safety

PET/gamma-camera state, calibration, detector QC, energy window, TOF, shielding and radiation safety.

Open

RPH workflow: product release QC

Assay, purity, sterility, endotoxins, pH, impurities, appearance and batch-release checks.

Open

RPH workflow: stability, storage, decay and waste

Kinetic stability, shelf life, decay correction, expiry, storage, trend and radioactive waste.

Open