Skip to content
M1KE
Back to projects

tierra

Earth and the solar system in WebGL: Three.js with custom atmosphere and cloud shaders, no build step.

This README is only available in Spanish.

Sistema Solar en tiempo real

Rama DECOMPILED: el código fuente completo, con el motor en Rust y sus tests. El motor se compila a WebAssembly en tu máquina. Si solo quieres ejecutar la app sin instalar Rust, usa la rama COMPILED.

El sistema solar completo en el navegador, con las posiciones reales de cada cuerpo calculadas a partir de datos y métodos oficiales de NASA/JPL. El motor de efemérides está escrito en Rust y se compila a WebAssembly; el render usa Three.js/WebGL y la interfaz React + Tailwind.

  • Tiempo real: por defecto el instante es el de tu reloj, así que ves dónde está cada planeta y cada luna ahora mismo (y el lado nocturno de la Tierra es el que está de noche).
  • Tiempo simulado: ×1, ×5, ×20, ×100, ×1k… ×10M, marcha atrás, pausa y salto a cualquier fecha entre el 3000 a.C. y el 3000 d.C.
  • Contenido: el Sol, 8 planetas, 5 planetas enanos, 460 lunas, 83.867 asteroides, troyanos, centauros, transneptunianos y cometas periódicos.
  • Filtros: planetas, planetas enanos, lunas principales, lunas menores, órbitas, etiquetas y cada clase de cuerpo pequeño por separado.
  • Escala real: los tamaños y las distancias son los reales. Con profundidad logarítmica y origen flotante se puede ir de la superficie de Fobos a la órbita de Eris sin cortes ni temblores.

Portada e instalación de texturas

Al abrir la web aparece una portada con un botón Instalar texturas: descarga una vez los mosaicos de todos los planetas y lunas en la calidad elegida (Medio 2K, Alto 4K o Ultra 8K), verifica cada archivo con su sha256 y los guarda en el navegador (Cache Storage con un Service Worker). Después, el simulador arranca al instante y funciona sin conexión; también se puede instalar como app (PWA). Sin instalar, las texturas se descargan sobre la marcha: primero en 1K y luego en la calidad elegida.

Texturas de todos los cuerpos

scripts/build_textures.py descarga los mosaicos globales oficiales y los corrige para que se vean como a simple vista: los mapas científicos en gris (Ío, Europa, Plutón…) se colorean con la paleta real de cada cuerpo, los de color ampliado (Mercurio, lunas de Saturno) se desaturan, y los casquetes que ninguna nave fotografió se rellenan con un degradado suave.

Cuerpo Fuente
Luna NASA SVS · LRO LROC WAC
Mercurio USGS · MESSENGER MDIS
Marte USGS · Viking Orbiter en color
Júpiter NASA/JPL · Cassini (PIA07782)
Ío, Europa, Ganímedes, Calisto USGS · Galileo SSI + Voyager
Titán, Encélado USGS · Cassini ISS
Dione, Rea, Tetis, Mimas, Jápeto NASA/JPL · Cassini ISS (PIA18434–18439)
Tritón USGS · Voyager 2
Plutón, Caronte USGS · New Horizons
Fobos USGS · Viking / DLR
Tierra NASA Visible Earth · Blue Marble, Black Marble
Sol, Venus, Saturno, Urano, Neptuno Solar System Scope (CC BY 4.0)

Gráficos

El botón ⚙ (o la tecla G) abre el panel de ajustes gráficos:

  • Detección del hardware: identifica tu GPU, los núcleos de la CPU y la memoria, y propone un preset (Bajo, Medio, Alto o Ultra). El navegador pide la GPU dedicada (powerPreference: high-performance).
  • Cálculo multinúcleo: los 84k cuerpos pequeños se propagan en varios hilos de la CPU, cada uno con su propia instancia del motor Rust/WASM (Web Workers).
  • Resolución: escala de renderizado del 50 al 200 % y resolución dinámica que se ajusta sola para mantener los FPS.
  • Calidad: antialiasing MSAA (hasta 8x), texturas de la Tierra de la NASA en 2K, 4K u 8K, filtrado anisótropo, bloom, magnitud límite de las estrellas, densidad de asteroides y límite de FPS.
  • Rendimiento: contador con FPS, tiempo de CPU por frame, tiempo de cálculo de los asteroides, resolución real y draw calls.

Los ajustes se guardan en el navegador.

Realismo y rendimiento

  • Asteroides en la GPU: la ecuación de Kepler de los 84.000 cuerpos pequeños se resuelve en el vertex shader. Los elementos orbitales se suben una sola vez y por frame solo cambian dos números (tiempo y foco), así que la CPU queda libre. El motor Rust multinúcleo queda como alternativa, y un test visual comprueba que los dos dan la misma distribución.
  • Colas de cometas: cola de iones y de polvo orientadas en sentido contrario al Sol, cuya longitud crece al acercarse al perihelio.
  • Atmósferas con dispersión física (Rayleigh + Mie de un rebote, modelo de Nishita) para la Tierra, Venus, Marte y Titán: el limbo azul, la neblina naranja de Titán y la luz rojiza del terminador salen de la física, no de un color pintado.
  • Anillos: los de Saturno proyectan sombra sobre el planeta y el planeta sobre ellos; Urano y Neptuno tienen sus anillos reales, estrechos y oscuros, con los radios de JPL.
  • Sol con granulación animada, oscurecimiento del limbo y corona con serpentinas.
  • WebAssembly con SIMD de 128 bits y optimizado con wasm-opt -O3 (46 KB).

Sombras y eclipses

Las sombras se calculan en los shaders de forma analítica: el Sol es un disco de 695.700 km, y para cada píxel se mide qué fracción de ese disco tapan los cuerpos cercanos (área exacta de solape de dos círculos). Así salen la umbra y la penumbra con su tamaño real, sin mapas de sombras que se pixelen:

  • Eclipses solares: la sombra de la Luna sobre la Tierra, con las luces de las ciudades encendidas bajo la umbra.
  • Eclipses lunares: la Luna se vuelve rojiza dentro de la sombra de la Tierra, por la luz que refracta la atmósfera.
  • Lunas sobre planetas: las sombras de Ío, Europa o Ganímedes sobre Júpiter y las de las lunas de Saturno.
  • Saturno: el planeta proyecta sombra sobre los anillos y los anillos sobre el planeta.

Para que los eclipses caigan en su sitio, la Luna se calcula con la teoría lunar de Meeus (ELP-2000/82 truncada): está a 3–10 km de su posición en Horizons, y el eclipse del 12 de agosto de 2026 sale con γ = 0,8977, el mismo valor que publica la NASA.

Once misiones con su trayectoria real de JPL Horizons durante toda su vida útil: Voyager 1 y 2, New Horizons, Parker Solar Probe, Juno, James Webb, Europa Clipper, Psyche, Lucy, BepiColombo y Cassini. Los vectores de estado (posición y velocidad) se interpolan con splines de Hermite cúbicos: el perihelio de Parker de diciembre de 2024 sale a 6,863 millones de km del Sol, el valor oficial. Si eliges una nave fuera de las fechas de su misión, el reloj salta a la fecha válida más cercana.

Plutón usa también una tabla de Horizons (1950–2100) en lugar de su órbita kepleriana, para que el sobrevuelo de New Horizons del 14 de julio de 2015 salga en su sitio: ?t=2015-07-14T11:30Z&focus=New%20Horizons&dist=60000.

Datos: scripts/fetch_spacecraft.py → web/public/data/spacecraft.bin.

Calendario astronómico y tours

  • Calendario (tecla C): el motor en Rust busca eclipses de Sol y de Luna, oposiciones de los planetas exteriores y máximas elongaciones de Mercurio y Venus. Un clic salta a ese instante con la cámara bien colocada (el eclipse solar se ve desde la Luna, el lunar desde el Sol). Los tests lo comparan con el catálogo de la NASA: los 8 eclipses solares de 2024 a 2027 salen con la hora a menos de 2,5 minutos y γ a menos de 0,0014; los 4 lunares de 2025–2026, a menos de 1 minuto.
  • Tours guiados (tecla T): Gran Tour del sistema solar, El viaje de la Voyager 2 (1977–1989), Los eclipses de 2026 y Parker: tocando el Sol. Avanzan solos o paso a paso. Se pueden enlazar con ?tour=voyager.

Enlaces compartibles

La URL admite parámetros para abrir un momento concreto:

Parámetro Ejemplo Qué hace
t 2026-08-12T17:46Z Salta a esa fecha y hora (UTC) en pausa
speed 100 En lugar de pausar, arranca a esa velocidad
focus Tierra, Io, Titan Enfoca ese cuerpo
dist 20000 Distancia de la cámara en km
view sol, luna Mira el cuerpo desde el Sol o desde otro cuerpo
tour gran-tour, voyager, eclipses-2026, parker Arranca un tour guiado

Por ejemplo, ?t=2026-03-03T11:33Z&focus=Luna&view=sol abre el eclipse lunar total del 3 de marzo de 2026.

Fuentes de datos

Qué Fuente
Planetas E.M. Standish, Keplerian Elements for Approximate Positions of the Major Planets (JPL SSD). Tabla 1 (1800–2050) y Tabla 2 (3000 a.C.–3000 d.C.)
La Luna J. Meeus, Astronomical Algorithms, cap. 47 (ELP-2000/82 truncada); coeficientes de soniakeys/meeus (MIT)
Resto de lunas JPL SSD Planetary Satellite Mean Elements; las 45 principales, refinadas con elementos osculantes de JPL Horizons y el movimiento medio ajustado a 2 años de vectores
Planetas enanos Elementos osculantes de JPL Horizons
Asteroides y cometas JPL SBDB Query API (numerados con H < 15, todos los TNO y los cometas con e < 1)
Orientación de los ejes IAU WGCCRE 2015 (Archinal et al. 2018)
Datos físicos JPL Planetary Physical Parameters y Satellite Physical Parameters
Estrellas HYG Database v4.1 (15.598 estrellas hasta magnitud 7, CC BY-SA 4.0)
Tierra NASA Visible Earth: Blue Marble Next Generation (relieve y batimetría), Black Marble 2016 (luces nocturnas) y nubes

Precisión (contra JPL Horizons / DE441)

cargo test compara las posiciones calculadas con los vectores de Horizons:

  • Planetas, 1800–2050: menos de 0,02° en la mayoría de fechas; el peor caso es Saturno, con 0,17°.
  • Planetas, 1000 a.C.–2500 d.C.: por debajo de 0,32°.
  • La Luna (teoría de Meeus): 3–10 km entre 2024 y 2029.
  • Io, Titán y Tritón: por debajo de 0,2° entre 2024 y 2029.

Estructura

crates/astro-core/     Rust: tiempo, Kepler, Standish, Meeus, rotación IAU, lunas, eventos
crates/astro-wasm/     puente wasm-bindgen (SIMD + wasm-opt)
web/src/engine/        escena Three.js: cuerpos, sombras, atmósferas, estrellas, asteroides en GPU/workers
web/src/data/          catálogos, texturas por niveles, naves, eventos, tours, instalador offline
web/src/ui/            React + Tailwind: portada, paneles, calendario, tours
scripts/               descarga de datos de JPL y texturas de NASA/USGS
tests/e2e/             Playwright

La arquitectura completa, con el flujo de datos y las decisiones de diseño, está en ARCHITECTURE.md; los cambios, en CHANGELOG.md.

Desarrollo

cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings
npm run lint && npm run typecheck
npm test                      # Vitest
npm run build && npm run test:e2e

La CI ejecuta todo esto en cada push (Rust, web y E2E con Playwright), además de CodeQL y Dependabot.

Ramas

Rama Qué contiene Necesitas
COMPILED App lista, con el motor WebAssembly ya compilado Node 20+
DECOMPILED (esta) Todo el código fuente: Rust, tests contra Horizons, script de datos Node 20+, Rust y wasm-pack

Ejecutar

Lo más fácil es usar el script de arranque. Detecta tu sistema (macOS, Linux o Windows), instala lo que falte (Node, Rust, el target WASM y wasm-pack) preguntándote antes, compila el motor y abre la app en http://localhost:5173.

./dev.sh                                         # macOS y Linux (también WSL)
powershell -ExecutionPolicy Bypass -File dev.ps1 # Windows

A mano: Rust con el target wasm32-unknown-unknown, wasm-pack y Node 20+.

npm install
npm run dev        # compila el WASM y abre Vite
cargo test         # valida las efemérides contra Horizons
npm run data       # vuelve a descargar los datos de JPL (opcional)

Este proyecto no está afiliado a NASA ni a JPL.

Licencia

El código se publica bajo licencia MIT. Las texturas y catálogos no son parte del código y conservan su licencia: texturas de la Tierra de NASA Visible Earth (dominio público), resto de planetas de Solar System Scope (CC BY 4.0) y catálogo de estrellas HYG (CC BY-SA 4.0). Los datos orbitales proceden de NASA/JPL.