# Quantum-Enhanced Photon Beam Simulator with Fractal Correction Engine

## Overview

A quantum-enhanced photon beam simulator that models the propagation of a 450 nm, 20 W CW laser beam through a Fabry-Perot optical cavity in fused silica. The physics engine uses a symmetrized split-step Fourier method with Kerr nonlinearity, linear absorption, quantum noise, and adaptive beam control via a Fractal Correction Engine (FCE) based on Lorenz chaotic attractor dynamics.

## Key Results

| Metric | Value |
|--------|-------|
| Beam quality M² | 1.041 ± 0.005 |
| Quantum efficiency | 0.915 ± 0.014 |
| Energy conservation error | 4.0 × 10⁻¹⁶ |
| Critical power (Marburger) | 797 kW |
| Self-focusing ratio P/P_cr | 2.51 × 10⁻⁵ |
| Kerr phase accumulated | 1.42 × 10⁻³ rad |
| Squeezing (X/P quadrature) | -0.012 / +0.012 dB |
| Cavity finesse | 120.15 |
| Cavity Q-factor | 3.96 × 10⁸ |
| Analytical validation | 5/5 tests pass |
| Physics validation | 30/30 tests pass |

## Files

### Source Code
- `quantum_simulator_enhanced.py` — Main simulator (17 classes, ~1800 lines)
- `enhanced_validation_test.py` — 30-test independent physics validation suite

### Results
- `quantum_enhanced_ultra_report.json` — Complete numerical results from latest run
- `enhanced_validation_report.json` — Validation test results (30/30 pass)
- `quantum_enhanced_ultra_results.png` — 4×4 diagnostic visualization dashboard

### Documentation
- `ZENODO_RESEARCH_PAPER.md` — Full research paper with equations and analysis
- `README.md` — This file

### Metadata
- `requirements.txt` — Python dependencies
- `LICENSE` — MIT License

## Quick Start

```bash
# Install dependencies
pip install -r requirements.txt

# Run the simulation
python quantum_simulator_enhanced.py

# Run the validation suite
python enhanced_validation_test.py
```

## Requirements

- Python 3.8+
- NumPy >= 1.20.0
- SciPy >= 1.7.0
- Matplotlib >= 3.3.0
- Standard desktop hardware (no GPU required)
- Runtime: ~30-60 seconds

