Experience the mind-bending reality of gravitational time dilation in real-time
Features • Installation • Usage • Science • Gallery
Ever wondered what happens when you venture too close to a black hole? This interactive simulator lets you explore the extreme physics of spacetime curvature, gravitational time dilation, and relativistic effects near supermassive black holes.
Based on Einstein's General Theory of Relativity and the Kerr Metric for rotating black holes, this tool provides:
- 🎯 Real-time calculations of time dilation factors
- 🌀 Kerr black hole physics including frame dragging and ergosphere effects
- 📊 Stunning visualizations of spacetime geometry
- ⚡ Advanced metrics including tidal forces, orbital mechanics, and more
- 🎮 Interactive sliders to explore different scenarios
"For every hour I spend here, years pass on Earth" - Interstellar (2014)
|
|
┌─────────────────────────────────────────────────────────────┐
│ 🎨 4-Panel Scientific Plots: │
│ │
│ ├─ Schwarzschild Geometry with Critical Radii │
│ ├─ Time Dilation Profile (logarithmic scale) │
│ ├─ Tidal Force Gradient (Spaghettification!) │
│ └─ Effective Potential for Orbital Motion │
└─────────────────────────────────────────────────────────────┘
| Parameter | Range | Effect |
|---|---|---|
| Black Hole Mass | 1 - 10,000 M☉ × 10⁶ | Larger = stronger gravity |
| Distance Offset | 10⁻⁵ - 10¹⁰ meters | Closer = extreme dilation |
| Spin Parameter | 0 - 0.998 | Rotation effects |
| Observer Velocity | 0 - 0.99c | Special relativity |
Python 3.8+
Jupyter Notebook or JupyterLab# Clone the repository
git clone https://github.com/yourusername/relativistic-spacetime-analyzer.git
cd relativistic-spacetime-analyzer
# Install required packages
pip install -r requirements.txt
# Launch Jupyter Notebook
jupyter notebook spacetime_analyzer.ipynbnumpy>=1.21.0
matplotlib>=3.4.0
ipywidgets>=7.6.0
IPython>=7.25.0Or install directly:
pip install numpy matplotlib ipywidgets IPython- Launch the notebook in Jupyter
- Run all cells (Cell → Run All)
- Adjust sliders to explore different scenarios:
- 🎚️ Mass slider: Change black hole mass
- 🎚️ Distance slider: Move closer/farther from event horizon
- 🎚️ Spin slider: Add rotation (Kerr metric)
- 🎚️ Velocity slider: Observer's speed
🎬 Interstellar's Miller's Planet
```python # Approximate conditions from the movie: Black Hole Mass: ~100 million solar masses Distance: Very close to event horizon (log offset: ~3-4) Time Dilation: ~60,000× (1 hour = 7 years) ```Settings:
- Mass:
100million M☉ - Distance Log:
3.5 - Spin:
0.998(near-extremal)
🌌 Sagittarius A* (Milky Way Center)
```python # Our galaxy's supermassive black hole: Black Hole Mass: ~4.3 million solar masses Schwarzschild Radius: ~12.7 million km ```Settings:
- Mass:
4.3million M☉ - Distance Log:
8.0(safe distance) - Spin:
0.5(moderate rotation)
🔴 M87* (First Photographed Black Hole)
```python # The giant in Messier 87: Black Hole Mass: ~6.5 billion solar masses Schwarzschild Radius: ~19 billion km ```Settings:
- Mass:
6500million M☉ - Distance Log:
10.0 - Spin:
0.9(fast rotation)
The foundation of General Relativity:
Rμν - ½gμν R + Λgμν = (8πG/c⁴)Tμν
For non-rotating black holes:
ds² = -(1 - Rs/r)c²dt² + (1 - Rs/r)⁻¹dr² + r²dΩ²
Where Rs (Schwarzschild radius) is:
Rs = 2GM/c²
The gravitational time dilation experienced:
t_observer/t_earth = √(1 - Rs/r)
For rotating black holes (much more complex!):
ds² = -(1 - Rsρ²/Σ²)c²dt² - (Rsρ²/Σ²)a sin²θ c dt dφ + (Σ²/Δ)dr² + Σ²dθ² + sin²θ[(r² + a²)² - Δa²sin²θ]/Σ² dφ²
Where:
Σ² = r² + a²cos²θΔ = r² - Rsr + a²a = J/(Mc)(spin parameter)
🕳️ Event Horizon
The point of no return. Once crossed, even light cannot escape.
r_event_horizon = Rs = 2GM/c²
⭕ Innermost Stable Circular Orbit (ISCO)
The closest stable orbit around a black hole:
r_ISCO = 3Rs (non-rotating)
r_ISCO = Rs (maximally rotating, prograde)
💫 Photon Sphere
Where light can orbit the black hole:
r_photon = 1.5Rs
💀 Spaghettification
Tidal forces stretch objects due to gravitational gradient:
Tidal Force = 2GM/r³ × Δr
For stellar-mass black holes: deadly even far from horizon
For supermassive black holes: survivable much closer
🌀 Frame Dragging
Rotating black holes drag spacetime itself:
ω = 2aGM/(c r³)
Creates the ergosphere where you must orbit with the black hole.
╔═══════════════════════════════════════════════════════════╗
║ ⚛️ RELATIVISTIC SPACETIME ANALYZER ⚛️ ║
╠═══════════════════════════════════════════════════════════╣
║ ║
║ 🌌 Black Hole Parameters ║
║ ├─ Mass: 100.00 × 10⁶ M☉ ║
║ ├─ Schwarzschild Radius: 295.32 million km ║
║ └─ Hawking Temperature: 6.145 × 10⁻¹⁴ K ║
║ ║
║ ⏱️ TEMPORAL DISPLACEMENT ║
║ ┌─────────────────────────────────────────┐ ║
║ │ 1 HOUR on planet = │ ║
║ │ ⚡ 7 Years, 89 Days on Earth ⚡ │ ║
║ └─────────────────────────────────────────┘ ║
║ ║
║ ⚡ Relativistic Effects ║
║ ├─ Time Dilation: 61,362× ║
║ ├─ Gravitational Redshift: 0.276 ║
║ ├─ Frame Dragging: 2.45 × 10⁻⁸ rad/s ║
║ └─ Tidal Force: 1.23 × 10⁻⁶ m/s²/m ║
║ ║
║ 📊 [Scientific Visualizations Below] ║
║ ║
╚═══════════════════════════════════════════════════════════╝
🎨 Cyberpunk-Inspired Palette:
Primary: #00ffcc (Cyan)
Secondary: #ff3366 (Pink)
Accent: #ffcc00 (Gold)
Purple: #9933ff (Violet)
Background: #0e1117 (Deep Space Black)
Panels: #1a1c24 (Dark Matter Gray)| Metric | Formula | Description |
|---|---|---|
| Escape Velocity | √(2GM/r) |
Speed needed to escape |
| Orbital Velocity | √(GM/r) |
Circular orbit speed |
| Tidal Gradient | 2GM/r³ |
Spaghettification rate |
| Kretschmann Scalar | 48(GM/c²)²/r⁶ |
Spacetime curvature |
| Geodesic Precession | 6πGM/(c²r) |
Orbit rotation |
| Hawking Temperature | ℏc³/(8πGMk_B) |
Black hole temperature |
For rotating black holes with a > 0:
Maximum Energy Extraction: η = 1 - √(1 - a²)
At maximum spin (a = 0.998): ~29% mass-energy conversion!
This tool is perfect for:
- 📚 Physics Students learning General Relativity
- 🎬 Film Enthusiasts exploring Interstellar's science
- 🔭 Astronomy Buffs understanding black holes
- 👨🏫 Educators teaching relativity concepts
- 🧑🔬 Researchers visualizing extreme gravity
spacetime_analyzer.ipynb
├─ RelativisticCalculator Class
│ ├─ Schwarzschild calculations
│ ├─ Kerr metric computations
│ ├─ Orbital mechanics
│ └─ Tidal force analysis
│
├─ Visualization Engine
│ ├─ Matplotlib 4-panel plots
│ ├─ Real-time rendering
│ └─ Base64 image encoding
│
└─ Interactive UI
├─ ipywidgets controls
├─ HTML/CSS dashboard
└─ Dynamic updates
- ⚡ Real-time calculations (< 100ms)
- 🎨 High-resolution plots (100 DPI)
- 🔄 Smooth slider updates
- 💾 Low memory footprint (< 50 MB)
- Albert Einstein - General Theory of Relativity (1915)
- Karl Schwarzschild - Schwarzschild Solution (1916)
- Roy Kerr - Kerr Metric (1963)
- Stephen Hawking - Black Hole Thermodynamics (1974)
- Kip Thorne - Scientific Advisor for Interstellar
- 🎬 Interstellar (2014) - Realistic black hole depiction
- 🔭 Event Horizon Telescope - First black hole image (2019)
- 📖 "The Science of Interstellar" by Kip Thorne
- 🌌 NASA's Black Hole Visualization Studio
- Misner, C. W., Thorne, K. S., & Wheeler, J. A. (1973). Gravitation. W. H. Freeman.
- Carroll, S. M. (2004). Spacetime and Geometry: An Introduction to General Relativity. Addison Wesley.
- Thorne, K. S. (2014). The Science of Interstellar. W. W. Norton & Company.
- Chandrasekhar, S. (1983). The Mathematical Theory of Black Holes. Oxford University Press.
Contributions are welcome! Here's how you can help:
# Fork the repository
# Create your feature branch
git checkout -b feature/AmazingFeature
# Commit your changes
git commit -m 'Add some AmazingFeature'
# Push to the branch
git push origin feature/AmazingFeature
# Open a Pull Request- Add binary black hole systems
- Implement gravitational wave visualization
- Add neutron star equations of state
- Create 3D spacetime embeddings
- Add particle trajectory simulations
- Implement Penrose diagrams
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2024 [Your Name]
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...
- 🌐 Web Version (JavaScript/Three.js)
- 🎮 3D Interactive Visualization
- 📱 Mobile App
- 🔊 Audio Representation of spacetime curvature
- 🤖 AI-Powered scenario suggestions
- 📊 Export calculations to PDF/LaTeX
- 🌍 Multi-language support
- Wormhole Traversability calculations
- Naked Singularity scenarios
- Quantum Effects near horizon
- String Theory corrections
- Holographic Principle visualizations
Q: Is this scientifically accurate?
A: Yes! All calculations are based on Einstein's General Relativity and the Kerr metric for rotating black holes. The formulas are derived from peer-reviewed physics literature.
Q: Can I use this for homework/research?
A: Absolutely! This tool is designed for educational purposes. Please cite appropriately if used in academic work.
Q: What about quantum effects?
A: This simulator uses classical General Relativity. Quantum effects (Hawking radiation, etc.) are noted but not fully modeled, as quantum gravity is still an open research area.
Q: How close to the Interstellar movie is this?
A: Very close! The movie used similar equations. With the right parameters (100M M☉, near-horizon), you can recreate Miller's Planet's ~61,000× time dilation.
- 🌟 Sagittarius A*: Our galaxy's supermassive black hole is 4.3 million solar masses
- 🎬 Interstellar: Used actual GR equations for visual effects (supervised by Kip Thorne)
- ⚫ Gargantua: The movie's black hole produced papers on gravitational lensing
- 🕳️ M87*: First photographed black hole is 6.5 billion solar masses
- ⚡ Energy: Maximally spinning black holes can extract 29% mass-energy (Penrose process)
- 🌌 Size: The largest known black hole is ~40 billion solar masses (Holm 15A*)
Warning: Actual time travel effects may cause temporal paradoxes, aging discrepancies with loved ones, and existential crises. Always maintain a safe distance from event horizons.
