🌌 Coherence Field Theory Tutorial

Welcome! The interactive tutorial demonstrates the fundamental recurrence equation and its properties through live simulations and visualizations.

Note: Due to technical limitations with proxying marimo's assets on Heroku, we recommend running the tutorial locally for the best experience.

📚 Access Options

Option 1: Run Locally (Recommended)

Clone the repository and run the tutorial on your machine:

git clone https://github.com/Starling-Systems/coherence-field-simulator.git
cd coherence-field-simulator
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
marimo edit coherence_field_tutorial.py

Then visit http://localhost:2718 in your browser.

View on GitHub

Option 2: View Static Tutorial

Read the complete technical documentation with all mathematical derivations:

View Documentation

Option 3: Use the Simulator

Experiment with the web-based coherence field simulator:

Back to Simulator

🔧 What's in the Tutorial?

Fundamental Recurrence: Interactive exploration of C' = exp(iC) * C
Single Point Evolution: Watch complex numbers evolve with adjustable parameters
Amplitude Conservation: Verify theoretical properties numerically
Phase Wrapping: Visualize phase accumulation and winding
2D Field Dynamics: Spatial patterns and quasi-local coupling

📖 Documentation

For the complete mathematical theory, see our comprehensive documentation:

💡 Need Help?

If you have questions or issues:

Open an Issue on GitHub
Check the TUTORIAL_README.md in the repository