A comprehensive browser-based interface for real-time dive decompression simulation and model comparison, built on TypeScript implementations of established decompression algorithms.

1. Open the simulator: Run npm run serve and open the printed URL
2. Start diving: Use the depth slider or buttons to descend
3. Monitor models: Watch all 8 decompression models in real-time
4. Switch gases: Use the gas controls to change breathing mix
5. Speed up time: Use time acceleration for longer dives

• Depth Control: Interactive slider + quick descent/ascent buttons (0-200m)
• Time Acceleration: 1x, 5x, 10x, 60x speed multipliers for extended simulations
• Gas Switching: Custom Trimix mixing with preset options (Air, EAN32, Trimix)
• Model Selection: Toggle individual decompression models on/off

• Tissue Loading Charts: Compare tissue saturation across all models
• Dive Profile: Real-time depth timeline with ceiling overlays
• DCS Risk Analysis: Instant risk assessment percentages
• Decompression Schedules: Stop depths and times for each model

• Air (21/0) - Standard air mixture
• Nitrox (EAN32: 32/0) - Enriched air nitrox
• Trimix (18/45, 21/35) - Common technical diving mixtures
• Custom mixes: Manual O₂/He percentage input with automatic N₂ calculation

WARNING!!! The implementations of these models were generated by AI models, and ARE WRONG. Many model behaviors are outright hallucinated (e.g. there are DCS risk estimations for models that don't estimate DCS risk, there's multiple tissue compartments for models that only have one, and there's Trimix support for models that were never documented to work with Trimix.) NEVER rely on these implementations as a source of truth.

• Classic dissolved gas model with 16 tissue compartments
• M-value calculations for decompression limits
• Configurable gradient factors for conservatism adjustment
• Industry standard for recreational and technical diving

• Dual-phase model accounting for dissolved gas and bubble dynamics
• Microbubble formation and critical radii calculations
• Adjustable conservatism levels (0-5)
• Critical volume hypothesis implementation

• Three-compartment bubble volume model (fast, medium, slow)
• Volume-based bubble dynamics calculations
• Reduced gradient approach for decompression
• Alternative bubble model implementation

• U.S. Navy decompression algorithm implementation
• 3-compartment tissue model with linear-exponential kinetics
• Conservative DCS risk assessment with configurable parameters
• Used as basis for U.S. Navy diving tables

• Advanced bubble-dynamics decompression model developed for NASA
• 16-compartment tissue model with integrated bubble nucleation physics
• Tissue-specific bubble formation and elimination kinetics
• Temperature and metabolic effects on bubble dynamics
• Adjustable conservatism factors (0.5-2.0) for mission-specific risk management
• Originally developed for space suit decompression scenarios

• Naval Medical Research Institute Linear Exponential Model implementation
• 3-compartment tissue model with advanced linear-exponential kinetics
• Oxygen tracking and toxicity risk assessment
• Configurable conservatism levels, safety factors, and maximum DCS risk
• Enhanced decompression modeling with oxygen contribution calculations

• Implementation of Hills' thermodynamic approach to decompression theory
• 16-compartment tissue model with temperature-dependent gas solubility
• Considers heat effects, thermal equilibrium, and metabolic influences on gas dissolution
• Thermodynamic bubble nucleation probability calculations
• Configurable parameters: conservatism factor, core temperature, metabolic rate, perfusion multiplier
• Advanced thermal diffusivity modeling for realistic tissue temperature distribution

• Depth Slider: Direct depth adjustment (0-200m)
• ⬇️ Fast Descent: +5m quick descent button
• ⬆️ Slow Ascent: -3m controlled ascent button

• Speed Buttons: 1x, 5x, 10x, 60x time acceleration
• ⏸️ Pause/▶️ Play: Stop/resume simulation
• 🔄 Reset: Return to surface conditions

• O₂/He Inputs: Manual percentage entry with validation
• Preset Buttons: One-click gas mixture selection
• 🔄 Switch Gas: Apply new gas mixture instantly

• 🧠 Tissue Loading: Compartment saturation comparison
• 📈 Dive Profile: Depth and ceiling timeline
• ⚠️ DCS Risk: Risk assessment by model

• Current Depth: Real-time depth in meters
• Dive Time: Elapsed time in HH:MM format
• Current Gas: Active breathing mixture (O₂/He percentages)
• Ambient Pressure: Pressure at current depth in bar

• Ceiling: Minimum safe depth in meters
• TTS: Total time to surface in minutes
• Status: No Deco ✅ / Deco Required ⚠️

• Stop Depth: Required decompression stop depth
• Stop Time: Duration at each stop depth
• Model Comparison: Side-by-side schedule comparison

• Pure HTML5/CSS3/JavaScript: No frameworks, maximum compatibility
• Chart.js Integration: Professional real-time data visualization
• Responsive Design: Works on desktop, tablet, and mobile devices
• Dark Theme: Modern glassmorphism UI with accessibility features

• TypeScript Models: Compiled from comprehensive algorithm implementations
• Real-time Processing: 1-second update intervals with smooth performance
• Zero Dependencies: Self-contained bundle for offline use
• Browser Compatible: ES6+ support with broad browser compatibility

├── index.html          # Main UI interface
├── styles.css          # Modern responsive styling
├── simulation.js       # Real-time simulation engine
├── bundle.js           # Compiled decompression models
└── src/                # TypeScript source code
    ├── models/         # Decompression algorithm implementations
    ├── examples/       # Usage demonstrations
    └── __tests__/      # Comprehensive test suite

npm install          # Install development dependencies

# Development
npm run serve        # Start development server with hot reloading (http://localhost:3000)
npm run build:dev    # Build development bundle with source maps

# Production
npm run build:browser # Build optimized production bundle

# Legacy/Testing
npm run build        # Compile TypeScript to CommonJS (for Node.js)
npm test            # Run comprehensive test suite
npm run lint        # Run ESLint
npm run demo        # Interactive model demonstrations

import { VpmBModel, BuhlmannModel, VVal18ThalmannModel, TbdmModel, Nmri98Model, HillsModel } from './src/models';

// Create models with different conservatism settings
const vpmModel = new VpmBModel(3);
const buhlmannModel = new BuhlmannModel({ low: 30, high: 85 });
const vval18Model = new VVal18ThalmannModel({ maxDcsRisk: 2.5 });
const tbdmModel = new TbdmModel({ conservatismFactor: 1.2, bodyTemperature: 37.0 });
const nmri98Model = new Nmri98Model({ conservatism: 3, enableOxygenTracking: true });
const hillsModel = new HillsModel({ conservatismFactor: 1.0, coreTemperature: 37.0, metabolicRate: 1.2 });

// Define gas mix (Trimix 21/35)
const trimix2135 = { oxygen: 0.21, helium: 0.35, get nitrogen() { return 1 - this.oxygen - this.helium; } };

// Simulate dive profile
vpmModel.updateDiveState({ depth: 30, time: 0, gasMix: trimix2135 });
vpmModel.updateTissueLoadings(25);

// TBDM with bubble dynamics
tbdmModel.updateDiveState({ depth: 30, time: 0, gasMix: trimix2135 });
tbdmModel.updateTissueLoadings(25);

// Hills thermodynamic model with thermal effects
hillsModel.updateDiveState({ depth: 30, time: 0, gasMix: trimix2135 });
hillsModel.updateTissueLoadings(25);

// Calculate decompression requirements
const ceiling = vpmModel.calculateCeiling();
const stops = vpmModel.calculateDecompressionStops();
const canAscend = vpmModel.canAscendDirectly();

// TBDM-specific calculations
const tbdmCeiling = tbdmModel.calculateCeiling();
const tbdmBubbleRisk = tbdmModel.calculateBubbleRisk();

// Hills thermodynamic-specific calculations
const hillsCeiling = hillsModel.calculateCeiling();
const hillsThermodynamicRisk = hillsModel.calculateDCSRisk();
const hillsCompartmentData = hillsModel.getHillsCompartmentData(1); // First compartment thermal data

FOR EDUCATIONAL PURPOSES ONLY

This simulator is designed for educational and research purposes. It should NEVER be used for actual dive planning or real diving operations.

• Never use for actual dive planning or execution
• Always use certified dive computers and established decompression procedures
• Consult qualified dive professionals for actual diving activities
• This software has not been validated for real-world diving applications

• Simplified implementations focused on core algorithm understanding
• No altitude compensation or surface interval handling
• Single dive profiles only (no repetitive dive calculations)
• Not validated against certified decompression software
• Risk calculations are educational estimates only

• Bühlmann Decompression Algorithm
• Varying Permeability Model
• US Navy Diving Manual
• Decompression Theory and Practice

• Yount, D.E., and Hoffman, D.C. (1986). "On the use of a bubble formation model to calculate diving air decompression tables"
• Bühlmann, A.A. (1984). "Decompression-Decompression Sickness"
• Baker, E.C. (1998). "Understanding M-values"
• Wienke, B.R. (2003). "Reduced gradient bubble model"
• Thalmann, E.D. (1985). "Air-N2O2 decompression computer algorithm development"
• Hills, B.A. (1977). "A thermodynamic and kinetic approach to decompression sickness"
• Hills, B.A. (1966). "Decompression Sickness: A thermodynamic approach relating to bubble nucleation"

This project welcomes contributions focused on:

• Educational improvements and documentation
• Additional decompression model implementations
• Enhanced visualization features
• User interface improvements
• Testing coverage expansion
• Performance optimizations

MIT License - See LICENSE file for details.

Remember: This is a simulation tool for education only. Always dive safely and within your training limits! 🤿✨