# Sistema solar — guía para empezar

Una aplicación 3D que calcula las posiciones astronómicas para la fecha y hora seleccionadas. Esta versión 22 funciona en tu navegador y guarda todo lo necesario dentro de esta carpeta.

## Abrir la simulación

1. Abre **Escritorio → simulación planetas → 22-sol-tierra-luna**.
2. Haz doble clic en **ABRIR SIMULACION.html** o en **index.html**.
3. Se abrirá tu navegador. Pulsa **Ahora** para seguir la fecha y hora del ordenador.

No necesitas instalar paquetes, abrir una terminal, ejecutar Blender ni conectarte a Internet. Utiliza un navegador moderno con WebGL, como Edge, Chrome o Firefox. Conserva la carpeta completa: `index.html` necesita los archivos de sus subcarpetas. Si recibiste un ZIP, extráelo antes de abrirlo.

Para terminar, cierra la pestaña. No hay ningún servidor local que detener ni necesitas pulsar Ctrl+C. Cuando vuelvas a abrir la aplicación, calculará el instante actual; el ordenador no tiene que permanecer encendido entre visitas.

También puedes leer esta guía en [formato visual](references/LEEME.html).

## Novedades de exploración · 22 de septiembre

- **Buscador universal:** abre **Sistema completo** y escribe un astro, una constelación o un lugar. Por ejemplo, Europa, Orión, Monte Olimpo o Aristarco. Los resultados indican su tipo y planeta; seleccionarlos centra el visor. Los lugares abren su pequeña ficha y activan sus marcas.
- **Diez relieves 3D:** en **¿Qué quieres hacer? → Montañas y cráteres** hay siete regiones lunares y tres marcianas. Se incorporan Aristarco, Platón, Clavius, Hadley, Olympus Mons, Valles Marineris/Melas y Gale. Al lado se ve dónde está la región. La luz sigue el instante del simulador; la opción de estudio permite distinguir las formas de noche. [Datos, resolución y derechos de uso](references/relieves-luna-marte-v22.md).
- **Sombras de lunas sobre Júpiter:** aparecen según la fecha y las posiciones físicas. En **Más mundos para explorar → Lunas de Júpiter** puedes abrir **Ver tres sombras · ejemplo histórico**, con el reloj pausado. [Modelo y límites](references/sombras-jupiter-v22.md).
- **Eclipse solar paso a paso:** nueva lección de cinco etapas del eclipse de Dallas del 8 de abril de 2024. El visor muestra la sombra sobre la Tierra y un esquema de la cobertura local. El cielo de Dallas es opcional; al salir se recupera tu escena. La lección de eclipse lunar sigue disponible. [Fuentes y comprobación](references/leccion-eclipse-solar.md).

Las alturas son datos medidos NASA/GSFC reutilizables con sus créditos, no relieve inventado. Los mapas son históricos; las posiciones y la dirección de la luz se calculan para la fecha elegida. Se mantiene el fondo artístico con cambios cada **20 segundos**. [Registro de verificación](references/verificacion-exploracion-v22.md).

## Descubrir y explorar lugares

- **Descubrir**, en la esquina del visor, abre una ficha del planeta, luna o constelación que estás mirando: imagen, datos sencillos, curiosidades y fuentes desplegables. Hay 21 fichas de cuerpos/conjunto y acceso a las 88 constelaciones. Cierra con **Volver al visor** o Escape; la ficha no cambia el reloj ni el encuadre. El instante consultado queda indicado.
- **Lugares y aterrizajes** abre la lista de sitios del astro. Elige uno y la cámara lo centrará, aunque inicialmente esté en la otra cara. El contador distingue lugares visibles, tapados por el astro/encuadre, etiquetas que no caben y aterrizajes posteriores a la fecha elegida.
- **102 lugares**: Marte tiene 23; Europa, Ío, Ganímedes, Calisto, Titán, Encélado, Plutón y Caronte, seis cada uno. El catálogo común incluye doce lugares lunares, cinco de Fobos y los dos cráteres con nombre de Deimos. Los puntos anteriores de Mercurio, Venus, Tierra y las referencias atmosféricas se conservan.
- Las tarjetas de los lugares muestran descripción, curiosidades y, en siete casos, una foto histórica local con crédito. En los demás se identifica un esquema de coordenadas. Los gigantes conservan referencias atmosféricas: no se inventan cráteres ni la posición actual de tormentas.

Consulta [cómo funcionan las fichas](references/descubrir-v22.md) y el [catálogo, coordenadas y fotografías](references/lugares-ampliados-v22.md).

## Mejoras de la versión 22: destinos más claros

- **Compara tamaños** ahora muestra dos ventanas con mapas de los astros y luz calculada para el instante. Usa Misma escala para comparar diámetros o Ver superficies para ampliaciones independientes.

- **Ilustraciones locales**: tarjeta del sistema solar con planetas texturizados e iconos de libro, cráter, cámara y otros objetos. Son ilustraciones de referencia: la escena grande y las miniaturas del cuerpo seleccionado mantienen los cálculos del instante.
- **Más mundos para explorar** reúne las lunas de Júpiter, Saturno y Marte, Plutón y Caronte, y la Estación Espacial Internacional. Cada familia se abre por separado y conserva su ficha y sus detalles científicos.
- **Desplegables reconocibles**: cabeceras azul pizarra, contenido más oscuro y una línea dorada cuando están abiertos. La ISS usa la misma presentación.
- **Capas de superficie de la Tierra** contiene nubes, luces nocturnas, densidad de nubes y color del océano. La escala se elige arriba con Sistema solar / Escala real; el relieve sigue en Montañas y cráteres. Los controles del suelo están dentro de Caminar por la Luna.
- **Lugares y aterrizajes** también activa y desactiva los cráteres y alunizajes de la Luna. Las escenas antiguas conservan sus capas al recuperarlas.

Módulos de esta revisión: `js/mundos-organizacion.js`, `js/ilustraciones-orbital.js`, `css/orbital-paneles-v22.css` y `css/ilustraciones-orbital.css`. Los dibujos SVG de `assets/orbital-ilustraciones/` se han creado para este simulador; las texturas conservan las fuentes y condiciones documentadas en referencias.

## Funciones conservadas desde la versión 20: explora a tu ritmo

- **Portada amplia**: el sistema solar al abrir, un visor más alto y una tarjeta propia junto al reloj. Una escena compartida sigue teniendo prioridad.
- **Sistema solar / Escala real**: accesos directos arriba. En escala real los planetas se ven diminutos al mirar el sistema completo; elige uno para acercarte.
- **Tiempo bajo el visor**: Ahora, pausa, velocidad y Viajar en el tiempo forman su barra inferior.
- **¿Qué quieres hacer?** reúne las actividades en una lista plegada al inicio. Conoce los planetas, Más mundos y Aprende paso a paso aparecen primero. Dentro de Ajustes y detalles siguen las opciones avanzadas, la comparación espacio/cielo y ¿Qué estoy viendo?
- **Lecciones en su lugar**: abre una lección dentro de Aprende paso a paso. El visor se instala allí y Siguiente queda junto a la explicación. Al salir o plegar la actividad el visor vuelve a la portada. No se crean dos simuladores en paralelo.
- **Catálogo de relieve lunar**: Copérnico, Tycho y el entorno de Apollo 11. El relieve aparece junto a la Luna del instante elegido y la región señalada. Luz solar calculada o luz de estudio opcional; alturas sin exagerar, resolución de origen aproximada de 474 m. Caminar por la Luna conserva su funcionamiento.
- **Lugares en más mundos**: activa Lugares y aterrizajes al visitar un cuerpo. Hay 44 entradas en 18 cuerpos, además del catálogo lunar existente. Europa, Calisto, Ío, Ganímedes, Titán, Encélado y otros incorporan referencias. El catálogo permite elegir lugares de la cara oculta. En las atmósferas se marcan regiones de referencia, no se predice la posición actual de tormentas.
- **ISS**: en las actividades o en Sistema completo → Estaciones espaciales. Órbita terrestre y modelo 3D esquemático, vinculados al reloj. Los datos incluidos tienen época **21 de septiembre de 2026, 04:11:30 UTC**. Usa Datos orbitales y precisión → Consultar elementos actuales para renovarlos; si falla la conexión, puedes importar JSON. La posición es propagada, no telemetría: se advierte al superar 2 días de distancia a la época y se oculta al superar 7. El modelo sigue disponible.

Módulos de organización: `js/presentacion-v20.js` y `css/observatorio-v20.css`. Relieve: `js/taller-lunar.js`. ISS: `js/iss-*.js` y `js/iss.js`. Fuentes, licencias y límites en [ISS](references/iss-v20.md), [lugares planetarios](references/lugares-planetas-v20.md) y [lecciones/relieve](references/leccion-relieve-v20.md).

## Diseño conservado de la versión 19: Orbital

La presentación adopta negro carbón y detalles dorados, con navegación compacta, bordes finos, mando de cámara circular y datos junto al visor. En v19 Tierra era la portada; en v20 se abre el sistema completo; el menú Sistema completo conserva todos los planetas, lunas y constelaciones. Los dos globos cercanos, Tierra y Luna, se encuadran con el mismo ajuste de tamaño que los demás planetas. En móvil el mando empieza plegado para no tapar el astro; pulsa Mover cámara para abrirlo. No se cambian las posiciones ni la iluminación astronómica. Una escena compartida sigue teniendo prioridad sobre la portada.

**Música al abrir:** ahora la solicitud comienza antes de cargar las bibliotecas y la escena 3D. Si tu navegador permite audio automático, empieza en cuanto hay datos del MP3. Si lo bloquea, sigue siendo necesario un gesto en la página o permitir reproducción automática en el navegador. El doble clic del Explorador no cuenta como clic dentro de la página. No se cambian los permisos del navegador. Véase [la explicación y los ajustes normales de Edge/Firefox](references/autoplay-v19.md).

El tema principal está en `css/orbital.css`; los desplegables, en `css/orbital-detalles.css`. El arranque temprano del audio está en `js/inicio-sonido.js`. No se necesita ninguna fuente remota, textura nueva ni plugin.

## Música y efectos conservados de la versión 18

La música está **activada por defecto** y trata de empezar al abrir. Si el navegador exige un gesto, comenzará con el primer clic al explorar el simulador. Pulsa **Silenciar**, junto a **Pantalla completa**, para apagar todo el sonido; el botón cambiará a **Activar sonido**. Se respetan el silencio, los canales y los volúmenes que hayas guardado. La flecha abre los ajustes y muestra si está cargando, sonando o esperando un clic. **Reproducir música** vuelve a activarla y, si estaba al 0 %, la deja al 35 %. El contador confirma que la canción avanza.

- Las dos piezas aportadas se incluyen en `assets/audio/`. La primera se elige al azar; después se alternan indefinidamente, sin repetir la misma consecutivamente. **Otra canción** salta a la otra pieza.
- **Música de fondo** y **Efectos suaves** se activan por separado, con volúmenes independientes. Empiezan bajos y el navegador recuerda tus ajustes cuando su almacenamiento está disponible.
- Clics, casillas y viajes tienen efectos breves creados por síntesis dentro del navegador. Al arrastrar o mover la cámara se oye un gesto discreto, no un sonido repetido por fotograma. No hacen falta descargas ni programas de audio.
- Cambiar de pestaña pausa el audio; al volver se reanuda lo que estaba sonando. Pausar o acelerar el tiempo astronómico no modifica la velocidad de la música.
- El mismo control sigue disponible en pantalla completa. Los efectos son señales de interfaz, no sonidos físicos del vacío espacial.

Consulta [módulos, pistas y límites del audio](references/sonido-v18.md). Conserva la carpeta completa, incluidos los dos MP3.

## Mejoras conservadas de la versión 17

**Seis mundos nuevos:** Plutón, Caronte, Titán, Encélado, Fobos y Deimos.

- En **Sistema completo → Planetas enanos**, elige **Plutón**. Sigue separado de los ocho planetas.
- En **Sistema completo → Lunas**, encontrarás las cinco lunas nuevas, además de la Luna terrestre y las cuatro galileanas.
- La cámara te lleva al mundo elegido y la tarjeta lateral muestra su miniatura, diámetro y distancias del instante seleccionado. Activa **Ejes y observación** para ver su orientación aproximada.
- **Conocer este astro** abre la ficha. También puedes desplegar **Más mundos para explorar**, elegir un destino o abrir **Modelo, precisión y mapas**.
- Titán muestra una bruma ocre ilustrativa. En su ficha puedes activar **Ver mapa infrarrojo de Titán** para explorar la superficie, claramente identificada como infrarroja.
- **Ver también su planeta o compañero** añade contexto al alejarte. El sistema local conserva las proporciones de radios y separaciones. Las escenas guardadas conservan estas opciones y el destino.

Los datos orbitales de JPL se incluyen localmente: no se consulta Internet en cada fotograma. La cobertura principal abarca del **1 de enero de 2020 al 1 de enero de 2036**. Fuera de ella se muestra una aproximación educativa. Las comprobaciones puntuales de precisión aparecen en la ficha y no son una garantía para cualquier instante. Los mapas son históricos, con cobertura desigual; las zonas negras de Plutón y Caronte pueden carecer de datos. Fobos y Deimos tienen forma de elipsoide aproximado, sin relieve tridimensional detallado.

Consulta [los módulos de v17](references/mundos-v17.md), [el modelo y sus mediciones](references/mundos-modelo-v17.md), [las fuentes de los mapas y su reutilización](references/mundos-mapas-v17.md) y [la verificación](references/verificacion-v17.md).

## Mejoras conservadas de la versión 16

1. **Lecciones despejadas.** En fases y eclipses, el visor se concentra en Sol, Tierra y Luna. Abre **Ver cómo llega la luz** para entender la dirección solar o la umbra y penumbra con un esquema explicado. Las distancias del esquema están acortadas; sus dimensiones transversales de sombra se calculan con radios físicos.
2. **Cuatro lunas con sus datos.** Elige Ío, Europa, Ganímedes o Calisto en **Sistema completo → Lunas**. Su miniatura y datos sustituyen la tarjeta de Júpiter. **Ejes y observación** muestra también sus ejes, ecuador y polos; su orientación síncrona es una aproximación geométrica.
3. **¿Qué estoy viendo?** Una ayuda plegable bajo el visor explica el destino y la iluminación. **Datos y cómo se representa** reúne instante UTC, reloj, escala y límites de los mapas.
4. **Pasos directos.** En cualquier lección, pulsa una viñeta numerada para ir a ese momento. **Anterior**, **Siguiente**, **Salir y volver** y **Seguir explorando** siguen disponibles.

Consulta [los módulos y límites de v16](references/mejoras-v16.md) y [la verificación de v16](references/verificacion-v16.md).

## Mejoras conservadas de la versión 15

**Aprende junto al visor grande.** En **Aprender explorando**, elige una lección. La escena espacial conserva todo su ancho y la explicación aparece justo encima, con el título, el número de paso y los controles. El botón dorado **Siguiente →** queda junto a la explicación; **Anterior** permite repasar. El tiempo permanece en pausa entre pasos, que avanzas a tu ritmo.

**El cielo local es opcional.** Debajo del visor puedes abrir **Ver el cielo desde Granada**, o desde el lugar seleccionado. El cielo aparece en una fila propia y no reduce el ancho de la escena espacial. Tu elección de dejarlo abierto o cerrado se conserva al avanzar y retroceder; cada nueva lección empieza con el cielo cerrado.

**Elige cómo terminar.** **Salir y volver** restaura la escena que tenías antes de empezar. **Seguir explorando** termina la lección y conserva el instante y la escena del paso actual. El panel inferior ofrece **Volver a la lección** mientras el recorrido está activo. En pantalla completa, la explicación sigue junto al visor y puede desplazarse si falta altura.

Consulta [uso y módulos de v15](references/mejoras-v15.md) y el [registro de verificación](references/verificacion-v15.md). Se conservan los recorridos, las funciones astronómicas, los recursos y los créditos anteriores.

## Mejoras conservadas de la versión 14

**Un menú para elegir qué explorar.** La primera tarjeta de la cabecera conserva su figura y ahora se llama **Sistema completo**. Ábrela y despliega sólo lo que quieras consultar: **Planetas** contiene los ocho planetas; **Lunas** reúne nuestra Luna y las cuatro lunas de Júpiter ya disponibles (Ío, Europa, Ganímedes y Calisto); **Constelaciones** permite buscar entre las 88 figuras del catálogo. Cada grupo se puede abrir y cerrar por separado.

**El visor queda más libre.** El selector de destinos que ocupaba la esquina de la imagen se ha retirado; sus vistas generales, **Ver todo el sistema** y **Planetas interiores**, están dentro del menú superior. Al elegir un destino, el menú se cierra y la página vuelve al inicio: quedan visibles las tarjetas superiores y la simulación. En pantalla completa se conserva el modo inmersivo. El reloj, los datos laterales y los demás accesos mantienen su funcionamiento.

Puedes cerrar el menú pulsando de nuevo la tarjeta, **Cerrar menú**, **Esc** o fuera del panel. Abrir los grupos o escribir en el buscador no cambia la fecha ni desplaza la página al visor: el viaje comienza al elegir una opción.

Consulta [uso y módulos de v14](references/mejoras-v14.md) y el [registro de verificación v14](references/verificacion-v14.md). Esta mejora reorganiza los destinos existentes; conserva la astronomía, los mapas y los créditos anteriores.

## Mejoras conservadas de la versión 13

**Elige qué observar y vuelve al visor.** Las acciones de los paneles inferiores llevan la página hasta la imagen correspondiente y encuadran el destino: planetas, constelaciones, lugares lunares y eclipses. En **Mi cielo**, el destino aparece en el panorama local. Puedes elegir una constelación en el selector, buscarla y confirmar con **Enter** o pulsar **Encontrarla**; tocar su figura en el cielo mantiene el visor a la vista.

**Explora sin perder el control.** Al terminar de aplicar un paso de un recorrido, una parada lunar o una escena guardada, vuelves a la imagen. Las barras de tiempo no desplazan la página mientras las arrastras: el retorno sucede al soltar o confirmar. Abrir un desplegable para leer o cambiar un ajuste conserva tu lugar en la página. El botón explícito para conocer un astro sigue abriendo su ficha inferior.

**Lugares más fáciles de leer.** Los nombres de regiones, cráteres y aterrizajes en planetas y la Luna usan letra de 15 píxeles, o 14 en un visor estrecho, con más contraste y sombra. El texto se distribuye con sus medidas reales para evitar superposiciones; las marcas geográficas no cambian de lugar.

Consulta [uso y módulos de v13](references/mejoras-v13.md) y el [registro de verificación v13](references/verificacion-v13.md). Se conservan las funciones, datos, mapas y créditos anteriores.

## Mejoras conservadas de la versión 12

**Elige un planeta y míralo arriba.** Al pulsarlo en el visor o en los accesos de **Conoce los planetas**, la cámara viaja hasta él y la página vuelve a la simulación. La ficha técnica no se abre sola. Desde v14, el selector de destinos está en el menú superior **Sistema completo**.

**Sus datos te acompañan.** La tarjeta lateral cambia al astro seleccionado: miniatura con su mapa, nombre, diámetro medio y distancias calculadas para el instante de la simulación. La imagen se orienta con el norte arriba y toma la dirección de observación de la cámara; el Sol ilumina según las posiciones físicas. Es una representación calculada con mapas de referencia, no una fotografía en directo. La Luna conserva su tarjeta en las vistas lunares, generales y **Mi cielo**. El botón de la tarjeta abre la ficha detallada cuando quieras consultarla.

**Descubre lugares con una casilla.** Activa **Lugares y aterrizajes** sobre la escena. Marte incluye Olympus Mons, Valles Marineris, Jezero, Gale y nueve lugares históricos de aterrizaje. También hay referencias en Mercurio, Venus y la Tierra: 23 en total. Pulsa un nombre para leer su descripción, coordenadas y fuente, o **Centrar lugar** para cambiar el encuadre. Al desmarcar la casilla desaparecen las etiquetas.

Los aterrizajes aparecen desde su día UTC y mantienen el punto histórico, aunque un rover haya viajado después. Venus muestra referencias del terreno oculto bajo las nubes. Los planetas gigantes explican por qué no tienen cráteres de superficie ni posiciones de tormentas actuales etiquetadas. Los alunizajes y regiones de la Luna conservan sus controles propios.

La pantalla mantiene su diseño sencillo, con la información extensa en los desplegables. Esta entrega reutiliza los mapas ya incluidos y añade datos públicos con sus fuentes; no incorpora recursos de pago ni nuevas dependencias.

Consulta [uso y módulos de v12](references/mejoras-v12.md), el [catálogo y sus fuentes](references/lugares-planetas-v12.md) y el [registro de verificación](references/verificacion-v12.md).

## Mejoras conservadas de la versión 11

La pantalla principal mantiene sus seis accesos, el reloj y los datos visibles. Las
herramientas nuevas se abren cuando las necesitas; puedes explorar con los controles
sencillos y desplegar los detalles para consultar el modelo y sus límites.

1. **Mapa para orientarte.** Abre **Mapa del sistema** en el visor: muestra los
   planetas, el destino y una marca de cámara con la dirección de mirada. Pulsa un
   planeta para visitarlo o **Volver al sistema completo**. Es una vista cenital
   orientativa con distancias comprimidas; sus círculos son guías de distancia,
   no órbitas calculadas, y no representa la altura de la cámara.
2. **Compara tamaños.** Elige dos astros y observa sus discos a la misma escala de
   diámetros. También aparecen la distancia entre centros en la fecha seleccionada
   y su equivalente en tiempo de luz. La separación gráfica es didáctica; el
   tiempo de luz es distancia dividida por la velocidad de la luz, no una señal
   que persigue un planeta en movimiento.
3. **Constelaciones que puedes encontrar.** En **Dibuja las constelaciones**, busca
   una figura o una estrella conocida y pulsa **Encontrarla**. También puedes
   pulsar las líneas o nombres visibles. La selección queda dorada y abre una
   ficha con estrellas del catálogo y su referencia de dirección desde tu lugar.
4. **Las lunas de Júpiter.** Visita Ío, Europa, Ganímedes y Calisto; sus posiciones
   siguen el mismo reloj. Una casilla permite ocultarlas. Los mapas históricos
   USGS se cargan al visitar Júpiter; no son fotografías en directo. Posiciones y
   luz son calculadas; la orientación de las superficies es aproximada.
5. **Ayuda cuando no ves el destino.** **Encontrarlo** recupera un astro fuera de
   la pantalla. Si una vista lunar está de noche, **Próximo amanecer** busca la
   siguiente salida geométrica del centro solar y salta una hora después para
   explorar con luz. Usa un horizonte ideal, sin edificios ni relieve local en
   ese cálculo; no garantiza que todas las laderas estén iluminadas.
6. **Elige el cielo que quieres simular.** En **Mi cielo**, prueba **Ciudad**,
   **Campo** o **Cielo oscuro**. Cambian el contraste y las estrellas visibles con
   un modelo ilustrativo que incluye crepúsculo, altura y luz lunar. Son
   condiciones elegidas, no meteorología ni contaminación lumínica medida en
   tiempo real. Las posiciones y la fase siguen la fecha y el lugar seleccionados.

**Ahora** siempre permite regresar al reloj actual del ordenador. Las novedades
funcionan sin conexión y no requieren nuevos plugins de Blender ni servicios de
pago. Conserva los créditos y condiciones de los datos al distribuir el proyecto.

Guía de uso y módulos: [las seis mejoras de v11](references/mejoras-v11.md).
Detalles: [comparación](references/comparar-v11.md),
[constelaciones y cielo](references/constelaciones-v11.md) y
[Júpiter, precisión y derechos de sus mapas](references/jupiter-v11.md).

## Interfaz conservada de la versión 10

- **Seis accesos arriba:** Sistema completo (el antiguo acceso Planetas, ahora con menú), Tierra y Luna, La Tierra, La Luna, Desde la Luna y Mi cielo.
- **Sigue explorando:** planetas y constelaciones primero; observación nocturna y recorridos después. Montañas y cráteres y Caminar por la Luna están ahora aquí; al pulsarlos vuelves al visor. Eventos y escenas guardadas cierran esta sección.
- **Diez accesos visuales:** el Sol, los ocho planetas y la Luna tienen una figura y un botón propio. Se conserva el selector. En escritorio, al abrir el catálogo se aprovecha la fila para mostrar todos los accesos y la ficha; al cerrarlo recupera su tarjeta compacta.
- **Ajustes en pareja:** Aspecto y fotografía y Ajustes de la escena quedan uno junto al otro en escritorio. En pantallas estrechas se apilan para mantener los controles legibles.

El terreno lunar conserva la luz de la fecha elegida: si allí es de noche, se verá oscuro. El relieve permite elegir **Luz de estudio** en los ajustes para examinarlo; esa iluminación es artificial. No se han alterado los cálculos astronómicos ni eliminado herramientas.

## Datos y controles conservados de la versión 09

- **Comparar perspectivas:** la comparación entre espacio y cielo conserva un acceso directo junto a las seis vistas principales.
- **Datos a la vista:** barra lateral derecha con fecha y hora. Desde v12, la imagen y las distancias acompañan al astro seleccionado; las vistas generales y lunares conservan los datos Tierra–Luna. En móvil los datos se colocan debajo del visor.
- **Imagen de la Luna:** cuando corresponde la tarjeta lunar, utiliza el mapa incluido y la iluminación calculada para el mismo instante. Miramos desde el centro de la Tierra, con el norte lunar arriba; la inclinación respecto al horizonte de tu ciudad se ve en **Mi cielo**. Es una vista calculada, no una fotografía en directo.
- **Casillas sobre la escena:** trayectorias, ejes y línea de observación, y **Constelaciones y nombres**. Esta última activa juntas las dos capas; los ajustes detallados siguen permitiendo separarlas. Una casilla mixta indica que sólo una está activada.
- **Nombres legibles:** constelaciones con letra de 22 píxeles y contorno oscuro. El tamaño permanece estable al cambiar zoom o pantalla. Se omiten rótulos cortados o que se pisan; al girar aparecen otros.
- **Ajustes de la escena:** escalas, capas, nubes y herramientas lunares permanecen disponibles en su desplegable. Los datos actuales ya no están escondidos ahí.

Se conserva el mando de cámara: **Mover**, **Girar**, **Subir** y **Bajar**. Mantén una flecha pulsada; el botón central recupera el encuadre. En móvil el mando comienza plegado. Con el visor enfocado, WASD y Q/E permiten moverte. Ratón: arrastrar gira, rueda acerca y Mayús + arrastrar desplaza.

**Para empezar:** abre **Sistema completo → Planetas → Marte** y activa **Lugares y aterrizajes** en el visor. Gira el planeta y pulsa una etiqueta. Después visita **Tierra y Luna** y mira cómo cambian los datos al abrir **Viajar en el tiempo**. **Ahora** recupera el instante actual.

| Archivo | Qué contiene |
| --- | --- |
| `references/mejoras-v15.md` | Lecciones junto al visor y cielo local opcional. |
| `js/leccion.js`, `css/leccion.css` | Ubicación de la lección, cielo desplegable y presentación de sus controles. |
| `js/experiencias.js` | Pasos, explicación, avance y salida de las lecciones. |
| `references/mejoras-v14.md` | Uso del menú superior y organización de destinos. |
| `js/menu-destinos.js` | Grupos, opciones, búsqueda y apertura o cierre del menú. |
| `css/menu-destinos.css` | Presentación del menú y adaptación a pantallas estrechas. |
| `js/principal.js`, `js/interfaz.js` | Conexión del menú con los catálogos, las vistas y el retorno al visor. |
| `references/mejoras-v13.md` | Navegación al visor y legibilidad de lugares. |
| `tests/navegacion-observar.cjs` | Regresión de eventos, foco del visor y visitas lunares. |
| `index.html` | Accesos, datos visibles y controles. |
| `js/astro-actual.js` | Tarjeta y miniatura calculada del astro seleccionado. |
| `js/lugares-planetas-datos.js` | Nombres, coordenadas, fechas históricas y fuentes. |
| `js/lugares-planetas.js` | Proyección de etiquetas y ventana del lugar seleccionado. |
| `css/astro-actual.css`, `css/lugares-planetas.css` | Presentación de la tarjeta y los lugares. |
| `references/mejoras-v12.md` | Tarjeta por astro, lugares planetarios y sus límites. |
| `js/orientacion.js` | Mapa esquemático del sistema y cámara. |
| `js/comparar.js` | Tamaños a escala y tiempo de luz. |
| `js/constelaciones.js` | Búsqueda, selección y fichas del catálogo. |
| `js/jupiter.js` | Modelo y dibujo de las cuatro lunas galileanas. |
| `js/ayuda-visual.js` | Ayudas de encuadre y amanecer lunar. |
| `js/cielo.js` | Panorama local y presets de cielo. |
| `references/mejoras-v11.md` | Uso, integración y límites de las seis novedades. |
| `css/tema-v10.css` | Distribución compacta, tarjetas y ajustes. |
| `css/astros-v10.css` | Figuras decorativas y accesos a las fichas. |
| `js/informacion.js` | Fichas y botones de los diez astros. |
| `css/tema-v09.css` | Barra lateral, iconos y diseño adaptable. |
| `js/explorar.js` | Navegación de las vistas y retorno al visor desde la exploración lunar. |
| `js/luna-actual.js` | Miniatura lunar en Canvas 2D, sin otro contexto WebGL. |
| `js/estrellas.js` | Catálogo, figuras y nombres de constelaciones. |
| `js/interfaz.js` | Datos del reloj y casillas compartidas. |
| `js/navegacion.js` | Mando de cámara, conservado de la versión 08. |
| `references/interfaz-v10.md` | Cambios y verificación de esta entrega. |
| `references/interfaz-v09.md` | Organización de esta interfaz. |
| `references/luna-actual-v09.md` | Método y límites de la miniatura lunar. |
| `references/rotulos-v09.md` | Criterios de legibilidad de los nombres. |

## Planetas y fotografía (incorporados en la versión 07)

- **Ocho planetas:** Mercurio, Venus, Tierra, Marte, Júpiter, Saturno, Urano y Neptuno, además del Sol y la Luna. El menú superior **Sistema completo** permite saltar de la vista general a cualquier planeta o a los interiores (antes se llamaba **Viajar a**).
- **Un mismo instante:** posiciones heliocéntricas, ejes y rotaciones calculados con Astronomy Engine. Las órbitas proceden de muestras de efemérides; no se dibujan círculos inventados.
- **Mapas de referencia NASA:** texturas locales, achatamiento de los nuevos planetas y anillos de Saturno con sombras geométricas simplificadas. Las nubes no son imágenes actuales. La versión 07 no incluía satélites de otros planetas; la versión 11 añade las cuatro lunas galileanas de Júpiter.
- **Viajes más suaves:** transición de cámara con aceleración y frenado progresivos, zoom logarítmico y encuadre adaptado al planeta y a la pantalla. Se puede interrumpir arrastrando; respeta la preferencia de movimiento reducido.
- **Fotografía:** el botón del visor alterna entre lectura didáctica y contraste fotográfico. En **Aspecto y fotografía**, exposición automática o fija y compensación de −4 a +10 EV. Con una superficie brillante se muestran muchas menos estrellas; subir la exposición puede saturar el planeta. El modo y la exposición se guardan con tus escenas.
- **Planetas en tu cielo:** posiciones topocéntricas para la ubicación seleccionada. Los puntos se amplían para localizarlos. Los marcadores identificados como guías no significan que el astro sea visible a simple vista.

**Primera visita recomendada:** elige **Saturno** en **Sistema completo → Planetas** y espera al final del viaje. Prueba **Fotografía**, gira con el ratón y compara día y noche. Después visita **Marte** o **Júpiter**. En el menú superior, pulsa la opción **Ver todo el sistema** para ver las órbitas; **Ahora** sincroniza el reloj con el ordenador.

**Escalas y precisión.** La vista didáctica comprime la distancia al Sol como `22 × √(AU)` y amplía radios y separación lunar; conserva las direcciones y calcula la luz con las posiciones físicas. En **Ajustes de la escena → Escala física**, radios y distancias tienen proporciones reales. Los planetas se vuelven diminutos en la vista general: elige un destino para verlos.

Contrastamos 32 estados contra JPL Horizons DE441 en cuatro épocas (1900, 2000, 2026 y 2100): máximo angular heliocéntrico medido ≈17,56 segundos de arco en esas muestras. No es una certificación de todo el intervalo ni una herramienta de navegación espacial. Los errores de posición en kilómetros dependen del planeta; consulta la tabla de [precisión y metodología](references/planetas-v07.md). La geometría espacial es simultánea, sin retardo de luz; el cielo local usa posiciones aparentes desde el observador. Las nubes, manchas de los gigantes y actividad solar no se predicen.

Las fuentes y condiciones comerciales de cada textura están en [recursos planetarios](references/recursos-planetas-v07.md) y `assets/planet-manifest.json`. **No hace falta instalar plugins de Blender** para abrir esta versión web. Se conservan los avisos y licencias de los recursos existentes.

### Dónde está el código nuevo

| Archivo | Función |
| --- | --- |
| `js/planetas-datos.js` | Nombres, radios, períodos y textos. |
| `js/astronomia.js` | Posiciones, rotaciones, luz y órbitas. |
| `js/planetas-materiales.js` | Texturas, achatamiento y anillos. |
| `js/escena.js` | Escalas del dibujo, luces y objetos 3D. |
| `js/camara.js` | Movimiento y encuadre de la cámara. |
| `js/fotografia.js` | Exposición y contraste. |
| `css/tema-v07.css`, `css/fotografia.css` | Presentación de los controles nuevos. |
| `assets/planet-*` | Mapas incluidos para funcionar sin conexión. |
| `references/planetas-v07.md` | Fuentes, límites y validación JPL. |

## Mejoras anteriores que se conservan


- **Interfaz compacta:** la escena y el reloj están juntos. Los paneles empiezan cerrados y ocupan dos columnas en una pantalla amplia; en móvil se apilan. **Explorar los cuerpos** y **Calendario astronómico** quedan uno junto al otro. Los controles de la escena van debajo del visor, evitando que una columna lateral larga deje un hueco vacío.
- **Ubicación y calidad al final:** los desplegables **Ubicación del observador** y **Calidad y consumo** están abajo. No ocupan la cabecera de observación.
- **Modo inmersivo:** la vista ocupa la pantalla con una pequeña barra para el tiempo y las cámaras. **Salir** o **Esc** recuperan la página.
- **Línea de tiempo arrastrable:** ventanas de 24 horas, 7 días o 30 días, con marcas de fases y eclipses. Arrastrar cambia y pausa el mismo reloj de todas las vistas.
- **Mapa lunar:** orientación, límites del terreno, cuatro destinos y un recorrido manual en cada una de las tres regiones existentes.

## Funciones que se conservan

- **Comparar vistas:** espacio y cielo local muestran el mismo instante. Puedes cambiar fecha, pausar o acelerar y comparar ambas perspectivas; en pantallas estrechas se apilan.
- **Qué observar esta noche:** franjas favorables calculadas según altura lunar y oscuridad, dirección para mirar y regiones próximas al terminador. No es un pronóstico de nubes ni de calidad atmosférica.
- **Caminar por la Luna:** cámara a 1,7 m sobre el relieve medido de Copérnico, Tycho o Tranquilidad / Apollo 11; caminar, mirar al Sol o a la Tierra y cambiar la lente. El detalle conserva la resolución de los datos disponibles.
- **Aprender explorando:** recorridos guiados de fases, eclipse lunar y primera observación. Cada paso deja el tiempo en pausa y puedes retroceder o recuperar tu escena anterior.
- **Mis escenas:** favoritos locales con fecha, ubicación, cámara y capas; archivos JSON para trasladarlas, imagen PNG con datos y créditos y enlaces cuando la aplicación se publique con HTTPS.

- **Estrellas y constelaciones:** 8.920 estrellas del catálogo HYG, las figuras de 88 constelaciones y casillas independientes para estrellas, líneas y nombres.
- **Capas lunares:** regiones y seis alunizajes Apollo con casillas independientes, originalmente apagadas; texturas hasta 8k al acercarte.
- **Calidad y consumo:** perfiles Automática, Ligera y Detallada, carga diferida y dibujo bajo demanda durante una pausa estable.
- **Panel con color:** azules y violetas para explorar, ámbar para el tiempo y colores por tipo de evento astronómico. No es un calendario de festivos civiles.

- **Tierra más clara:** nubes menos densas y océanos más azules. En **Capas de superficie** puedes ajustar ambos efectos y comparar las luces nocturnas, nubes y relieve lunar.
- **Eclipses:** sombras calculadas a partir de los radios físicos y la posición del Sol, la Tierra y la Luna; puedes recorrer cada evento, reproducirlo despacio y pausarlo.
- **Tu ubicación:** elige una ciudad o introduce coordenadas y zona horaria. El punto verde sobre la Tierra identifica el lugar; el acceso **Mi cielo** muestra su cielo.
- **Calendario astronómico:** próximas lunas nuevas, lunas llenas y eclipses, además de ejemplos para explorar. Distingue el máximo global de las condiciones locales.
- **Relieve 3D:** regiones lunares con vértices desplazados mediante datos de altura NASA LOLA, curvatura y sombras entre montañas.
- **Fichas de los astros:** pulsa un planeta, el Sol o la Luna para ver datos, explicaciones y acciones. Puedes mostrar ejes, ecuador, inclinación orbital y las caras visible y oculta de la Luna.

Se conservan las transiciones suaves, el seguimiento lunar y la cámara **Desde la Luna**, en un punto fijo de 0° N, 75° E. Esta última activa automáticamente la escala física. El laboratorio Blender incluido sigue siendo el de la versión 02; las novedades anteriores corresponden a la aplicación web.

## Tu primera exploración

Los desplegables arrancan cerrados. Abre **Ajustes de la escena** para cambiar escala, trayectorias, capas o región lunar. Debajo están las herramientas de observación; al final, el lugar del observador y la calidad. Puedes abrir sólo el panel que necesites.

- Abre **Sistema completo** para elegir un planeta, una luna o una constelación. Los otros accesos superiores, como **Mi cielo** y **La Luna**, conservan sus vistas directas.
- Arrastra la escena para girar la cámara. Usa la rueda para acercarte o alejarte. **Restablecer cámara** recupera el encuadre de la vista actual.
- **Ahora** vuelve al presente, con un segundo simulado por cada segundo real. La exactitud de ese instante depende del reloj del ordenador.
- **1 día / segundo** permite apreciar el movimiento: cada segundo que esperas adelanta un día de la simulación. La lista también permite una hora o una semana por segundo.
- **Pausar** detiene el instante simulado; puedes seguir mirando desde otras cámaras.
- **Explorar otra fecha · UTC** permite escribir otra fecha y hora, entre 1900 y 2100. La selección pausa el tiempo. Los paneles muestran la zona horaria elegida para el observador, mientras que este campo siempre usa UTC.
- **Mostrar trayectorias** activa las líneas de las órbitas. Las posiciones se calculan para la fecha elegida; la línea lunar se representa respecto a la Tierra.

En tiempo real el movimiento orbital es muy lento. Que un planeta parezca quieto durante unos segundos es normal.

## Recorridos para probar las novedades

**Observa a pantalla completa.** Pulsa **Modo inmersivo**. La barra conserva la fecha UTC, **Controles** y **Salir**; los ajustes secundarios se pliegan tras 4,5 segundos sin uso. Pulsa **Controles** para volver a ver **Ahora**, **Pausar/Reanudar**, la velocidad, la perspectiva (espacio, cielo local o comparación) y el encuadre 3D. El reloj es el mismo de la página. Si eliges un encuadre 3D mientras sólo ves el cielo local, se abre la perspectiva espacial. **Salir** o **Esc** devuelven el foco y el desplazamiento a su posición anterior. Si el navegador no permite pantalla completa, el mismo modo llena la ventana actual. Más detalles en [modo inmersivo](references/inmersivo-v06.md).

**Desliza el tiempo.** La barra situada inmediatamente debajo del visor admite ratón, dedo y teclado. Elige **24 horas**, **7 días** o **30 días**; arrastra para recorrer ese intervalo y dejar el instante en pausa. Con la barra enfocada, las flechas del teclado cambian un minuto; Inicio y Fin van a sus extremos. Los botones de flecha desplazan una ventana completa; **Centrar** coloca el instante simulado en el centro. El **Ahora** pequeño de la barra selecciona el presente en pausa; el **Ahora** general del reloj recupera el seguimiento en tiempo real. Pulsa una marca de fase o eclipse para ir a su instante calculado. Los eclipses de esta línea son máximos globales, no una promesa de visibilidad desde tu ciudad. Las horas de sus etiquetas usan la zona del observador e indican el desfase UTC. Consulta [línea de tiempo](references/linea-tiempo-v06.md).

**Oriéntate sobre la Luna.** En **Caminar por la Luna**, abre el pequeño desplegable **Mapa lunar** del visor. Muestra el norte arriba y el este a la derecha. La flecha indica tu posición y hacia dónde miras; el límite amarillo y la franja exterior distinguen el área caminable. El selector permite visitar **Centro**, **Cota alta**, **Sector norte** y **Cota baja** del recorte. **Recorrido · 4 paradas** inicia una secuencia manual; avanza y retrocede entre las paradas. Son traslados virtuales entre puntos, no una ruta transitable calculada. Las cotas se eligen a partir de las alturas disponibles y los nombres son descriptivos; no añaden accidentes geográficos, rocas, huellas ni lugares de aterrizaje inventados. Cada región reutiliza sus datos de altura y mantiene el límite real de detalle. Consulta [mapa y recorridos lunares](references/mapa-lunar-v06.md).

**Dos perspectivas del mismo instante.** Pulsa **Comparar vistas**. A la izquierda se muestra la escena espacial y al lado el cielo del observador; en móvil quedan una debajo de otra. Usa el mismo reloj para ambas. La cámara espacial puede mirar la Luna desde una dirección distinta de la Tierra, mientras que el disco del cielo local conserva la orientación del observador. Esto explica que su apariencia no tenga que ser idéntica.

**Planifica una noche.** Abre **Qué observar esta noche**. El cálculo usa la noche de la fecha que estás viendo, desde las 12:00 locales hasta las 12:00 del día siguiente. Considera favorable que la Luna esté por encima de 15° y el Sol por debajo de −6°; son criterios de presentación, no garantía de observación. Selecciona una hora para situar la simulación allí. Las sugerencias de regiones destacan luz rasante cerca del límite entre día y noche lunar. Si esa noche no cumple los criterios, el panel lo indica sin inventar una franja favorable. Al cambiar ciudad o fecha se vuelve a calcular lo necesario.

**Camina por la Luna.** Pulsa **Caminar por la Luna** y elige una región en **Ajustes de la escena**. Arrastra para mirar, usa la rueda para cambiar la lente y pulsa los botones de movimiento. Con el visor enfocado, WASD o las flechas desplazan 50 m por pulsación; Mayús aumenta el paso a 250 m. Es desplazamiento virtual, no una velocidad humana. **Mirar la Tierra** y **Mirar el Sol** apuntan al astro; si está bajo el horizonte, el terreno lo oculta. **Volver al punto inicial** recupera la posición central. El terreno sigue la luz de la fecha simulada: una noche lunar puede verse muy oscura. Para inspeccionar la geometría independientemente de la hora, usa la luz de estudio en **Relieve 3D**.

La cámara queda 1,7 m sobre los triángulos del relieve. Los datos originales tienen separación de cientos de metros; ver desde el suelo no añade rocas, huellas o módulos. Una línea ámbar y el texto del panel avisan al acercarte al límite de la zona caminable. El Sol y la Tierra mantienen su tamaño angular físico; la rueda actúa como una lente. La Tierra ocupa unos dos grados del cielo y puede verse pequeña en un encuadre amplio. Su fase es aproximadamente complementaria de la lunar: una Luna casi llena desde la Tierra corresponde a una Tierra casi nueva desde la Luna. Las altitudes indicadas son geométricas, sin atmósfera lunar. Más detalles en la [guía de suelo lunar](references/suelo-v05.md).

**Aprende por pasos.** En **Aprender explorando**, elige **Entender las fases**, **Cómo ocurre un eclipse** o **Mi primera observación**. Son ejemplos históricos desde Granada. La explicación acompaña al visor grande: avanza con el botón dorado **Siguiente →** y retrocede con **Anterior**. Cada paso cambia fecha, cámara y explicación. Puedes desplegar el cielo local debajo; se conserva abierto o cerrado al cambiar de paso y empieza cerrado al iniciar otra lección. **Salir y volver** recupera la escena previa al recorrido; **Seguir explorando** conserva el instante y la escena del paso actual. Los recorridos no avanzan solos.

**Guarda una escena.** En **Mis escenas**, escribe un nombre y pulsa **Guardar escena**. Se conservan hasta 20 favoritos en el almacenamiento de ese navegador. Al abrir uno, vuelve en pausa al instante guardado; **Ahora** permite regresar al presente. **Exportar JSON** descarga un pequeño archivo con los ajustes; **Importar JSON** lo abre en otro equipo que tenga esta aplicación. No contiene texturas ni toda la simulación. Tras importarlo, pulsa **Guardar escena** si quieres añadirlo a los favoritos del nuevo navegador.

Los favoritos locales dependen del navegador y de la dirección desde la que abres la aplicación; mover la carpeta o borrar datos del navegador puede hacer que no aparezcan. Si el almacenamiento no está disponible, se avisa y la biblioteca funciona temporalmente. Exporta los JSON que quieras conservar. **Descargar imagen** produce una PNG de las vistas actuales con fecha, lugar y créditos. **Copiar enlace** se habilita para compartir el estado en una página HTTPS; desde un archivo local utiliza JSON. Esta entrega no publica el proyecto ni envía datos a un servidor.

**Reconoce el cielo.** Activa las casillas de estrellas, constelaciones y nombres. En **Mi cielo** se sitúan según la fecha, la hora y el observador. Prueba una hora nocturna de Granada y después otra ciudad: cambia el cielo visible. De día las estrellas se ocultan y durante el crepúsculo se atenúan. Las figuras son ayudas de orientación; no son límites oficiales ni líneas físicas en el espacio.

**Localiza regiones y alunizajes.** Abre la vista **Luna** y despliega los controles lunares. Las casillas de regiones y alunizajes se pueden combinar o apagar por separado. Pulsa una etiqueta para centrar el lugar y leer su ficha, o elígelo desde el selector. El listado sigue disponible aunque una etiqueta quede oculta detrás de la Luna o no quepa en pantalla. Los marcadores indican coordenadas: no son fotografías de los módulos de aterrizaje.

**Un eclipse paso a paso.** Abre **Calendario astronómico · fases y eclipses** y selecciona un ejemplo, como **Lunar · 14 mar 2025**. La simulación viaja al máximo y pausa el reloj. Usa el control junto a la escena para ir al inicio, pico o final, arrastra su barra o pulsa reproducir/pausar. Los controles generales también permiten avanzar a **1 minuto / segundo** o **10 minutos / segundo**. En los eventos solares, el botón principal muestra el máximo global; cuando existe, el botón de máximo local abre el cielo del lugar elegido en ese instante. Una ubicación puede quedar fuera del eclipse o tener el Sol bajo el horizonte.

**Tu cielo y tu punto sobre la Tierra.** Abre **Ubicación del observador · Granada**, al final de la página, y elige una ciudad en el formulario. Para cualquier otra ubicación, usa coordenadas personalizadas: latitud norte y longitud este positivas; sur y oeste negativas. La altitud está en metros sobre el mar. La zona horaria puede ser `Europe/Madrid`, `America/New_York` o `UTC`. Tras aplicar el lugar, abre el acceso **Mi cielo**. Verás dirección, altura y próximas salidas y puestas. En la ficha Tierra, **Centrar mi ubicación** conecta el lugar con la escena espacial. Cambiar de ubicación no cambia el instante de la simulación.

**Montañas y cráteres.** Pulsa **Relieve 3D** y elige Copérnico, Tycho o Tranquilidad · Apollo 11 en el selector de región. Arrastra para cambiar el ángulo y utiliza la rueda o un gesto de pinza para acercarte. **Ver la malla de alturas** permite ver los triángulos que forman el terreno. Por defecto se usa el **Sol del instante simulado**: si es de noche en la región elegida, se verá oscuro. Elige **Luz de estudio · explorar el relieve** para examinarlo a cualquier hora; esa luz se identifica y no representa el Sol real.

En el calendario, violeta identifica fases lunares, ámbar eclipses solares y coral eclipses lunares; los nombres también identifican cada tipo. La tarjeta seleccionada se marca y el contexto indica si el visor sigue dentro del evento. El calendario busca desde la fecha indicada en su cabecera. Después de viajar en el tiempo, pulsa **Buscar desde la fecha del visor** si quieres una nueva lista de próximos eventos.

Para entender la geometría, abre la ficha Luna y pulsa **Inclinación orbital**. Se encuadran la Tierra y la Luna casi de canto, con un disco azul como referencia del plano eclíptico. Compáralo con la trayectoria lunar calculada: su inclinación ayuda a explicar por qué no hay un eclipse cada mes. Las guías doradas señalan el eje y el norte; el azul identifica el sur, el ecuador y el plano de referencia; el verde identifica al observador.

## Calidad, fluidez y carga de recursos

Abre **Calidad y consumo**, al final de la página. **Automática** elige un perfil según el dispositivo. Puedes cambiar a **Ligera** para reducir resolución de dibujo, estrellas débiles, densidad de la malla y resolución de sombras; o a **Detallada** para priorizar los mapas y el relieve. Cambiar la calidad no cambia las posiciones astronómicas, las coordenadas de los lugares ni las alturas físicas.

Al arrancar se usa el mapa lunar básico. La textura de mayor resolución y el mapa de relieve de sombreado se preparan al abrir una vista lunar; los datos y la geometría del terreno se crean al abrir **Relieve 3D** o **Caminar por la Luna**; ambas vistas comparten la misma región cargada. El mapa de color detallado llega a 8192 × 4096 píxeles, con alternativa de 4096 × 2048 para tarjetas que no aceptan la textura mayor. El cielo local crea su segundo contexto gráfico la primera vez que se abre. Los recursos ya cargados se reutilizan; «carga diferida» significa que se leen más tarde desde esta misma carpeta, no que se descargan de Internet.

Con el reloj a velocidad real, el planificador actualiza aproximadamente una vez por segundo. Con el tiempo acelerado puede actualizar hasta 20 veces por segundo. Durante una transición de cámara solicita los fotogramas de pantalla necesarios. Una pausa estable, sin interacciones ni cargas pendientes, no mantiene un bucle de dibujo ni vuelve a calcular posiciones. Cambiar cámara, fecha, ubicación o casillas vuelve a dibujar cuando hace falta.

Al ocultar la pestaña se detienen los cálculos y el dibujo. Al regresar, el reloj recupera el tiempo que corresponda a su modo; **Ahora** sigue el reloj del ordenador. Estas son medidas de funcionamiento del código, no una promesa de fotogramas por segundo ni una medición del ahorro de batería en todos los equipos.

## Dos escalas de dibujo

**Didáctica** aumenta los cuerpos y adapta las distancias para que puedas encontrar los tres fácilmente. Es el modo más cómodo para empezar. Los tamaños y separaciones de la pantalla no se pueden medir como si fueran una fotografía espacial.

**Física** conserva las proporciones de tamaños y distancias. En una vista de todo el sistema, la Tierra y la Luna son diminutas. Cambia a sus encuadres individuales para ver las superficies. Los valores de distancia del panel siguen siendo astronómicos en ambas escalas: cambiar el dibujo no cambia la órbita calculada.

## Qué es real y qué está simplificado

Las posiciones, los ejes, las rotaciones y la fase lunar se calculan con Astronomy Engine para el instante seleccionado. La luz utiliza la dirección del Sol. Son cálculos astronómicos; no una transmisión de vídeo desde un satélite.

Los mapas de superficie proceden de observaciones NASA: la Tierra usa Blue Marble de septiembre de 2004 y la Luna un mapa LRO preparado en 2025. Son referencias fijas, **no fotografías actuales**. Los detalles de procedencia están en [textures.md](references/textures.md).

Las sombras de eclipse usan la intersección de discos solares y cuerpos aproximados como esferas; el rojo tenue de la totalidad lunar es ilustrativo. El calendario utiliza el motor astronómico para sus fechas y condiciones locales. Puede haber pequeñas diferencias entre un contacto tabulado y el borde de la sombra dibujada. La fracción iluminada del panel espacial es geocéntrica; el aspecto que ves en la escena depende de la cámara.

La Luna completa conserva una geometría esférica con relieve de sombreado. **Relieve 3D** abre otra escena: Copérnico cubre 200 × 200 km, Tycho 180 × 180 km y el entorno de Apollo 11, 100 × 100 km. El DEM64 de NASA LOLA aporta alturas con unos 474 m de separación norte–sur; la separación este–oeste depende de la latitud. No hay exageración vertical. La interpolación de la malla no añade piedras, módulos ni huellas. La luz de estudio facilita examinar la geometría, pero no depende de la fecha.

La meteorología actual y la actividad solar no se representan. Las nubes y luces nocturnas son mapas históricos; los ajustes de azul y densidad de nubes son decisiones visuales. Las estrellas proceden del catálogo HYG y sus direcciones incluyen movimiento propio aproximado; no se modelan paralaje anual, aberración ni toda la física de observación. Su brillo y tamaño gráfico son orientativos. El cielo local no predice nubes ni mide la contaminación lumínica actual. Desde la versión 11 incluye presets visuales de contaminación y atenuación lunar aproximada; sus coeficientes no son una predicción fotométrica calibrada. El cielo local usa un horizonte ideal, sin edificios ni montañas. Busca salidas y puestas en los siguientes 3 días; en regiones polares puede no haber un evento dentro de ese intervalo.

Consulta las explicaciones específicas: [eclipses y calendario](references/eclipses-v03.md), [ubicaciones y cielo local](references/ubicacion-v03.md), [estrellas y constelaciones](references/estrellas-v04.md) , [exploración lunar v04](references/luna-v04.md), [planificador nocturno](references/noche-v05.md), [suelo lunar](references/suelo-v05.md) y [recorridos y escenas](references/experiencias-v05.md). La [guía del terreno v03](references/terreno-v03.md) se conserva como historial; su resolución de datos ya no describe el relieve v04.

## Dónde está cada cosa

| Archivo o carpeta | Para qué sirve |
| --- | --- |
| `js/leccion.js` y `css/leccion.css` | Lección junto al visor, cielo opcional y controles accesibles también en pantalla completa. |
| `references/mejoras-v15.md` | Uso de las lecciones y responsabilidades de sus módulos. |
| `ABRIR SIMULACION.html` | Entrada cómoda con doble clic. |
| `index.html` | Estructura de la pantalla, textos y lista de scripts. |
| `css/estilos.css` | Base de tipografías, márgenes y diseño adaptable. |
| `css/tema-v04.css` | Paleta del panel, tarjetas, estados y etiquetas lunares. |
| `css/tema-v05.css` | Base de comparación de vistas y controles introducidos en v05. |
| `css/tema-v06.css` | Distribución compacta, paneles plegables y columnas. |
| `js/inmersivo.js` y `css/inmersivo.css` | Pantalla completa, alternativa a toda ventana, controles y recuperación del foco. |
| `js/linea-tiempo.js` y `css/linea-tiempo.css` | Barra temporal, búsqueda de fases y eclipses y selección del instante. |
| `js/mapa-lunar.js` y `css/mapa-lunar.css` | Mapa de alturas, orientación, destinos y recorrido manual. |
| `css/exploracion.css` | Fichas, guías, controles de terreno y nuevos paneles. |
| `js/configuracion.js` | Ajustes de dibujo, colores 3D, radios y encuadres. |
| `js/astronomia.js` | Cálculos astronómicos; expone la API `SolarPhysics`. |
| `js/reloj.js` | Hora actual, pausa, fecha elegida y avance del tiempo. |
| `js/camara.js` | Giro, zoom y posición de la cámara. |
| `js/escena.js` | Cuerpos 3D, iluminación, materiales y trayectorias. |
| `js/materiales.js` | Materiales, capas visuales, nubes menos densas y ajuste azul de océanos. |
| `js/atmosfera.js` | Atmósfera visual según iluminación solar. |
| `js/observador.js` | Validación de coordenadas, cielo local y salidas/puestas. |
| `js/ubicacion.js` | Ciudades y formulario de coordenadas y zona horaria. |
| `js/cielo.js` y `css/cielo.css` | Cielo desde el lugar elegido y controles de ubicación. |
| `js/eclipses.js` | Cálculo de ocultación y sombras sobre los materiales. |
| `js/calendario.js` y `css/calendario.css` | Búsqueda de eventos y exploración temporal. |
| `js/suelo-lunar.js` | Cámara al nivel del suelo, movimiento, alturas y cielo desde la Luna. |
| `js/esta-noche.js` y `css/esta-noche.css` | Calculan y muestran franjas nocturnas y regiones que observar. |
| `js/estado.js` | Valida, guarda y restaura el estado de fecha, lugar, cámara y capas. |
| `js/experiencias.js` y `css/experiencias.css` | Recorridos educativos, favoritos, JSON, enlaces e imágenes. |
| `js/terreno.js` | Geometría de las tres regiones lunares, iluminación, calidad y sombras. |
| `js/lugares-luna.js` | Coordenadas y marcadores opcionales de regiones y alunizajes Apollo. |
| `js/estrellas.js` | Catálogo, movimiento propio, constelaciones y proyección espacial/local. |
| `js/recursos.js` | Carga diferida de scripts de datos locales, caché y reintentos. |
| `js/rendimiento.js` | Planifica cuándo calcular y dibujar; crea el cielo local cuando se abre. |
| `js/guias.js` | Ejes, ecuador, marcador terrestre y línea hacia la Luna. |
| `js/informacion.js` | Fichas de Sol, Tierra y Luna, explicaciones y acciones. |
| `js/interfaz.js` | Botones, selectores y valores mostrados en el panel. |
| `js/principal.js` | Arranca la aplicación y conecta las partes. |
| `js/vendor/` | Bibliotecas externas ya incluidas. No hace falta editarlas. |
| `assets/` | Mapas, texturas empaquetadas, alturas de terreno y sus generadores. |
| `blender/` | Laboratorio estático de materiales conservado de la versión 02. |
| `references/` | Esta guía, fuentes y explicaciones. |
| `tests/` | Comprobaciones opcionales para desarrollar. No se usan al abrir la simulación. |

Los archivos JavaScript son **scripts clásicos separados**, organizados por responsabilidad. Los módulos principales se cargan en el orden indicado al final de `index.html`; `js/recursos.js` carga los datos grandes cuando una vista los solicita. Esta elección permite abrirlos mediante `file://` sin módulos ESM, servidor ni proceso de compilación.

El orden general es bibliotecas → datos básicos → módulos de cálculo y visualización → interfaz → herramientas → `js/principal.js`. La línea de tiempo, el mapa y el modo inmersivo se cargan antes de ese último archivo, que les entrega el reloj y las acciones compartidas. Cada herramienta tiene su JavaScript y su CSS; no crea un segundo reloj ni otro bucle gráfico. Los CSS básicos se cargan primero; `css/tema-v06.css` ajusta la distribución actual y `css/inmersivo.css`, al final, sólo modifica el diseño mientras está activo el modo inmersivo.

## Primeros cambios en el código

Haz una copia de la carpeta antes de experimentar. Abre los archivos con un editor de texto, guarda el cambio y recarga el navegador con F5.

- **Colores de la pantalla:** empieza por las variables y secciones de `css/tema-v04.css`. La base estructural sigue en `css/estilos.css`; los ajustes actuales de tamaño, columnas y paneles están en `css/tema-v06.css`. `css/inmersivo.css` se carga al final para el modo de pantalla completa. Los colores de cuerpos y órbitas están en `colors` dentro de `js/configuracion.js`.
- **Tamaño de un cuerpo en modo didáctico:** cambia `illustrative.radius` en `js/configuracion.js`. Modifica solo su dibujo. Conserva `radiusKm` y `auKm`, que representan magnitudes físicas utilizadas por la escala real.
- **Separación visual:** ajusta `illustrative.earthOrbitUnitsPerAu` y `illustrative.moonOrbitUnitsPerAu` en ese mismo archivo.
- **Encuadre inicial:** cambia `camera.fieldOfView` o las distancias de `camera.illustrativeDistance`. El comportamiento al arrastrar y acercar está en `js/camara.js`.
- **Velocidades:** las opciones visibles están en el selector `speed-select` de `index.html`; sus valores son segundos simulados por segundo real. `86400` significa un día por segundo. `js/reloj.js` aplica ese multiplicador. Si añades una velocidad, revisa también las opciones del modo inmersivo y los límites de las escenas guardadas.
- **Textos o controles:** empieza por `index.html` y `js/interfaz.js`.
- **Barra temporal:** `js/linea-tiempo.js` calcula los eventos y convierte el desplazamiento en fecha. `js/principal.js` pasa esa fecha al reloj común.
- **Modo inmersivo:** `js/inmersivo.js` conserva el foco y coordina los controles; `css/inmersivo.css` contiene su distribución.
- **Mapa y paradas lunares:** `js/mapa-lunar.js` lee las alturas, escoge destinos descriptivos y dibuja la orientación. No alteres los datos físicos para cambiar el color del mapa: su paleta se define en ese módulo.
- **Ciudades incluidas:** edita la lista `CITIES` de `js/ubicacion.js`. No necesitas cambiar la astronomía.
- **Fichas educativas:** sus textos y acciones están en `js/informacion.js`. Los pasos de los recorridos están en `TOURS`, dentro de `js/experiencias.js`.
- **Planificación nocturna:** los criterios y el cálculo viven en `js/esta-noche.js`, separados del dibujo.
- **Guardar escenas:** `js/estado.js` define los campos y límites admitidos; `js/experiencias.js` se ocupa de la biblioteca y los archivos.
- **Cámara del suelo:** `js/suelo-lunar.js` calcula el contacto con la malla y la mirada. No cambies el datum o la altura del DEM para mejorar un encuadre.
- **Estrellas y lugares:** `js/estrellas.js` calcula y dibuja el catálogo; `js/lugares-luna.js` guarda lugares y marcas. Los datos astronómicos originales no se cambian para recolocar etiquetas.
- **Cuándo se dibuja:** `js/rendimiento.js` separa el reloj, los cálculos y el render. `js/recursos.js` comparte una sola carga por archivo.
- **Calendario y terreno:** están separados en `js/calendario.js` y `js/terreno.js`; consulta sus guías antes de cambiar parámetros físicos.

No hace falta instalar Node, npm ni ejecutar un build para cambiar JavaScript o CSS. `assets/textures-data.js` es una excepción: contiene imágenes convertidas automáticamente a texto para abrir la aplicación sin conexión. No se edita a mano. Si sustituyes un JPEG, regenera ese archivo con `assets/build-texture-data.py`; este paso de mantenimiento usa Python y está explicado en [textures.md](references/textures.md). Para ver la aplicación no se necesita Python.

`assets/terrain-data.js` guarda las tres regiones del DEM64; `assets/lunar-detail-data.js` contiene el color lunar detallado y `assets/moon-relief-data.js`, el mapa de normales. El generador `assets/prepare-lunar-v04.py` prepara las alturas y el color detallado; `assets/build-texture-data.py` separa el mapa de normales. La [guía lunar v04](references/luna-v04.md) documenta los originales y la preparación. `assets/stars-data.js` es el catálogo reducido: se regenera con `assets/prepare-stars-v04.py`, según la [guía de estrellas](references/estrellas-v04.md). Son archivos generados y no se editan a mano. Los scripts de preparación no son necesarios para abrir la aplicación.

## Blender y una futura página web

La simulación se abre en el navegador sin Blender. La carpeta `blender/` conserva `MATERIALES TIERRA Y LUNA.blend`, el laboratorio de materiales de la versión 02, para explorar sus nodos y renderizar con F12. Sus esferas están colocadas para comparar materiales: no es una simulación astronómica ni está a escala. No incorpora los ajustes visuales ni las nuevas funciones web de las versiones 03, 04, 05 y 06. Las texturas están empaquetadas; `crear_materiales.py` reconstruye ese laboratorio mediante Blender. No modifica tu instalación ni otros proyectos.

Cuando se publique en tu VPS, el servidor web servirá **index.html** y las subcarpetas del proyecto. Cada visitante ejecutará la simulación en su navegador. Esta entrega local no configura ni publica nada en Hostinger.

## Fuentes

- [Astronomy Engine: código y documentación](https://github.com/cosinekitty/astronomy).
- [Three.js: biblioteca de gráficos 3D](https://threejs.org/).
- [NASA Earth Observatory: Blue Marble](https://science.nasa.gov/earth/earth-observatory/blue-marble-next-generation/).
- [NASA Scientific Visualization Studio: CGI Moon Kit](https://svs.gsfc.nasa.gov/4720/).
- [NASA: datos del Sol](https://science.nasa.gov/sun/facts/), [la Tierra](https://science.nasa.gov/earth/facts/) y [la Luna](https://science.nasa.gov/moon/facts/).
- [Archivos originales, créditos y coordenadas de las texturas](references/textures.md).
- [Mapas y materiales incorporados en la versión 02, también usados aquí](references/recursos-v02.md).
- [Catálogo HYG, figuras de constelaciones y licencias](references/estrellas-v04.md).
- [Mapas lunares DEM64 y color 8k, regiones y alunizajes](references/luna-v04.md).
- [Herramientas gratuitas, Blender y condiciones de uso comercial](references/herramientas-y-licencias.html).

Las bibliotecas incluidas conservan sus licencias. Los créditos NASA identifican las fuentes de las imágenes; no implican que NASA haya revisado o avalado esta aplicación.

Las condiciones de cada recurso se conservan en las guías enlazadas; descargar gratuitamente un archivo no equivale por sí mismo a una licencia para cualquier uso. HYG y la adaptación del catálogo se distribuyen bajo **CC BY-SA 4.0**, con atribución y obligación de conservar esa licencia para adaptaciones de los datos. Las figuras de constelaciones proceden de d3-celestial bajo **BSD-3-Clause**. Estas licencias permiten uso comercial bajo sus condiciones; sus avisos se incluyen en `references/`. Los datos se mantienen separados del código de la aplicación. No se añaden complementos de pago, cuentas ni servicios externos. Los enlaces a fuentes externas requieren Internet; la simulación y sus guías locales funcionan sin conexión.

## Verificación y desarrollo

La versión 13 añade `tests/navegacion-observar.cjs` y adapta las comprobaciones de etiquetas a sus nuevas dimensiones. Consulta [los comandos](tests/LEEME.md) y el [registro de verificación v13](references/verificacion-v13.md). Los resultados de las versiones anteriores se conservan como historial.

Consulta [cómo ejecutar las pruebas de la base](tests/LEEME.md). Se conservan `node tests/eclipses.cjs`, `node tests/terreno.cjs` y `node tests/observador.cjs`. Las comprobaciones previas incluyen `node tests/estrellas.cjs` y `node tests/calendario-ui.cjs`. La versión 05 incorporó pruebas para el planificador, recorridos, estado compartido y suelo; `node tests/suelo-lunar.cjs` comprueba contacto, límites, direcciones y tamaños angulares. Los tests son opcionales; no necesitas Node para abrir la simulación. [El registro de la versión 02](references/verificacion-v02.md) se conserva como historial, no como verificación de todas las novedades de esta versión.

La [verificación v03](references/verificacion-v03.md) se conserva como historial. Los nuevos módulos incluyen sus pruebas junto al código; los resultados no equivalen a medidas de rendimiento en todos los dispositivos.

Los registros [v04](references/verificacion-v04.md) y [v05](references/verificacion-v05.md) describen esas entregas. La versión 06 añade `tests/inmersivo.cjs`, `tests/linea-tiempo.cjs` y `tests/mapa-lunar.cjs`. Los resultados de las pruebas y la comprobación en navegador de esta entrega están en el [registro de verificación v06](references/verificacion-v06.md).