← Las observaciones

Alrededor de lo que se vio

El resto del archivo de una observación, después de lo que se vio: los desplazamientos del testigo y lo que hizo, el instrumento, el sonido, el decorado y los vehículos, lo que ocurrió en el cielo, y el tiempo con sus nubes.

Cada extracto de abajo es de solo lectura, y cada uno conoce el formato: pon el cursor dentro de un objeto y pulsa Ctrl+Espacio (⌥+I en Mac) para listar todas las claves que podrían ir ahí, con lo que el modelo dice de cada una.

Los campos alrededor de lo que se vio

CampoSignificado
observerTrack{ keyframes: [{ t, pose }] } — pose contiene lat, lng, elevationM (sobre el suelo local), headingDeg, pitchDeg, rollDeg, fovDeg, y para una cámara fNumber y focusDistanceM. Se reproduce como se mueve una persona: exactamente la pose indicada en cada fotograma clave, y entre ellos un movimiento que gana velocidad, la mantiene a través de los fotogramas clave que siguen moviéndose, y frena hasta una pausa — dos fotogramas clave con el mismo lugar, o el mismo rumbo. Una mirada empieza y acaba inmóvil; una marcha a pie o en coche ya en curso en el primer fotograma clave continúa. Detenerse y echar a andar añaden su propia sacudida, un cabeceo que se extingue en un segundo y medio, trasladado a la imagen tanto como el instrumento lo permite (apenas un ojo, del todo una cámara sostenida a mano). Y un cuerpo en reposo nunca está del todo quieto: de pie o esperando, la vista oscila unos milímetros y deriva una décima de grado, despacio, del mismo modo en el mismo instante — salvo para un testigo que el relato dice que quedó paralizado (etiqueta paralysis). El pitchDeg indicado es cómo miraba el testigo en el marco de lo que lo llevaba: mientras se desplaza, el reproductor suma cómo sube el propio vehículo (la pendiente de la carretera bajo la traza, leída del relieve, positiva al subir, o para un avión su propia subida, atenuada cuando la mirada se aparta de su camino), de modo que una cuesta eleva la vista y el chip Inclinación indica la suma. filter es lo que se sostenía delante del instrumento, un id de FILTERS como solar-visual para un eclipse. Se mantiene entre fotogramas clave, sin mezclarse (nadie lleva media gafa), y se quita declarando "none". Un fotograma clave que indica viewOnly: true fija la vista de su solo instante (el editor lo escribe cuando la vista se gira con Alt pulsado): el giro de la cámara hacia él y desde él queda fuera de la imagen, y una exposición que lo toca se dibuja como si la cámara hubiera quedado quieta, apuntada como en el instante mostrado. Un testigo que vuela a una altitud dada la indica con altitudeM (metros sobre el mar): el reproductor pone entonces el ojo a esa altitud sobre el relieve que dibuja, y elevationM ya solo es la altura sobre el suelo con el que se escribió el archivo, contra la que se acota también el decorado de una cabina alrededor del ojo.
eventsLo que hizo el testigo, expresado como eventos con sus parámetros en lugar de las poses que implican: [{ type: "event", eventType, t, until, params }], t y until en ms de la grabación. El reproductor calcula las poses al leer la grabación, con la misma ley para todas (un giro de cabeza parte de la quietud y se asienta, la línea de un vehículo es una curva), y solo vuelve a escribir los eventos mientras nada haya cambiado esas poses; un observerTrack con fotogramas clave propios prevalece sobre ellos. Un parámetro lleva su procedencia como cualquier valor. Una tabla de instantes (speeds, speedDivisors, heights, metres) tiene tantas filas como el relato necesite; su valor pasa poco a poco de una fila a la siguiente, o de golpe en una fila con step: true. A pie: look (una mirada sostenida a partir de t, headingDeg, pitchDeg), walk (de from a to, dos { lat, lng }, entre t y until, como camina y se detiene una persona) y follow (un cuerpo de la lectura, o un fenómeno que cruza el cielo, target, que los ojos alcanzan reactionS después, con lagS de retraso, mirado cada sampleMs a falta de fotogramas clave propios, mirado en cada uno de sus fotogramas clave, en el centro de lo que ve, la mirada girando entre ellos como gira una cabeza; sostenida donde lo pierde, en until; observer-valensole.json). En vehículo: drive (el vehículo del testigo, un objeto del decorado nombrado por vehicle, sigue path, una lista de { lat, lng }, a las velocidades speeds [{ t, kmh }], eventualmente divididas por speedDivisors [{ t, divisor }], situado por el único lugar por el que pasó, through { t, lat, lng }; el eye del conductor es { x, y, z } en el modelo del vehículo), lookAhead (mira la carretera y mantiene el objetivo target { lat, lng } a unos keepDeg, y le echa vistazos de glanceS seguidos de roadS a la carretera cuando está a más de glanceBeyondDeg; pitchShare dice hasta qué parte de su altura alza la vista), lean (hacia el retrovisor: el ojo se desplaza offsetM en turnS, durante holdS) y watch (en el retrovisor mirror, un punto del modelo del vehículo: firstS, luego mirrorS entre miradas a otra parte, un vistazo directo de glanceS una vez de cada dos hasta glancesUntil, la carretera durante roadS si no). Cada evento dice de quién es en who, mediante un id de la grabación que nada más tiene: el del testigo (observer.id, o "observer" para un testigo sin id; un evento que no dice ninguno es suyo), el de una forma o un grupo de formas, de un cuerpo, de un objeto del decorado. El editor no guarda una grabación con un evento sobre nada, o con dos cosas del mismo id. Un evento de un objeto del decorado: fly (un avión a lo largo de una línea recta que lleva a from { lat, lng }, con rumbo headingDeg, a las velocidades speeds, a at.metresBefore de ese lugar en el instante at.t, a heights [{ t, altitudeM }] por encima del ojo del testigo). Una de sus luces (id/luz, f-hobs/landing-nose), o un grupo de ellas que nombran los groups del objeto (f-hobs/strobes): light (a intensity desde el inicio del evento, 0 apagada, parpadeando como antes, y de vuelta a lo que era a su final cuando declara uno) y blink (encendida durante onS, apagada durante offS, a intensity o a lo que era, hasta el final del evento, luego como antes): un faro de aterrizaje apagado, destellos encendidos, una baliza giratoria, el balizamiento de lo alto de un edificio. Los del fenómeno (who la forma con que se dibuja, o el grupo de sus formas) dan las formas del relato, tal como lo describió el testigo: stand (en el lugar place que declaró, { lat, lng }, sus metres [{ t, widthM, heightM }] su ancho y su altura sobre el ojo, de los que se siguen en cada instante su dirección y su tamaño en su cielo), appearance (su aspecto a partir de t, sus parts: formas situadas y dimensionadas en partes de su ancho aparente, sourceId, kind, points, color, brightness, halo, widthShare, heightShare, alongShare, upShare; una parte que otro aspecto tiene y este no, no se ve), blink (las formas de las que es, un grupo de las del fenómeno o una de ellas, encendidas durante onS, apagadas durante offS, tomando off mientras están apagadas) y vanish (ya no se ve). O, sin lugar, cruzando el cielo, un relato solo de direcciones: travel (from una dirección { azimuthDeg, altitudeDeg } towards otra, a lo largo del gran círculo que las une, a las velocidades speeds [{ t, degPerS }], suavemente entre dos; sizeDeg de ancho en el cenit, más pequeño como el seno de su altura cuando sizeBy es "altitude"; sus partes dispuestas a lo largo de su camino en la imagen del testigo, alongShare delante o detrás, upShare a su izquierda, giradas con él), turn (de byDeg hacia su lado side, "left" o "right", suavemente; el otro lado en el cielo cuando seenFrom es "craft", como lo dice un piloto), roll (inclinado hasta toDeg, y de vuelta horizontal con andBack, más estrecho a lo ancho de su camino según el coseno), vibrate (de un lado a otro hz veces por segundo, en amplitudeShare de su tamaño, desde nada en riseS, luego cada vez menos hasta el final del evento) y spiral (turns vueltas de un círculo junto a su camino, clockwise o no, de radiusDeg una vez abierto, reducido en shrink al final, rodando rollDeg); observer-saint-lo.json. Los de un cuerpo de la lectura (who su id; o, sobre una parte de su modelo, un nodo o un hueso, id/parte: craft/legs, etre-2/head, que spin y turn hacen girar sola alrededor de su propio eje vertical, en sentido horario vista desde arriba, el resto del cuerpo tal como está; una luz, por su nombre en el modelo, engin/front-red, o un grupo de sus partes que nombran los groups del cuerpo, engin/rear; el archivo del modelo dice qué partes tiene) se añaden a los fotogramas clave que declara: motion (un movimiento de su modelo reproducido una vez, motion hasta to, el tubo central que se recoge), spin (uno que gira sin parar, turnsPerS, las patas), rise (distanceM a lo largo de una recta a angleDeg de la vertical, 0 recto hacia arriba, hacia headingDeg, desde parado, frenando hasta detenerse o, stops: false, cada vez más rápido al irse), turn (girarse hacia headingDeg), ride (llevado por el cuerpo in, aboveM más arriba), light (una luz, o un grupo de ellas, encendida a cdM2 desde el inicio del evento, 0 apagada, y encendida de nuevo como estaba a su final cuando declara uno) y blink (una luz que parpadea, encendida durante onS, apagada durante offS, a cdM2 encendida o a lo que estaba antes, hasta el final del evento, luego como antes; de golpe, nunca en fundido: los destellos de un avión, una baliza giratoria, la luz de lo alto de una torre) y vanish; una postura también es un movimiento del modelo (motion sobre crouch, que lleva una figura exportada con sus posturas: 0 de pie, 1 agachada); la nave y los seres de observer-valensole.json. observer-silly-le-long.json expresa así a su testigo, su avión y su fenómeno
sampleMsCon qué frecuencia se toma un fotograma clave, en ms: por el grabador del editor cuando se mueve una forma a mano, y donde los eventos se desarrollan en valores (las formas del relato, la mirada que las sigue, un cuerpo que se eleva), todos al mismo paso, para que lo que se dibuja y la mirada para la que se dibuja nunca se desfasen. De lo que eso da, los fotogramas clave que dicen lo mismo solo conservan el primero y el último: el reproductor dibuja lo mismo entre ellos. Ausente, cada uno conserva el suyo: 25 ms para un fenómeno que cruza el cielo y la mirada que lo sigue, 2 s para uno inmóvil, 250 ms para un cuerpo que se eleva
weatherTrack{ keyframes: [{ t, weather }] } — las condiciones del cielo a lo largo de la grabación: precipitación, viento, tormenta, y las nubes como capas con alturas reales, cada una capaz de contener nubes individuales situadas en metros. Todos los campos de un weather están en la sección siguiente
weatherSource{ id, name, url } del registro del que se consultó el tiempo. Su presencia significa que la grabación se reproduce exactamente como se compuso y no se vuelve a consultar nunca. Si falta, es el propio relato del testigo
lightPollutionEl brillo del cielo nocturno del lugar, ciudades incluidas: el cenit de una noche sin Luna en magnitudes por segundo de arco cuadrado, tal como lo lee un Sky Quality Meter o lo da el atlas mundial del brillo artificial del cielo nocturno (su cifra «SQM», Falchi et al. 2016, que lightpollutionmap.info muestra para cualquier lugar). 22 es un cielo natural, un suburbio ronda 19, el centro de una ciudad 17. Si falta, un cielo natural. La parte de las ciudades, lo que queda al quitar los 22 naturales, se suma al cielo como luz: más intensa hacia el horizonte, donde el aire bajo devuelve más, y dibujada con el blanco cálido de una lámpara de 3000 K. Ahoga la Vía Láctea y la luz zodiacal, y quita estrellas, por la diferencia en la estrella más débil que un ojo distingue (Crumey 2014): unas dos magnitudes a 19. La Luna ahora hace lo mismo. "derived" cuando se consulta en el atlas, "stated" cuando el testigo lo midió. El editor lo rellena a partir del atlas para una observación de 2015 en adelante, como "derived" con el atlas nombrado, y nunca reemplaza una cifra escrita a mano; antes de 2015 no consulta nada, porque el cielo era más oscuro que el del atlas
observerMapSi el mapa de dónde estaba el testigo empieza abierto cuando se reproduce o edita la grabación: true o false. Si falta, decide el reproductor: abierto para un testigo que se desplazó, cerrado para uno que se quedó en su sitio. Una página que integra el reproductor tiene la última palabra (su atributo show-observer-map). El editor lo escribe cuando se abre o se cierra el mapa en él, para que un lector vea lo que el autor dejó
snapshotsDónde se guardan, en archivos junto a la grabación (anexos), los datos que la escena pediría si no a terceros en cada reproducción, para que una grabación terminada se reproduzca igual dentro de diez años sin pedir nada a nadie: relief (la altura del suelo, tal como la fuente de altitud la dio para cada parcela de terreno que construye la escena, un zip), imagery (la foto del suelo, como las teselas que sirvió la fuente de imágenes, un zip), roads, water, railways (carreteras, agua y vías de cada parcela, en JSON), upperAir (el aire a la altura de los aviones, en JSON) y map (la foto bajo el mapa del testigo, como las teselas que sirvió la fuente de imágenes para el terreno al que se ajusta el mapa, un zip: un mapa tomado como instantánea muestra esa foto y no pide ninguna otra, ampliada al acercarse, vacía más allá al alejarse). Cada uno es { src, takenOn, attribution }, con src leído respecto a la dirección de la grabación, o una URL data: para un anexo guardado dentro de la propia grabación. Un grupo leído de su anexo no pide nada a nadie; uno sin anexo se pide en directo, como todo antes. "live": true en un grupo lo pide en directo en cada reproducción y nunca toma una instantánea de él (lo que dice elegir su fuente en directo en lugar de Archivo), y en el propio snapshots todos los grupos; "refresh": true en un grupo lo pide en directo una vez, y el editor lo vuelve a tomar al guardar. El editor toma lo que falta al guardar, y guarda la grabación y sus anexos en un único zip que descomprimir donde se publica. weather, place, lightPollution y decor dicen que el tiempo (weatherTrack, weatherSource), el nombre del lugar, la cifra del cielo nocturno y el decorado se leen del archivo en lugar de volver a pedirse (al registro meteorológico cuando cambian la fecha o el lugar, al geocodificador, al atlas y al levantamiento cuando el testigo se mueve): {} si están dentro de la grabación, { src } para un anexo con sus claves, que los reproductores devuelven a la grabación al cargarla. Si faltan, están dentro de la grabación y el editor los vuelve a pedir. El huso horario no está aquí: está escrito en la propia grabación
modulesLos módulos que la grabación necesita para dibujarse tal como se hizo (un catálogo del que vienen sus modelos), por la dirección del manifiesto de cada uno, relativa a la grabación o absoluta: véase módulos. Un lector recibe lo que declara cada manifiesto, nunca su script salvo que haya añadido ese módulo él mismo. Ausente, no necesita ninguno
soundTrack{ keyframes: [{ t, sound }] } — kind (none/hum/whistle/rumble/crackle), volume, pitchHz, y un src opcional de una grabación real. volume y pitchHz se deslizan entre fotogramas clave, kind y src cambian en el fotograma clave. Un src en otro sitio debe servirse a cualquier origen (CORS)
referencesImágenes del lugar superpuestas a la escena: src (una dirección, o una URL data: para una imagen añadida desde un disco), kind (photo/panorama/video), registration (headingDeg, pitchDeg, rollDeg, fovDeg), opacity, credit/creditUrl, t y drawing opcionales, from ({ lat, lng }, desde dónde se tomó: el reproductor la desvanece a medida que el testigo se aleja de ese punto; si falta, nunca se desvanece), y los landmarks con los que se alineó (id, label, picture como { u, v } desde la esquina superior izquierda, scene como { azimuthDeg, altitudeDeg }). Un video indica además t, donde empieza su tramo en la línea de tiempo, video (fromS, toS, rate: qué parte del archivo, a qué velocidad) y registrationTrack, adónde apuntaba su cámara en cada instante ajustado.
tracesLo que un investigador dibujó sobre el lugar, importado de su archivo de Google Earth (KML, KMZ) o del GeoJSON de su SIG y mostrado sobre la escena como suyo, nunca como parte de la reconstrucción: [{ id, title, kind, points, altitude, color, source }], siendo kind point, line o polygon, points los vértices como [{ lat, lng, altM }] tal como los tenía el archivo, altitude cómo se lee altM (ground, por defecto, relative al suelo bajo cada punto, o absolute sobre el nivel del mar), color un #rrggbb y source de quién es
instrument, exposureSecondsA través de qué se observó, y cuánto tiempo estuvo abierto el obturador. Si falta, el ojo desnudo. instrument es uno de eye, rectilinear-lens (una cámara de marca desconocida), roamer-1-120, instamatic-126, slr-35mm-50, slr-35mm-zoom, phone-landscape, phone-portrait, o una réflex digital (eos-5d-iii, nikon-d7000… los sensores del catálogo de Stellarium), unos prismáticos (binoculars-nikon-10x42-edg…) o un telescopio (telescope-celestron-c8…); exposureSeconds es un valor para toda la grabación, limitado al rango propio de ese aparato; un aparato que registra una imagen (una cámara, un teléfono) pone sobre cada luz los reflejos fantasma de su objetivo, como hacen el vidrio y el sensor: una copia más débil y desenfocada sobre la recta que pasa por el centro de la imagen, simétrica respecto a él para el reflejo principal de un teléfono, el disco rojo opuesto a un semáforo. Un teléfono se expone solo según lo que ve, hasta ISO 3200: una noche que filma sigue oscura alrededor de sus lámparas
lensA través de qué se tomó la imagen además del objetivo, y qué había sobre ese cristal, para un aparato que registra una: glass (filter, window o windscreen: un filtro añade un reflejo simétrico respecto al centro, un cristal un doble más débil de cada luz justo al lado, más lejos para un parabrisas inclinado), drops, condensation y dirt (de 0 a 1, cada uno con un halo alrededor de cada luz, que pierde lo que el halo toma) y sheltered. Sin drops, las gotas siguen la lluvia o la nieve que cae en cada instante, salvo si sheltered es verdadero: caen nuevas tanto más a menudo cuanto más de frente golpea la lluvia el cristal (un objetivo levantado, un cristal de cara al viento, un parabrisas inclinado reciben más), se funden con sus vecinas; las pequeñas se quedan minutos, las grandes bajan al cabo de unos segundos dejando un reguero de perlas y limpiando lo que cruzan, y siguen haciéndolo cuando ya no llueve. Los reflejos del propio objetivo siguen su apertura: más anchos con el objetivo abierto, y con el polígono de sus laminillas una vez cerrado. ghosts indica los reflejos de una óptica colocada delante del objetivo, que ningún catálogo conoce (el espejo y los prismas de un periscopio), cada uno como los de un objetivo: scale, share, blur, offset, tint; reachDeg hasta dónde, más allá de la esquina del encuadre, una luz alcanza aún su primera superficie (30° para un objetivo); placedDrops gotas indicadas una a una en lugar de las que drops reparte al azar, cada una un radius (parte de la altura de la imagen) y una track de {t, x, y} (ms, partes del ancho y del alto de la imagen desde su esquina superior izquierda), mantenida en sus extremos; drops solo dice entonces cuánta luz difunden
lightingLo que la imagen muestra de la luz en que se tomó, cuando eso dice dónde estaba el Sol (un lado iluminado, un lado en sombra): sunFromViewDeg, el arco de los rumbos del Sol, en sentido horario desde la dirección en que miraba el instrumento al principio ({ fromDeg: 105, toDeg: 285 }: detrás de él, a uno u otro lado), y sunAltitudeDeg ({ minDeg, maxDeg }), su menor y su mayor altura. Compromete a una lectura de la observación: la fecha, la hora, el lugar y el rumbo que indica pueden moverse dentro de lo que se sabe de cada uno, pero el Sol que componen tiene que iluminar la escena como la muestra la imagen, de modo que desplazar el lugar desplaza las horas permitidas, y al revés
isoLa sensibilidad de la película o del sensor con que se tomó la imagen, cuando se conoce: 400 para una película de 400 ISO. Si falta, la del propio aparato (el negativo en color de una réflex es 100, el de una Instamatic 64). La imagen de una cámara no responde como la de un ojo: una película no se adapta al cielo, recibe una exposición — la luz, por el tiempo de obturación, dividida por el cuadrado del número f — y responde a ella con su propia curva (la suave de un negativo, la más abrupta de una diapositiva, la línea recta de un sensor que se detiene en el blanco). Así, una pose nocturna sale con un cielo negro y lo que brillaba en él destacando. Indicada para un aparato que ajusta su propia exposición (un teléfono), es ese aparato ajustado a mano, como en su modo manual
filmLa película de la toma, cuando se conoce, por su identificador en el catálogo: "kodachrome-64". Da la sensibilidad, salvo que iso indique otra, y la respuesta a la luz, blanco y negro incluido. Si falta, nadie lo dice.
meteringCómo leyó la luz un aparato que ajusta su propia exposición, cuando se sabe: "average", la media de toda la imagen, como las videocámaras y los teléfonos antiguos, que quema en blanco una luz viva en una imagen oscura; o "highlights", como los teléfonos recientes, conteniéndose para que una luz que ocupa una parte notable de la imagen conserve su color (un farolillo a veinte metros sale naranja, blanco solo junto a su llama), el resto de la noche más oscuro. Ausente: la del aparato (un teléfono protege sus altas luces)
swayCuánto mueve la vista el cuerpo que sostiene el instrumento cuando no camina: 1 para una persona de pie o sentada, 0 para una cámara sobre trípode, cualquier valor intermedio o superior para menos o más. Si falta, 1 — salvo para un testigo que el relato dice que quedó paralizado (etiqueta paralysis), para quien es 0, y para una exposición de más de medio segundo, que ninguna mano sostiene inmóvil: eso es un trípode, y también 0
vehicleEl vehículo en el que iba el testigo, cuando el decorado no lo dibuja: { kind, windowsOpen, noise }, siendo kind o bien un vehículo de carretera (car, van, truck, motorcycle, generic), o bien una aeronave, por su clase tal como se nombran las aeronaves del cielo (business-jet, airliner-narrow, helicopter-light…): un solo campo para ambos, al no tener los dos vocabularios ninguna palabra en común. Oído desde dentro: su motor sigue el propio trayecto del testigo — la marcha según la velocidad, las revoluciones según la marcha, el esfuerzo según acelere o frene — con la rodadura y el viento, amortiguados por un habitáculo cerrado, dejados entrar por ventanillas abiertas. Una aeronave no tiene ni marchas ni cilindros: lo que se oye de ella es el rugido continuo de su cabina, al nivel que mide en ella un pasajero para esa clase de máquina. noise es su sonoridad frente a uno corriente de su tipo (1 por defecto). Aquello en lo que va el testigo se interpone además entre él y todo lo que está fuera, y quita más a los agudos que a los graves: una aeronave a cien metros no es más que un retumbo a través de un fuselaje, y bajo el rugido de la cabina ya no se oye en absoluto; la lluvia y el viento entran amortiguados igual. windowsOpen deja volver casi todo. Es también lo que mantiene activo el botón de sonido del reproductor cuando el archivo no tiene soundTrack: el botón responde de todo lo que reproduce la escena — este motor, un engine del decorado, una aeronave del decorado en vuelo, un cuerpo de una lectura que se oye, la lluvia y el viento — y no solo de la pista. Sus luces: headlights es un ajuste como para un vehículo del decorado (off, position, dipped, main, fog) o auto, por defecto: las luces de cruce desde el crepúsculo y nada de día, que es lo que hace un conductor. headlightKeyframes es [{ t, mode }] para un cambio durante la grabación. El haz ilumina la carretera delante del testigo, en la dirección en que va el vehículo.
decorDecorado a unos eastM/northM reales del testigo: edificios (con floors, windows), árboles, arbustos, farolas, vehículos, puentes, líneas aéreas, otros testigos, aeronaves — opcionalmente con una track y lights cuyo pattern lleva una cadencia de destellos real. Véase más abajo

Un elemento del decorado se expresa en metros, como todo lo que no es el fenómeno:

CampoSignificado
eastM, northM, headingDegDónde está respecto al testigo, y hacia dónde mira su frente, en sentido horario desde el norte verdadero
sizeM{ widthM, lengthM, heightM } a lo largo de sus propios ejes, siendo la longitud el sentido hacia el que mira. Cada eje es opcional: uno que nadie midió conserva la proporción propia de la forma integrada
modelUn modelo 3D real en lugar de la forma integrada: una entrada del catálogo por id, o un archivo glTF/GLB en url (que prevalece, debe poder leerse desde cualquier origen, y entonces necesita su credit; una relativa se lee desde el archivo que la indica). Nunca decide el tamaño: se escala, conservando sus proporciones, al primer eje medido entre longitud, altura y anchura, o al tamaño real que le da el catálogo. Visto desde dentro, y siempre que no se pueda obtener el modelo, se dibuja en su lugar la forma integrada. headingOffsetDeg gira el modelo cargado sobre su eje vertical para que su morro apunte hacia donde la escena lo espera (0 mira al norte con un rumbo de 0); una entrada del catálogo trae el suyo. credit es { title, author, license, sourceUrl }: license tal como la enuncia su autor ("CC BY 4.0") y sourceUrl de dónde viene, para que la afirmación sea verificable.
bridgePara un "bridge": cómo está construido. sizeM.lengthM es toda su longitud a lo largo de la carretera, terraplenes incluidos, widthM la anchura del tablero y heightM la altura de la calzada sobre el tablero por encima del suelo; spanM es la luz libre bajo el tablero, discurriendo la carretera sobre un terraplén de tierra que desciende hasta el suelo a cada lado; deckThicknessM el espesor de la losa (1,2 por defecto); railing { heightM, postSpacingM, rails } la barandilla de ambos bordes, postes y barras cuyas aberturas son rectángulos (1,05 m, 1,5 m y 2 barras por defecto). Dibujado con esas medidas, nunca estirado
wirePara un "wire" (una línea eléctrica o telefónica): sizeM.lengthM es el vano entre sus postes, a lo largo de su headingDeg, y heightM la altura del cable más bajo; strands [{ heightM, acrossM }] cuelga varios (los superpuestos comparten un acrossM, los de una cruceta difieren); poles es both (por defecto), start o end (el extremo del que se aleja su rumbo o hacia el que apunta: el otro está anclado a un edificio) o none; diameterM (8 mm por defecto) y poleHeightM (medio metro sobre el cable más alto). Recta, sin flecha, y dibujada a esas medidas, nunca estirada
track[{ t, eastM, northM, altitudeM, headingDeg }] cuando se mueve, altitudeM por encima del suelo bajo él (el ojo está a elevationM + 1,6 m: un cuerpo a la altura del ojo tiene ese altitudeM). La posición se interpola entre fotogramas clave; el rumbo se mantiene de uno al siguiente
lightsSus luces: id, offsetM { x, y, z } desde su centro (derecha, arriba, delante), color, intensity (1 es una luz de navegación corriente) y un pattern: { "kind": "steady" }, o { "kind": "flash", perMinute, dutyCycle, phase }, la cadencia tal como la establecen los reglamentos, la fracción encendida de cada ciclo (cerca de 0,5 para un intermitente de filamento, 0,01 para un estroboscopio) y un desfase de 0 a 1 entre luces. El editor las rellena a partir de ajustes predefinidos: “Avión de pasajeros”, “Helicóptero”, “Coche, faros encendidos”, “Coche, luces de emergencia”, “Rotativos de vehículo de emergencia”, “Farola”. Cómo se enciende o se apaga durante la grabación, a partir de cada instante, keyframes [{ t, intensity, pattern }]: lo que dan los eventos light y blink sobre ella
groupsSus luces tomadas juntas, para que un solo evento trate de todas: { id, title, members }, sus miembros luces suyas u otros de sus grupos. Nombrado en un evento como una luz, id/grupo: los dos destellos de un avión, f-hobs/strobes. Opcional
engineUn vehículo que se oye en marcha: { kind, noise }, como vehicle más arriba. Su motor sigue su propia track, oído desde donde está el testigo, más débil y apagado con la distancia
aircraftSoundUna aeronave (kind aircraft) que se oye mientras vuela, lo que hace cuando su track deja el suelo: la clase de ruido que hace, una clase de aeronave (airliner-narrow por defecto, airliner-wide, regional-jet, helicopter-light, light-piston…) o silent para una que no hace ninguno. Lo que dice su modelo se aplica cuando esto falta (los sustitutos de un fenómeno son silenciosos). Se oye como las aeronaves de un registro de tráfico aéreo: más débil y más sorda con la distancia, tarde por el tiempo que el sonido tarda en llegar (unos tres segundos por kilómetro), de modo que se oye donde estaba, más aguda cuando se acerca y más grave cuando se aleja, y enmascarada por el ruido del lugar
occludesSourceIdsLos fenómenos delante de los cuales el testigo dijo que este elemento estaba: consulta las reglas de la página del formato
facadeSolo el tipo building: { color?, plain? }. color es el muro, "#rrggbb"; salvo que plain sea true, se dibujan ventanas en cada planta y una puerta en la planta baja de la cara frontal. Se dibuja al sizeM enunciado (deben estarlo los tres lados), nunca estirada, y no para un edificio con un testigo dentro. El editor toma el color del material que el mapa enuncia para los muros (piedra, ladrillo, hormigón, bloque, madera), o un enlucido donde no enuncia ninguno. Ausente es la caja lisa.
roofSolo el tipo building: { shape, riseM, color?, ridge? }. shape es "flat" (la caja), "gable" (dos vertientes hasta una cumbrera a lo largo del lado mayor, o de la profundidad con ridge: "depth") o "hip" (cuatro vertientes); riseM es lo que la cumbrera sube sobre el alero, así que los muros miden sizeM.heightM menos eso; color es el tejado visto desde arriba, "#rrggbb". El editor los lee del láser y de la foto aérea del levantamiento. Ausente es un tejado plano del color de los muros.
originEl levantamiento del que se tomó este objeto, por el id de su proveedor ("ign-lidar-topo"), cuando el editor lo tomó del levantamiento del lugar y el autor no lo colocó a mano: un árbol, un edificio, un puente o un vano de línea. Elegir otro levantamiento, o ninguno, u otro lugar, sustituye o quita lo que lleva un origin, y nunca lo que no lo lleva
surveyedOnEl día (AAAA-MM-DD) del levantamiento más reciente del que se extrajo este objeto, cuando viene de uno (véase origin): el editor advierte cuando es posterior a la observación.
lit, litKeyframesSi la lámpara de una farola o los faros de un vehículo están encendidos. litKeyframes es [{ t, lit }], ordenado por t, para una luz que se enciende o se apaga durante la grabación; sin él, lit vale para toda la duración. Se ignora en un edificio, un árbol o un testigo
headlights, headlightKeyframesCómo están puestas las luces de un vehículo, pues no todo el mundo las enciende, ni como debe: off, position (las luces de posición, que muestran el vehículo y no iluminan nada), dipped (las luces de cruce), main (las luces de carretera: lejos, estrechas, deslumbrantes) o fog (los faros antiniebla: bajos y anchos). Un haz ilumina la carretera, los arcenes, los árboles y las paredes delante del vehículo, sea cual sea la forma en que se dibuje. headlightKeyframes es [{ t, mode }], ordenado por t, para un ajuste que cambia durante la grabación. Sin ninguno de los dos, lo dice lit: encendido son las luces de cruce. Se ignora para todo lo que no sea un vehículo. Solo cuatro vehículos (el del testigo y luego los más cercanos del decorado) tienen un haz real. Los faros del testigo proyectan sombras (un talud, un poste o un pilar de puente retiene la luz de lo que hay detrás), y el haz se ve en el aire en proporción a lo que el aire difunde de él: un rastro tenue con el aire limpio, un cono de luz en la niebla
observerSide, observerFacing, observerKeyframes, occupiedFloorEl testigo dentro del objeto, para un building o un vehículo (solo un objeto a la vez lo contiene). observerSide dice dónde está: front, behind, left, right, front-left, front-right, behind-left o behind-right, estando el ocupante de un vehículo en una de sus cuatro puertas. observerFacing es la ventana por la que mira cuando no es la de su asiento: un conductor se sienta en front-left y mira por el parabrisas, front. observerKeyframes, [{ t, side, facing }], dice dónde se sienta a lo largo del tiempo, cada uno mantenido hasta el siguiente, y un fotograma sin side significa fuera a partir de entonces, como un conductor que se baja. occupiedFloor es la planta de un edificio en la que está, de 0 (planta baja) a floors
modelParametersLos ajustes del modelo con el que se dibuja el objeto, por la clave con que la entrada del catálogo publica cada uno: { "costumeColor": "#5a6b3a" } para la ropa de una persona, foliageColor para un árbol, hullColor para una nave, gearUp para un avión de línea en vuelo. Un modelo trae los suyos (el editor dibuja un campo para cada uno); un objeto dibujado como forma integrada no tiene ninguno, se pinta con color
sightingUrlPara un observer: la dirección de la grabación propia de ese testigo, cuando se conoce, para que el menú de la escena pueda ofrecer ver su testimonio

Eventos del cielo#

Lo que ocurrió en el cielo durante la grabación, como hechos: un disparo láser, un lanzamiento de cohete, una reentrada. Cada uno ocurrió lo viera alguien o no: no es la lectura del relato, ni el decorado, que dura más que la observación (una casa, un árbol). Se declaran bajo skyEvents, en el primer nivel de la grabación; una grabación que los ponía en su interpretation, como hacían las versiones anteriores, se sigue leyendo.

{
  "skyEvents": {
    "beams": [{
      "id": "meudon-paris",
      "path": [
        { "lat": 48.805055, "lng": 2.231171, "altitudeM": 172.5 },
        { "lat": 48.83632, "lng": 2.33702, "altitudeM": 88 }
      ],
      "wavelengthNm": 532,
      "powerW": 10
    }]
  }
}
CampoSignificado
reentriesLas reentradas atmosféricas que ocurrieron, un satélite o una etapa de cohete que se desintegra en pedazos que arden. No son cuerpos: una reentrada arde entre 70 y 100 km de altura y se ve a cientos de kilómetros, así que se sitúa sobre la Tierra y se ve a través de su curvatura desde donde estaba el testigo. Su track da el punto de cabeza en instantes de la grabación, { t, lat, lng, altitudeKm }, unidos por círculos máximos; cada uno de sus fragments sigue el mismo camino lagS segundos detrás, se ve desde fromT hasta apagarse en untilT, brilla con su absoluteMagnitude (a 100 km, como un bólido) llevada a su distancia real, en su color, con una estela de los últimos trainS segundos de su camino (4 si falta: la estela de una reentrada es larga). Cada pedazo se desintegra como lo hacen los pedazos que arden (sheds): un desmoronamiento lento en fragmentos débiles, cada uno con su estría, que se retrasan, se apartan y descienden en un abanico estrecho, y una ráfaga de una treintena en cada destello de su lightCurve, pues un destello es una ruptura (Zander & Löhle, CEAS Space Journal 2025). Una lista de fases lo enuncia en su lugar, { fromT, untilT, perS, lifeS, magnitudeDrop, dropBack, spreadKmS, sinkKmS, trainS }, y una lista vacía un pedazo que no suelta nada. Un destello más brillante que la magnitud −12 por debajo de 50 km se oye como una detonación, tras el tiempo que tarda el sonido en recorrer la distancia (Cheliábinsk: dos minutos y medio). Su luz es propia: se ve tanto si el Sol la alcanza como si no. object nombra lo que cayó (name, cosparId, norad). Nada se propaga desde elementos orbitales, errados en minutos en la última órbita: el camino es lo que establecen las fuentes, con su procedencia
launchesLos lanzamientos de cohete que ocurrieron, iluminado por un Sol que se puso para el suelo pero no para la estela, la «medusa espacial». Situados sobre la Tierra como una reentrada: su track da la etapa en instantes de la grabación, { t, lat, lng, altitudeKm } (puede empezar antes que la grabación), y burnFromT y burnUntilT los segundos en que el motor ardió. La estela es una fila de bocanadas soltadas a lo largo de ese camino, cada una expandiéndose con la edad; lo que se ve de cada una es la luz del Sol que difunde hacia el testigo. La sombra de la Tierra (dónde el Sol ilumina o no a la altura de la bocanada, y cuánto aire rozó su luz, lo que la enrojece o azulea), el ángulo de difusión y la expansión se calculan con el Sol real en la fecha real: nada se declara de ellos. Un plume opcional sustituye los valores por defecto: exhaustKgPerS (273, un Merlin Vacuum), condensedShare (0,065, el único número que nadie ha medido), particleRadiusUm, expansionKmPerS, initialRadiusKm, lifetimeS, y para el collar (el escape recién soltado, ancho y pronto desaparecido, junto a la estela estrecha que queda) collarShare (0,85), collarExpansionKmPerS (2,5), collarLifetimeS (20). vehicle nombra lo que voló y, en engine, el motor cuyo escape es: thrustKN y specificImpulseS (de los que se deducen el caudal de escape y su velocidad, y con ellos lo ancho del collar) y propellant (rp1-lox, methane-lox, hydrogen-lox, hypergolic o solid, que dice qué parte se vuelve partículas y de qué tamaño). Lo que dice plume prevalece sobre lo que dice el motor. La estela necesita la fecha de la grabación: sin ella no hay Sol que la ilumine. vehicle.mission nombra la misión que cumplía ("Starlink Group 10-49"). Cada bocanada vuela sola una vez soltada, a la velocidad de la etapa más la que se le dio, atraída por la Tierra y frenada por el aire solo donde es lo bastante denso para fluir a su alrededor (por debajo de 200 a 300 km): la estela es la misma cosa en el espacio vista desde todos los lados, una estela vista de frente es un disco, una espiral vista de canto una línea. Su color es el del tamaño de sus partículas: el hielo grueso difunde blanco, el hielo más fino que la longitud de onda azul. jets enumera lo que la etapa suelta además, cada uno { kind, fromT, untilT, angleDeg, azimuthDeg, spinPeriodS, speedKmPerS, massKgPerS, condensedShare, particleRadiusUm, expansionKmPerS, initialRadiusKm, lifetimeS }: kind burn (otro encendido del motor, con los valores de la estela; un frenado de desorbitación es angleDeg 180, el escape saliendo por delante) o vent (propelentes purgados de los depósitos, más lentos, finos y fríos: 0,7 km/s, 20 kg/s, la mitad congelándose, por defecto); angleDeg desde atrás del movimiento (0) hasta el lado (90); azimuthDeg el lado por el que sale alrededor del movimiento (0 opuesto a la Tierra); spinPeriodS la vuelta de la etapa alrededor de su movimiento, que hace girar el chorro con ella y dibujar una espiral a los propelentes purgados. Cuando hay chorros, el encendido del ascenso solo se dibuja si se da burnFromT o burnUntilT.
beamsLos haces de luz enviados por el aire desde el suelo, un disparo láser o un reflector. Cada uno tiene un path de al menos dos puntos { lat, lng, altitudeM } (altitudes sobre el mar): donde sale del emisor, donde un espejo lo desvía si lo hay, y donde termina. Entre dos puntos es una recta a través del espacio, no a lo largo del suelo, que desciende bajo ella. wavelengthNm es su color (532 para un láser verde), powerW su potencia óptica media, divergenceMrad lo rápido que se ensancha (0,1 por defecto) y apertureM su anchura al salir (0,01 m por defecto); fromT y untilT dicen cuándo está encendido. Nada de su brillo se declara: lo que se ve de cada metro es lo que el aire allí (moléculas y bruma, a su longitud de onda) difunde hacia el ojo de la potencia que le queda, según el ángulo que la luz debe girar; por eso es mucho más vivo visto remontándolo que viéndolo alejarse. Lo oculta lo que está delante y se detiene donde encuentra el suelo.

El tiempo, y sus nubes#

Un fotograma clave weather expresa las condiciones del cielo en un momento del reloj de la grabación; entre dos fotogramas clave cada número se interpola, y el tipo de precipitación y la tormenta se mantienen. Contiene:

CampoSignificado
cloudLayersLas nubes, como una lista de capas — véase más abajo. Si falta, las describen los campos antiguos de las filas vecinas, adaptados a una capa de agua y un velo de cirros; una lista vacía significa un cielo despejado que alguien miró
cloudCover, lowerCloudCover, highCloudCoverFracciones de cielo (0–1): el total, solo las capas de agua, y solo el velo helado. Escritas por grabaciones hechas antes de que hubiera capas, y que el editor sigue manteniendo al día como resumen de ellas
cloudBaseM, cloudDarknessLa base única de esa misma época, en metros sobre el suelo de referencia, y un tono único (0 blanco, 1 muy oscuro)
iceCrystalAlignment0–1, con qué regularidad caían los cristales de hielo — lo que convierte un simple anillo en parhelios, arcos y un pilar. Ningún registro lo mide; una capa de cirros lleva el suyo
rareIceCrystals0–1, la proporción de los cristales de un velo de cirros que son de tipos raros: columnas con extremos piramidales (los halos de radio impar, a 9°, 20° y 35°) y placas libres de girar en torno a un eje horizontal (los arcos de Lowitz). Ausente significa 5%, un velo ordinario. Como la alineación, ningún registro los cuenta: se declara. La simulación que se deriva se ha comprobado coherente con Atmospheric Optics
relativeHumidity0–1, cerca del suelo. Decide lo lechoso que es el cielo despejado: la bruma se hincha de agua a medida que el aire se acerca a la saturación. Un registro consultado la trae (a partir de la temperatura y el punto de rocío de ERA5); si falta, una bruma típica
visibilityKmLa visibilidad meteorológica cerca del suelo, en kilómetros, tal como la da un parte. Es la bruma misma: declarada, decide cuánta hay, para la lejanía como para el cielo, y la humedad deja de leerse para ello Más allá de 30 km, es también la distancia hasta la que se dibuja el relieve (150 km como máximo), descendiendo con la curvatura de la Tierra: una montaña que un aire límpido muestra a lo lejos está ahí.
precipitationType, precipitationIntensitynone/rain/snow/hail, y 0–1. Indicada en un fotograma clave, reproducida como cae: un chubasco empieza en el fotograma clave que lo inicia con sus primeras gotas, y no alcanza la intensidad indicada más deprisa que una lluvia real (de nada a lo más fuerte en veinte segundos); se detiene del mismo modo. Un cambio que los fotogramas clave reparten en más tiempo se sigue tal cual. precipitationAmount (0–1, ausente significa toda) dice qué parte de esa precipitación cae ya.
windDirectionDeg, windSpeedEl viento general: el rumbo HACIA el que sopla, en sentido horario desde el norte, y metros por segundo. Es lo que arrastra las nubes — desde el instante cero, de modo que buscar y volver a reproducir dan el mismo cielo
stormRelámpagos y truenos, con el retraso correcto

Cada capa de cloudLayers es un manto de nubes a una altura real, y sigue siendo ella misma de un fotograma clave al siguiente:

CampoSignificado
idEstable entre fotogramas clave — las capas se emparejan por él, nunca por su posición en la lista. Una capa presente en un fotograma clave y ausente del siguiente se desvanece; reordenarlas no cambia nada
typecumulus, stratus, stratocumulus, cirrus o unknown. Decide la forma de las cimas y lo fino que es el velo; un cirro es además el que refracta los halos. Cambia en el fotograma clave, no se interpola
baseM, thicknessMMetros. La base está sobre el suelo de REFERENCIA de la grabación, no sobre un testigo que sube; un testigo por encima de la base está dentro del manto o sobre él, y el cielo se dibuja en consecuencia
coverage0–1, y significa lo que dice: la fracción del cielo que cubre esta capa, sea cual sea el tamaño de sus nubes
sizeMLa anchura característica de una nube, en metros. Independiente de la cobertura: la misma fracción de cielo puede ser muchas nubes pequeñas o unas pocas grandes
density0–2, lo opaca que es la materia de la nube; 0 es transparente. También independiente de la cobertura
darknessDe 0 blanco a 1 muy oscuro. Si falta, el cloudDarkness del fotograma clave
seedQué patrón, de entre los infinitos que los mismos números pueden dibujar. Si falta, uno derivado del id, y por eso el id no debe cambiar
windDirectionDeg, windSpeedEl viento propio de esta capa, cuando difiere del general — la capa alta suele hacerlo. Si falta, el viento general
iceCrystalAlignmentSolo para un cirro
instancesNubes individuales dentro de esta capa — véase más abajo

Una nube individual en instances es una nube de su capa que el archivo sitúa con exactitud, porque el relato lo hizo: aquella tras la que pasó el fenómeno, la que estaba allí y en ningún otro sitio. Se dibuja como una más de su capa — la misma textura, el mismo umbral —, sin distinguirse de sus vecinas más que por dónde está y lo grande que es, y está ahí incluso cuando la coverage de la capa es nula. Se desplaza con el viento de la capa como las demás, y oculta un fenómeno ante el que pasa.

CampoSignificado
idEstable entre fotogramas clave, misma regla que para una capa
eastM, northMDónde estaba su centro en el instante cero, en metros desde el punto de partida del testigo. El viento la arrastra desde allí
baseM, thicknessMSu propia base y su propia altura, en metros — una nube puede estar más baja o alzarse más que su manto
widthM, depthM, rotationDegSu huella, en metros, y el rumbo hacia el que está girada esa huella
density, darknessLas suyas propias; si falta la oscuridad, la de la capa
{
  "weather": {
    "cloudLayers": [
      {
        "id": "low", "type": "cumulus",
        "baseM": 1500, "thicknessM": 800,
        "coverage": 0.55, "sizeM": 1400, "density": 1, "darkness": 0.15,
        "instances": [
          { "id": "the-one", "eastM": 0, "northM": 4200,
            "baseM": 1500, "thicknessM": 800,
            "widthM": 1900, "depthM": 1300, "rotationDeg": 12, "density": 1 }
        ]
      },
      { "id": "high", "type": "cirrus", "baseM": 8000, "thicknessM": 400,
        "coverage": 0.2, "sizeM": 2200, "density": 0.35, "iceCrystalAlignment": 0.65 }
    ],
    "precipitationType": "none", "precipitationIntensity": 0,
    "windDirectionDeg": 90, "windSpeed": 5, "storm": false
  }
}

Una grabación cuyo tiempo fue consultado (tiene un weatherSource) guarda la respuesta del registro, no un enlace a él: ERA5 da las bandas baja, media y alta como tres capas llamadas record-low, record-mid y record-high, la base baja estimada a partir de la diferencia entre temperatura y punto de rocío, las otras dos a 3 500 m y 8 000 m. Su tipo es unknown (cirro para la alta), su tamaño y su densidad son supuestos de dibujo: un reanálisis sabe qué parte de cada banda estaba cubierta, no qué aspecto tenían las nubes. Vuelve a pedir el registro desde el editor y las capas se reescriben; edita una capa a mano y la grabación pasa a ser del autor, y la fuente se elimina.