Skip to content

Maher-star-eng/orbital-symphony

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌌 Orbital Symphony

REBOUND optimizes computation. Orbital Symphony optimizes comprehension.

Orbital Symphony is an interactive scientific instrument for exploring orbital dynamics, chaos, and multi-body gravitational systems through visualization, experimentation, and sonification.

It is built for people who want to understand why systems become unstable, diverge, resonate, or collapse β€” not just compute trajectories.


Current Status

Early development β€” MVP in progress.
First public prototype is currently being built.

Current focus:

  • 2-body simulation engine
  • 3-body simulation engine
  • RK4 numerical integration
  • Perturbation compare mode
  • Sonification Engine v1

Why Orbital Symphony Exists

Many existing orbital mechanics tools are excellent at numerical simulation.

But there is still a gap:

  • Why does a tiny perturbation create a radically different future?
  • When does stability become chaos?
  • Why does prediction fail?
  • How can humans see and hear complex dynamics?

Orbital Symphony focuses on these questions.


Core Philosophy

Orbital Symphony is not trying to replace professional astrophysics software.

It is designed as a:

Scientific instrument for intuition, exploration, education, and chaos perception.


Planned MVP Features

πŸ”­ Perturbation Compare Mode

Run two nearly identical systems side-by-side.

Change one tiny initial condition and watch their futures diverge over time.

Perfect for understanding:

  • sensitivity to initial conditions
  • chaotic growth
  • prediction limits

πŸ“ˆ Divergence Metrics

Quantify separation over time:

  • trajectory distance
  • divergence curves
  • instability indicators
  • escape thresholds

Orbit Visualization

Interactive views for:

  • 2D orbit maps
  • 3D scenes
  • orbit trails
  • barycenter motion
  • rotating reference frames

Sonification Engine (Core Feature)

Sound is a first-class analytical layer β€” not decoration.

Orbital Symphony converts system dynamics into sound so users can hear transitions, instability, resonance, and chaos.

Physical Property Sound Mapping
Velocity Pitch
Total Energy Volume
Chaos Intensity Distortion / Noise
Resonance Lock Harmony
Near Collision Tension rise
Escape Event Sharp break / burst

Why It Matters

  • Detect transitions faster
  • Build intuition through hearing
  • Accessibility support
  • Memorable learning experience
  • New perception channel for nonlinear systems

Chaos Explorer

Observe:

  • resonance emergence
  • near-collision instability
  • escaping bodies
  • periodic vs quasi-periodic motion
  • transition to chaos

Who Is This For?

πŸŽ“ Students

Get β€œaha moments” beyond equations.

πŸ§ͺ Researchers

Use alternative perception tools + exportable experiments.

πŸ‘¨β€πŸ« Educators

Live demos of chaos and orbital mechanics.

🌍 Curious Builders

Explore gravity creatively.


⚠️ Scientific Honesty

Orbital Symphony does not claim to be:

  • mission-grade astrodynamics software
  • a replacement for professional research solvers
  • a long-horizon predictor of chaotic systems
  • a flight-critical decision system

It is a tool for understanding, not false certainty.


Positioning

Tool Focus
REBOUND Precision simulation
GMAT / STK Mission analysis
Educational apps Simplicity
Orbital Symphony Chaos comprehension

Tech Stack

Planned:

  • Python
  • NumPy
  • SciPy
  • Matplotlib / Plotly
  • Pygame / PyQt

Audio:

  • pygame.mixer / sounddevice / pyo

Future:

  • C++ acceleration
  • GPU sweeps
  • Web audio version

πŸ“¦ Installation

⚠️ MVP currently under active development.
Installation instructions will be added with the first runnable release.


πŸ—Ί Roadmap

v0.1 β€” First Motion

  • 2-body + 3-body systems
  • RK4 core
  • orbit trails
  • compare mode
  • sonification core

v0.2 β€” Chaos Visible + Audible

  • heatmaps
  • stability indicators
  • richer sound mappings

v0.3 β€” Interactive Instrument

  • live controls
  • parameter sweeps
  • export figures / audio

v1.0 β€” Public Release

  • polished UI
  • education mode
  • research mode
  • plugin architecture

Contributions Welcome

Interested in:

  • physics
  • scientific visualization
  • audio systems
  • nonlinear dynamics
  • education tooling

Open an issue or contribute.


Final Statement

Orbital Symphony does not promise to tame chaos.

It lets humans see it, hear it, and understand it.

🌌🎡

About

An open-source scientific instrument for simulating, analyzing, and sonifying orbital dynamics and multi-body chaos.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages