T1RelaxationTimePredictor

Utility description: T1 Relaxation Time Predictor

T1 Relaxation Time Predictor — T1 Relaxation Time Predictor for Hyperpolarized Xenon

ℹ️  Utility predicts hyperpolarization lifetime:
    • Oxygen impact (paramagnetic quenching)
    • Vial wall quality impact
    • Polarization level prediction at scan time
    • Time to threshold calculation

⚠️  CRITICAL: Oxygen reduces T1 by tens of times!
    Even 100 ppm O2 can make gas unusable within an hour.

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

Input format:
BatchNumber,ProductName,Initial_Pol_Percent,O2_ppm,Temperature_C,Field_T,Surface_Factor,Target_Time_H,Min_Req_Pol

Example:
  T1-PRED-2026-001,Xe-129 Mix,40,10,20,1.5,0.95,2,5

— WHY IS THIS NEEDED?
T1 prediction is critical for HP-MRI logistics:
• Hyperpolarized xenon is unstable and tends toward thermal equilibrium
• Rate of this process (T1) depends on gas composition and storage conditions
• If T1 is too short, gas loses signal before patient can inhale it
• Utility allows calculating "window of opportunity" for study
• Helps decide: use gas now or reject batch

⚠️  CRITICAL:
• Oxygen is strong paramagnet and main enemy of T1
• Vial coating quality determines collision relaxation rate
• Prediction must account for actual transport and preparation time
• Minimum polarization threshold depends on MRI scanner sensitivity

Key features:
• Physical relaxation model accounting for impurities and walls
• Residual polarization prediction at specified time
• Time to critical threshold calculation
• Environmental factor impact assessment (O2, temperature)

Critical parameters:
• Predicted T1: > Target Time
• Predicted Pol: > Min Required
• O2 Impact Factor: < 2.0
• Time to Threshold: > Target Time

💡 Usage tips:
1. Always use most accurate oxygen content data
2. Account for actual vial quality (certified vs standard)
3. Include time buffer for unexpected clinic delays
4. If high O2 content, consider additional gas purification
5. Use prediction for patient scheduling

⚠️ Note: Unlike standard drugs with fixed shelf life, here "shelf life" dynamically changes every second depending on conditions. The utility turns complex physics into a clear gas usability schedule for clinical use.