Skip to content

OpenWave is an open-source subatomic wave simulator for exploring fundamental physics through classical wave mechanics.

License

Notifications You must be signed in to change notification settings

openwave-labs/openwave

OpenWave

License Python openwave openwave openwavelabs openwave-labs

OpenWave LogoOpenWave Logo

What is OpenWave?

OpenWave is an open-source subatomic wave simulator for exploring fundamental physics through classical wave mechanics. The platform lets you model matter and energy phenomena using wave-dynamics, investigating whether forces and particles can emerge from wave-equations.

The platform implements a proposed mathematical framework through various complementary approaches: SCALAR-FIELD methods (similar to lattice gauge theory), VECTOR-FIELD methods, both for research simulations, and a GRANULE-MOTION method for educational visualization.

Computational Approaches

Scalar and Vector Field Methods (Research Oriented)

  • 3D wave-field using partial differential equations (PDEs) and other wave functions
  • Similar methodology to lattice QCD (quantum chromodynamics)
  • Scalable for matter formation and force simulations
  • Indexed by spatial coordinates with field properties at each voxel

Granule-Motion Method (Education Oriented)

  • Discrete particle visualization with phase-shifted oscillations
  • Intuitive for understanding wave mechanics
  • Ideal for education and visualization

Research Goals

OpenWave aims to:

  • Model matter, force unification and energy phenomena through wave-dynamics
  • Simulate particle emergence from standing wave patterns in fields
  • Validate wave-mechanics against known physics
  • Provide computational and visualization tools for wave-dynamics models

Scientific Status: OpenWave is a research tool for computational exploration using lattice field theory methodology to investigate alternative field equations and their predictions.

Core Scope

OpenWave provides computational and visualization tools to explore, demonstrate, and validate predictions through three main functions:

Numerical Validation (Analytical Tools)

  • Runs simulations derived directly from built-in equations and energy-wave phenomena
  • Validates outcomes by comparing them against experimental observations
  • Generates numerical analysis and data support for scientific publications

Visual Demonstration (Educational Tools)

  • Illustrates complex, often invisible phenomena for better comprehension
  • Represents graphically wave equations and analysis
  • Automates animation export for online video publishing

Exploratory Simulations (Hacking Energy)

  • Models experimental wave-field configurations for parametric studies
  • Supports hypothesis testing and comparative analysis against theoretical predictions

Explore Wave-Field Dynamics with 3D Visualization

demo1 clip demo2 clip demo3 clip

Scientific Background

OpenWave implements Energy Wave Theory (EWT), a proposed deterministic subatomic wave mechanics framework that provides an alternative mathematical formalism to quantum field theory (QFT). Key points:

Computational Approach

  • QFT Standard Method: Lattice gauge theory - discretizes spacetime into a grid with quantum field values at each point
  • OpenWave Wave-Field Mechanics - discretizes spacetime into a grid with classical wave-field values at each voxel
  • OpenWave Granule-Motion - educational visualization of wave mechanics
  • Both QFT and OpenWave: Produce predictions about particle behavior, forces and interactions from field dynamics

Scientific Context

  • Quantum field theory is the experimentally validated standard framework
  • Lattice QCD is the standard computational method for QFT (Nobel Prize 2004, 2008)
  • OpenWave uses similar lattice methodology but with different field equations
  • Research question: Can classical wave-field dynamics reproduce quantum-like phenomena?
  • EWT provides testable predictions that can be validated against experimental data

Goal: Computational Utility

OpenWave serves two distinct purposes depending on implementation level:

At Research Levels:

Research questions to investigate:

  • πŸ”¬ Can wave-field dynamics reproduce experimentally observed particle properties?
  • πŸ”¬ Can standing wave patterns model matter formation (electrons, nuclei, atoms, molecules)?
  • πŸ”¬ Can fundamental forces (electric, magnetic, gravitational, nuclear) emerge from wave-field gradients?
  • πŸ”¬ Can computational predictions be validated against experimental data?
  • πŸ”¬ Can this approach provide computationally efficient alternatives for specific simulations?

At Education Levels:

Current capabilities (Released):

  • βœ… Makes wave mechanics intuitive and visual
  • βœ… Demonstrates wave interference, standing waves, propagation
  • βœ… Helps students understand wave-field thinking

Theoretical Source

OpenWave is a programmatic computing and rendering package based on the Energy Wave Theory (EWT) mathematical framework.

Prior to using and contributing to OpenWave, it is recommended to study and familiarize yourself with this approach to subatomic physics from the following resources:

EWT Resources

Pioneers and Origins

The Energy Wave Theory (EWT) is a deterministic quantum mechanics model proposed by Jeff Yee that draws conceptual inspiration from historical work on wave interpretations of quantum mechanics:

Historical Inspiration:

Theoretical Classification: EWT is a deterministic wave mechanics framework that provides mechanistic explanations for quantum phenomena through classical wave-field dynamics.

Installation Instructions

For development installation refer to Contribution Guide

# Make sure you have Python >=3.12 installed
# If not, refer to Python installation instructions below

# Clone the OpenWave repository, on your terminal run:
  git clone https://github.com/openwave-labs/openwave.git
  cd openwave # point to local directory where OpenWave was installed

# Install OpenWave package & dependencies
  pip install .  # reads dependencies from pyproject.toml

Python installation instructions

Usage

Play with the /xperiments module

XPERIMENTS are virtual lab scripts where you can explore wave mechanics and simulate various phenomena.

# Launch xperiments using the CLI xperiment selector

  openwave -x

# Run sample xperiments shipped with the OpenWave package, tweak them, or create your own
xperiment
Standing Wave Xperiment
xperiment
Wave Amplitude Envelope
xperiment
Particle Attraction Xperiment
xperiment
Wave Interference Xperiment

Instrumentation Framework

Xperiments support configurable instrumentation and probe integration for real-time data acquisition and numerical analysis. The framework provides zero-overhead data collection that can be toggled on or off per simulation.

Capabilities:

  • Energy Monitoring: Track charge levels and energy stabilization throughout simulation runtime
  • Field Probes: Sample displacement, amplitude, and frequency at specified voxel coordinates
  • Profile Analysis: Generate cross-sectional displacement profiles along field axes
  • Data Export: Output time-series data to CSV format for external processing
  • Automated Visualization: Generate publication-ready plots for charge profiles, energy levels, and probe time-series analysis
# Enable instrumentation in xperiment parameters
"analytics": {
    "INSTRUMENTATION": True,  # Toggle data acquisition
}
analytics
Energy Charging
analytics
Probe Analysis
analytics
Charge Profile

System Architecture

Modular Design & Development Roadmap

This diagram illustrates the architecture of the OpenWave system, broken down into the following system modules:

ROADMAP

Scalability & Performance

  • Support increasing simulation resolution to handle extreme granularity of Planck-scale interactions
  • Efficient handling of large particle counts and ultra-small wavelength resolution
  • GPU optimized parallel processing for computational performance

Tech Stack

  • Primary Language:
    • Python (>=3.12)
  • Parallel Processing:
    • Taichi Python Acceleration: GPU optimization for computationally intensive wave simulations
  • Math/Physics Libraries:
    • NumPy, SciPy
  • Visualization:
    • Taichi: 3D rendering
    • Matplotlib: numerical analysis plots and cross-sectional graphs
    • Export of 3D images and GIFs for visual inspection
  • Data Output:
    • Numerical datasets, graphs, and analysis reports in open formats (CSV, JSON, PNG, STL)

Wanna Help Developing this Project?

"There is a way to break the laws of physics: Challenge the models used to create them."

OpenWave Team, 11/11/25

License and Attribution

OpenWave is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This means:

  • βœ… You can use, modify, and distribute OpenWave
  • βœ… Commercial use is permitted
  • ⚠️ If you distribute modified versions (including as a web service), you must release your source code under AGPL-3.0
  • ⚠️ You cannot create closed-source proprietary versions (this PROTECTS against misuse while keeping the project truly open-source)

Third-Party Software

OpenWave uses several open-source libraries. See THIRD_PARTY_NOTICES for full attribution and license information for:

  • Taichi Lang (Apache 2.0) - GPU-accelerated computing and rendering
  • NumPy (BSD-3) - Numerical computing
  • SciPy (BSD-3) - Scientific computing
  • Matplotlib (BSD-compatible) - Visualization
  • PyAutoGUI (BSD-3) - GUI automation

All dependencies use licenses compatible with AGPL-3.0.

Trademark

"OpenWave" is a trademark of OpenWave Labs. See TRADEMARK for usage guidelines.