README.md

---
title: DR MURPHY ODE — Cryogenic Pump Simulator
emoji: "\U0001f527"
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.23.0
python_version: "3.12"
app_file: app.py
pinned: false
---

# DR MURPHY ODE — Cryogenic Pump Cycle Simulator

Interactive dashboard for cryogenic reciprocating pump analysis using ODE-reformulated engines.

## Engines

| Engine | Speed | Fluids | Method |
|--------|-------|--------|--------|
| **njit_10var** | ~1s/cycle | H2 only | Numba-JIT Euler loop, 10-variable ODE |
| **ode_v2** | ~25s/cycle | H2 + N2 | scipy ODE + Numba/CoolProp dual-backend |
| **fast** | ~3s/cycle | H2 + N2 | Production hand-rolled engine |

## Tabs

1. **Simulation** -- Full 42-parameter single-run with diagnostics, animation, and kWh tracking
2. **Parameter Sweep** -- 1D/2D sweeps with sensitivity analysis and Pareto frontiers
3. **Compare Runs** -- Save and diff up to 10 simulation runs
4. **Real Pump Cycles** -- Overlay real sensor data from TimescaleDB (requires DB access)

## Physics

Simulates ICV/DCV valve dynamics, chamber thermodynamics, and mass flow through a simplex LH2/LN2 cryogenic pump at up to 1200 barg discharge pressure.

Built by Clear Skies Hydrogen (CSH2).