Advanced 3D Satellite Tracking & Orbital Mechanics Platform
Real-time visualization, pass prediction, and conjunction analysis powered by CesiumJS and SGP4.
Wiki โข Features โข Quick Start โข Scientific Validation โข Contributing
Scientific Satellite Tracker & Orbital Analysis
- ๐ฅ๏ธ Cinematic HUD & Glassmorphism UI - Sci-Fi inspired interface with backdrop blur, neon accents, and scan-line effects
- โฑ๏ธ Time Scrubber & Replay System - YouTube-style draggable timeline with Zustand-powered state
- ๐ฅ Satellite Cockpit View (POV) - Velocity-vector locked camera with Quaternion orientation
- ๐งฎ Spatial Hashing Collision Engine - O(N) link calculation with 1000kmยณ grid cells
- ๐ Scientific Data Export - TLE, CSV, and JSON format export for research
- ๐ Interactive 3D Globe - Real-time visualization of 25,000+ satellites and space objects
- ๐ฌ Scientific Analysis - Doppler shift, orbital decay, conjunction analysis, pass prediction
- ๐ฐ๏ธ Professional TLE Hub - Multi-source fallback (Space-Track, CelesTrak, AMSAT)
- โ๏ธ Eclipse Detection - Real-time sunlight/shadow status for all objects
- โ๏ธ Deep Linking - Share specific satellites via URL (e.g.,
?sat=25544) - โฑ๏ธ Time Travel - Simulate orbits at any point in history or future
- ๐ฑ Mobile-Friendly - Responsive design with touch-optimized bottom sheet UI
- ๐งญ AR Compass Mode - Use device orientation to spot satellites in the sky
- โจ๏ธ Power User Tools - Keyboard shortcuts, analyst mode, and TLE exporting
- โญ Favorites System - Save and quickly access your favorite satellites
- Node.js 18+
- npm or yarn
# Clone the repository
git clone https://github.com/SpaceEngineerSS/OrbitVieW.git
cd orbitview
# Install dependencies
npm install
# Start development server
npm run devOpen http://localhost:3000 to see the app.
| Technology | Purpose |
|---|---|
| Next.js 16 | React framework with App Router |
| CesiumJS + Resium | 3D globe visualization |
| satellite.js | SGP4/SDP4 orbital propagation |
| Zustand | High-performance state management |
| Web Workers | Spatial Hashing physics engine |
| TailwindCSS | Utility-first CSS |
| Framer Motion | Animations |
| Lucide React | Icons |
src/
โโโ app/ # Next.js App Router pages
โโโ components/
โ โโโ HUD/ # Heads-up display components
โ โ โโโ Sidebar.tsx
โ โ โโโ Timeline.tsx
โ โ โโโ ...
โ โโโ Scientific/ # Analysis tools
โ โโโ DopplerPanel.tsx
โ โโโ DecayPanel.tsx
โ โโโ ...
โโโ lib/ # Core calculations
โ โโโ DopplerCalculator.ts
โ โโโ OrbitalDecay.ts
โ โโโ ConjunctionAnalysis.ts
โ โโโ PassPrediction.ts
โโโ hooks/ # Custom React hooks
| Key | Action |
|---|---|
/ |
Focus search |
F |
Toggle favorite |
R |
Random satellite |
Space |
Toggle play/pause |
Escape |
Close panels |
? |
Show shortcuts |
A |
Toggle Analyst Mode |
Calculate frequency shifts for satellite radio signals based on relative velocity.
Estimate satellite lifetime using atmospheric drag models and B* coefficients.
Analyze close approach events between space objects with risk assessment.
Predict when satellites will be visible from your location with sky plots.
- Space-Track.org: Official source for 25,000+ active payload and debris TLEs
- CelesTrak: Secondary mirror and supplemental data provider
- NASA Horizons: High-precision ephemeris for deep space missions (JWST)
- SatNOGS: Real-time frequency and communication metadata
Contributions are welcome! Please read our Contributing Guide for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
OrbitView is engineered with high-fidelity astrodynamic models to ensure research-grade accuracy in orbital analysis.
-
Propagation: High-precision SGP4/SDP4 models considering Earth's oblateness (J2-J4), atmospheric drag (
$B^*$ ), and deep-space perturbations. -
Atmospheric Model: Optimized exponential decay model correlated with real-time
$B^*$ terms for objects below 600km. - Signal Analysis: Relativistic Doppler shift calculations based on ITRF radial velocity vectors.
We continuously validate OrbitView against ground truth data (STK, NASA J2000 Ephemerides).
| Parameter | Modelled Accuracy | Benchmark Source | Status |
|---|---|---|---|
| LEO Propagation | ~1-3 km (1-day) | NAVSTAR GPS (Post-Fit) | โ Validated |
| Pass Prediction | ยฑ5 seconds (AOS/LOS) | ISS (Zarya) TLE Observations | โ Validated |
| Doppler Shift | ยฑ5 Hz @ 435 MHz | SatNOGS Network Telemetry | โ Validated |
| Orbital Decay | ยฑ15% (Altitude < 400km) | NRLMSISE-00 High-Fidelity | โ Validated |
For in-depth analysis and methodology, please refer to the following:
- ๐ THEORY.md - Comprehensive mathematical framework and derivations.
- ๐ฌ Doppler Validation - Signal shift accuracy report.
- โฑ๏ธ Pass Accuracy - Timeline precision analysis.
- ๐งช Decay Model Comparison - Atmospheric density validation.
This project was developed by Mehmet Gรผmรผล.
๐ Website: spacegumus.com.tr
๐ GitHub: OrbitVieW
๐ X (Twitter): @persesmg
๐ง Email: contact@spacegumus.com.tr
We are committed to evolving OrbitView into the most accurate open-source orbital platform.
- Phase 1 (Q1 2026): TLE History Analysis - Track orbital changes over time for specific objects.
- Phase 2 (Q2 2026): Maneuver Detection - Identify impulsive maneuvers by analyzing TLE residuals.
- Phase 3 (Q3 2026): High-Fidelity Shadow Model - Integrate Penumbra/Umbra atmospheric refraction for optical passes.
- Phase 4 (Q4 2026): Space Weather Integration - Real-time F10.7 solar flux for dynamic atmospheric density scaling.
- CelesTrak for satellite TLE data
- CesiumJS for the amazing 3D globe engine
- satellite.js for orbital calculations
You can test the latest stable version of OrbitView here: orbitview-five.vercel.app