GallbladderEjectionFractionCalculator

Gallbladder Ejection Fraction Calculator

Gallbladder Ejection Fraction Calculator

ℹ️  Utility performs:
    • Calculation of gallbladder ejection fraction from background-corrected pre- and post-stimulation counts.
    • 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:
  GallbladderEjectionFractionCalculator.exe                            → demonstration mode (console output)
  GallbladderEjectionFractionCalculator.exe input.csv output.json      → evaluate user data

Input format:
BatchNumber,PreStimulusGallbladderCounts,PostStimulusGallbladderCounts,PreBackgroundCounts,PostBackgroundCounts,MinExpectedEjectionFractionPercent,InfusionDurationMin

Example:
  GBEF-001,500000,200000,20000,18000,38,60

— WHY IS THIS NEEDED?
Calculation of gallbladder ejection fraction from background-corrected pre- and post-stimulation counts.
The utility belongs to “RPH Tc-99m Hepatobiliary and HIDA QC Suite” and can be used as a standalone check or as part of a wider nuclear-medicine workflow.

⚠️  CRITICAL:
• CorrectedPreCounts: >0
• GallbladderEjectionFraction: >= protocol minimum
• InfusionDuration: >=30 for this reference profile

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:
• CorrectedPreCounts: >0
• GallbladderEjectionFraction: >= protocol minimum
• InfusionDuration: >=30 for this reference profile

💡 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.