Skip to content

README.md

Latest commit

 

History

History
492 lines (410 loc) · 23.2 KB

README.md

File metadata and controls

492 lines (410 loc) · 23.2 KB

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 is python-based and lets you model matter and energy phenomena using wave-dynamics and field topology, investigating whether particles and forces 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.

Research Goals

OpenWave aims to demonstrate, in one integrated simulator, the full chain of subatomic physics that downstream applied technology requires. Four primary domains:

  • MATTER — particle emergence (leptons, quarks, nucleons, atoms) from topological defects + wave dynamics in a Lagrangian field
  • FORCES — electric (topology), strong (string tension + standing waves), magnetic (transverse wave from spin), gravitational (density deficit / 4D boost-axis topology), unified in one classical-field framework
  • ELECTROMAGNETIC WAVES — photons, EM radiation, propagation through the vacuum medium
  • HEAT — thermal-energy mechanics at the wave / spin-coherence level (not just bulk kinetic temperature)

The first domain (matter) is the foundation; the other three are what the simulator is designed to compute outputs for. Each produces measurable design parameters.

OpenWave aims to:

  • Model matter, force unification, EM-wave dynamics, and heat phenomena through wave-dynamics and topology in one integrated simulator
  • Simulate particle emergence from topological defects + standing wave patterns in fields
  • Validate against known physics (particle masses, force laws, decay rates, EM dispersion, thermal coupling)
  • Provide computational and visualization tools that yield engineering design parameters for tech development

Scientific Status: OpenWave is a research tool for computational exploration using lattice field theory methodology to investigate alternative field equations and their predictions, with explicit downstream applied-technology output.

demo2 clip

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

COMPUTATIONAL METHODS

OpenWave provides complementary ways to explore wave mechanics:

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

ENERGY LAYERS: Explore potential sources of matter & forces

============================================================
 ✅ LAYER 1: VACUUM FIELD (GROUND STATE)
============================================================
 ✅ LAYER 2: WAVE CENTERS, WAVES & TIME EMERGENCE
============================================================
 ✅ LAYER 3: STANDALONE PARTICLE EMERGENCE
============================================================
 🚧 LAYER 4 (WIP): ELECTROMAGNETISM EMERGENCE
============================================================
 🚧 LAYER 5 (WIP): GRAVITY EMERGENCE
============================================================
 🚧 LAYER 6 (WIP): EMERGENT WAVES (Photon & Thermal Energy)
============================================================
 🚧 LAYER 7 (WIP): COMPOSITE PARTICLE EMERGENCE
============================================================
✅ LAYER 1: Vacuum Field (Ground State)

The vacuum is the static, ordered ground state of the medium — not empty, not pre-oscillating, but a configuration at the minimum of the field's potential V(ψ). It is the source of matter, forces, and time itself: the substrate on which everything else is built — the medium that supports wave perturbations and hosts topological defects (particles). Waves do not pre-exist here; they emerge in Layer 2 when defects start shaking the vacuum.

Energy Wave
Energy Wave

Medium Disturbance
Medium Disturbance

L & T Waves
Longitudinal & Transverse Waves

✅ LAYER 2: Wave Centers, Waves & Time Emergence

Wave centers are topological defects seeded into the vacuum — localized configurations whose winding number is conserved by topology. Each defect stores field energy equal to its rest mass (E = mc²) and oscillates intrinsically at ω = 2mc²/ℏ (the de Broglie clock / time-crystal mechanism). These oscillations shake the surrounding vacuum, emitting perturbation waves whose period IS the local time unit — time emerges from the defect's wave cycle, not from a universal clock. Spherical standing waves form near the center (the particle itself) and traveling waves propagate outward (the force field). A single wave center is a fundamental particle (K=1 neutrino).

Standing Waves
Standing Waves

Wave Interference
Wave Interference

✅ LAYER 3: Standalone Particle Emergence

Same-phase wave centers lock into standing wave energy wells, forming stable multi-WC structures. Opposite-phase wave centers annihilate through wave cancellation. K=10 (electron/positron) is the first stable standalone particle — a 1-3-6 tetrahedral arrangement where all WCs sit near energy nodes.

Particle Annihilation
Particle Annihilation

K=3 Formation
Particle Formation: K=3

K=10 Electron
Particle Formation: K=10

🚧 LAYER 4 (WIP): Electromagnetism Emergence

Non-dual tetrahedral geometry (K=10) forces spin — continuous WC rotation that converts longitudinal to transverse waves. Spin creates charge (electric force), the Bohr magneton (magnetic force), and the traveling wave pattern beyond particle radius that IS the electromagnetic field. Coulomb and magnetic forces emerge from wave interference.

Attractive Forces
Attractive Forces

Repulsive Forces
Repulsive Forces


WORK-IN-PROGRESS
LAYER

🚧 LAYER 5 (WIP): Gravity Emergence

Spin energy conversion (Longitudinal to Transverse) creates a longitudinal amplitude deficit — a "shadow" in the wave field. This energy drainage produces a net inward force: gravity. The 10^-42 ratio between electromagnetic and gravitational force emerges from the accumulated spin deficit over K wave centers.


WORK-IN-PROGRESS
LAYER

🚧 LAYER 6 (WIP): Emergent Waves (Photon & Thermal Energy)

Photons are traveling wave packets — discrete disturbances propagating through the medium that carry energy and apply force upon absorption. Thermal energy is encoded in standing wave amplitude or frequency modulation within particle structure, rather than bulk kinetic motion.


WORK-IN-PROGRESS
LAYER

🚧 LAYER 7 (WIP): Composite Particle Emergence

Standalone particles combine through the strong force (electric + magnetic at sub-wavelength distances, ~137x Coulomb). Protons form from 4 electrons + 1 positron in tetrahedral arrangement. Neutrons add an electron at center. Nuclei, atoms, and molecules build up through Coulomb + magnetic orbital forces.


WORK-IN-PROGRESS
LAYER

SCIENTIFIC BACKGROUND

OpenWave is a shared simulation platform for exploring classical wave-field dynamics and topological field theory as computational approaches to particle emergence. The current research direction combines topological defects (static structure giving integer charge and spin) with wave dynamics (Klein-Gordon-like perturbations around a vacuum field, plus standing-wave interference for orbit quantization) — drawing directly from the frameworks contributed by the collaborators below.

Historical Pioneers

Major Theoretical Contributions

Contributor Framework Contribution
Jeff Yee Energy Wave Theory (EWT) A proposed deterministic quantum mechanics model that draws conceptual inspiration from historical work on wave interpretations of quantum mechanics. Primary physics advisor and collaborator on OpenWave since its inception.
Dr. Jarek Duda Liquid-Crystal Particle Analogs A Landau-de Gennes field framework modeling particles as topological defects with integer-quantized charge. Proposes unifying electromagnetism, quantum mechanics, and gravity through a single vector order parameter, with mass and Zitterbewegung derived from a time-crystal mechanism (see arXiv:2108.07896, arXiv:2501.04036).
Dr. Robert Close "Equation of Everything" (Foundations of Physics 2025) A classical elastic-solid framework that derives the Dirac equation from a nonlinear vector wave equation for spin density, giving every term a concrete physical interpretation in the underlying medium.

Computational Approach

OpenWave evolves classical wave-field values on a 3D lattice via GPU-accelerated PDE integration (Taichi), similar in spirit to lattice QCD but with different field equations. Multiple complementary methods (scalar, vector, director-field, granule-motion) allow cross-validation of mechanisms and direct comparison between candidate Lagrangians.

Open Research Questions

  • Can topological defects in a vacuum field reproduce particle charge quantization, integer winding, and far-field Coulomb interaction?
  • Can Klein-Gordon-like dynamics around the vacuum give rise to mass, relativistic kinematics, and intrinsic (time-crystal) oscillation?
  • Can standing-wave interference between defect emissions produce orbit quantization (electron shells, composite particles)?
  • Can the same framework recover Coulomb, strong, and gravitational forces at their respective scales?

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

UNDER-THE-HOOD

Check SYSTEM ARCHITECTURE for more details on OpenWave's Package contents and architecture.

system

WANNA HELP?

WITH DEVELOPMENT

WITH RESOURCES

LICENSE & 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.

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

OpenWave Team, 11/11/25