ECG Electrolyte Simulator ⚡

An interactive simulation tool designed to visualize how electrolyte imbalances (specifically Potassium and Calcium) affect the morphology of an ECG waveform.

🌟 Features

• Dynamic Waveform Morphing: Watch the ECG line change in real-time.
• Electrolyte Effects:
  • Potassium (K+): Simulates Hyperkalemia (peaked T-waves, wide QRS) and Hypokalemia (flat T-waves, U-waves).
  • Calcium (Ca2+): Simulates Hypercalcemia (shortened ST) and Hypocalcemia (prolonged ST).
• Clinical Indicators: Visual feedback and alerts for critical levels.
• Dual Implementations: Available in both React (Web) and Streamlit (Python).

---

🚀 Versions

1. Web Version (React + TypeScript + Vite)

Located in /web-version.

• Tech Stack: React 18, TypeScript, Lucide Icons, Vanilla CSS.
• Run Locally:

  cd web-version
  npm install
  npm run dev

2. Python Version (Streamlit)

Located in /python-version.

• Tech Stack: Python 3, Streamlit, Plotly, NumPy.
• Run Locally:

  cd python-version
  pip install -r requirements.txt
  streamlit run app.py

---

🏥 Clinical Context

• Potassium Normal Range: 3.5 - 5.0 mmol/L
• Calcium Normal Range: 8.5 - 10.5 mg/dL

Disclaimer: This tool is for educational purposes only and should not be used for medical diagnosis or treatment decisions.