A web-based calculator demonstrating the application of MIRACLE API for pediatric cardiac MRI reference values. Part of SCMR 2026 Innovative Open Source Submission.

Live Demo: miracle-app.surge.sh

This web application demonstrates the practical implementation of the MIRACLE API for calculating z-scores and percentiles for pediatric cardiac MRI measurements. While this demo focuses on volumetric references, the MIRACLE API offers many more endpoints for comprehensive cardiovascular MRI analysis.

🔗 View Full API Documentation

• 📏 Input cardiac measurements in preferred units (cm/in, kg/lb)
• 🧮 Automatic BSA calculation using Haycock formula
• 📊 Instant z-scores and percentile calculations
• 📈 Reference ranges (3rd, 50th, 97th percentiles)
• 🖨️ Print-friendly reports with patient details

The application makes REST calls to two MIRACLE API endpoints:

const ATRIAL_API_URL = 'https://script.google.com/macros/s/...';
const VENTRICULAR_API_URL = 'https://script.google.com/macros/s/...';

const response = await fetch(
    `${VENTRICULAR_API_URL}?domain=Pediatric_Ventricle&parameter=${param}&gender=${gender}&measured=${value}&ht_cm=${ht_cm}&wt_kg=${wt_kg}`
);

Generates a professional report with:

• Patient demographics
• BSA calculation
• Measurement results
• Reference ranges

function printResults() {
    const { ht_cm, wt_kg } = convertToMetric();
    const bsa = calculateBSA(ht_cm, wt_kg);
    // Creates printable report
}

1. Clinical Practice

   • Quick reference value lookup during CMR reporting
   • Standardized reporting with z-scores
   • Printable reports for patient records

2. Research

   • Batch processing of measurements
   • Standardized data collection
   • Easy integration with research workflows

3. Education

   • Teaching tool for trainees
   • Understanding normal ranges
   • Demonstrating the impact of BSA indexing

This demo showcases only volumetric measurements. The MIRACLE API offers many more endpoints including:

• Flow measurements
• Myocardial strain
• T1/T2 mapping
• And more...

Visit MIRACLE API Documentation for the complete list.

1. Clone the repository
2. Open index.html in a browser
3. Enter patient details and measurements
4. Click "Calculate Z-scores"
5. Print or save results as needed

MIT License - feel free to use and modify for your needs.

• SCMR Open Source Initiative

For questions about:

• MIRACLE API: API Documentation
• This Web App: GitHub Issues

Made with ❤️ for the CMR Community