Skip to content

data-poems/orrery

Repository files navigation

Orrery

Live License: MIT TypeScript Three.js

From Earth to the Oort Cloud. Interactive, 41,000 stars, 88 constellations, real data, mostly live. Fake scales.

orrery.solar


What's in it

  • 41,119 stars from the HYG Database, plotted by magnitude and B-V color index
  • 88 constellations with IAU stick figures (d3-celestial)
  • 8 planets + 3 dwarf planets + 32 moons from JPL Horizons (J2000 Keplerian elements with secular rates)
  • 3,000 main-belt asteroids with Kirkwood gap distribution
  • 110+ deep sky objects (Messier + bright NGC/IC from OpenNGC)
  • 20+ comets from the Minor Planet Center
  • 14 meteor shower radiants from the IAU Meteor Data Center
  • 5 interstellar spacecraft (Voyager 1 at 165 AU, Voyager 2 at 139 AU, New Horizons, Pioneer 10/11)
  • Oort Cloud particle shell (2,000-50,000 AU)

Live data

  • Near-Earth objects updated daily from NASA NeoWs
  • Asteroid orbits on demand from JPL Small-Body Database
  • Solar wind speed from NOAA Space Weather Prediction Center
  • Satellite TLEs from CelesTrak (ISS + active stations, SGP4 propagation)

Features

  • Cinematic opening tour: deep space down to Earth
  • Stargazer mode with zodiac glyphs and constellation labels
  • Click any planet to zoom in, click its moons to drill down
  • Time controls from real-time to 100 years per second
  • 4 colorblind-accessible themes
  • Mobile-first responsive design with touch controls
  • 2K textures on mobile, 4K on desktop
  • Pre-gzipped data files (82% savings)

Running locally

pnpm install
pnpm dev

Opens at http://localhost:5173

pnpm build    # TypeScript check + Vite build + gzip data
pnpm lint     # ESLint
pnpm preview  # Serve production build

Tech

React 19, TypeScript 5.9, Three.js (r183) via @react-three/fiber + @react-three/drei, Vite 8. No backend. All data from public APIs and bundled catalogs.

Data sources

Source What
JPL Horizons Planetary orbital elements
HYG Database Star catalog (41K stars)
d3-celestial Constellation lines, Milky Way outline
OpenNGC Deep sky objects
Minor Planet Center Asteroids, comets
IAU MDC Meteor showers
Solar System Scope Planet textures (CC BY 4.0)
NASA NeoWs Live near-Earth objects
JPL SBDB Asteroid orbital elements
NOAA SWPC Live solar wind
CelesTrak Satellite TLEs

License

MIT. Planet textures are CC BY 4.0 (Solar System Scope). NASA/NOAA data is public domain.

Author

Luke Steuber - lukesteuber.com - datapoems.io

About

From Earth to the Oort Cloud. 41,000 stars, 88 constellations, real data, mostly live. Fake scales.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors