Intorno a ciò che è stato visto
Il seguito del file di un'osservazione, dopo ciò che è stato visto: gli spostamenti del testimone e ciò che ha fatto, lo strumento, il suono, lo scenario e i veicoli, ciò che è accaduto nel cielo, e il meteo con le sue nuvole.
Ogni estratto qui sotto è in sola lettura, e ognuno conosce il formato: metti il cursore dentro un oggetto e premi Ctrl+Spazio (⌥+I su Mac) per elencare tutte le chiavi che potrebbero andarci, con ciò che il modello dice di ciascuna.
I campi intorno a ciò che è stato visto
| Campo | Significato |
|---|---|
observerTrack | { keyframes: [{ t, pose }] } — pose contiene lat, lng, elevationM (sopra il suolo locale), headingDeg, pitchDeg, rollDeg, fovDeg, e per una fotocamera fNumber e focusDistanceM. Riprodotto come si muove una persona: esattamente la posa indicata a ogni fotogramma chiave, e fra l'uno e l'altro un movimento che prende velocità, la mantiene attraverso i fotogrammi chiave che continuano a muoversi, e rallenta fino a una pausa — due fotogrammi chiave con lo stesso luogo, o la stessa direzione. Uno sguardo inizia e finisce fermo; una camminata o un tragitto in auto già in corso al primo fotogramma chiave prosegue. Fermarsi e ripartire a piedi aggiungono il loro sobbalzo, un cenno del capo che si spegne in un secondo e mezzo, trasferito nell'immagine quanto lo strumento lo lascia passare (appena per un occhio, del tutto per una fotocamera tenuta in mano). E un corpo a riposo non è mai del tutto immobile: in piedi o in attesa, la vista oscilla di qualche millimetro e deriva di un decimo di grado, lentamente, allo stesso modo nello stesso istante — tranne per un testimone che il resoconto dice paralizzato (tag paralysis). Il pitchDeg indicato è come il testimone guardava nel riferimento di ciò che lo portava: finché si sposta, il lettore aggiunge come sale il veicolo stesso (la pendenza della strada sotto la traccia, letta dal rilievo, positiva in salita, o per un aereo la sua stessa salita, attenuata quando lo sguardo si allontana dalla sua strada), così che una salita alza la vista e il chip Inclinazioneindica la somma. filter è ciò che si teneva davanti allo strumento, un id di FILTERS come solar-visual per un'eclissi. Viene mantenuto tra i fotogrammi chiave, non sfumato (nessuno porta mezzi occhiali), e si toglie dichiarando "none". Un fotogramma chiave che indica viewOnly: true fissa la vista del suo solo istante (l'editor lo scrive quando la vista è girata tenendo Alt premuto): la rotazione della fotocamera verso di esso e da esso resta fuori dall'immagine, e un'esposizione che lo tocca è disegnata come se la fotocamera fosse rimasta ferma, puntata come all'istante mostrato. Un testimone che vola a una quota data la indica con altitudeM (metri sul mare): il lettore pone allora l'occhio a quella quota sopra il rilievo che disegna, e elevationM è solo l'altezza sopra il suolo rispetto a cui è stato scritto il file, rispetto alla quale è quotato anche lo scenario di una cabina attorno all'occhio. |
events | Ciò che ha fatto il testimone, espresso come eventi con i loro parametri invece delle pose che implicano: [{ type: "event", eventType, t, until, params }], t e until in ms della registrazione. Il lettore ne calcola le pose leggendo la registrazione, con la stessa legge per tutte (una rotazione della testa parte da ferma e si assesta, la linea di un veicolo è una curva), e riscrive solo gli eventi finché nulla ha cambiato quelle pose; un observerTrack con fotogrammi chiave propri prevale su di essi. Un parametro porta la sua provenienza come ogni valore. Una tabella di istanti (speeds, speedDivisors, heights, metres) ha tante righe quante ne servono al racconto; il suo valore passa gradualmente da una riga alla successiva, o di colpo a una riga con step: true. A piedi: look (uno sguardo tenuto da t in poi, headingDeg, pitchDeg), walk (da from a to, due { lat, lng }, tra t e until, come cammina e si ferma una persona) e follow (un corpo della lettura, o un fenomeno che attraversa il cielo, target, che gli occhi raggiungono reactionS dopo, con lagS di ritardo, guardato ogni sampleMs in mancanza di fotogrammi chiave propri, guardato a ciascuno dei suoi fotogrammi chiave, al centro di ciò che vede, lo sguardo che gira tra di essi come gira una testa; tenuto dove lo perde, a until; observer-valensole.json). In veicolo: drive (il veicolo del testimone, un oggetto della scena nominato da vehicle, segue path, un elenco di { lat, lng }, alle velocità speeds [{ t, kmh }], eventualmente divise per speedDivisors [{ t, divisor }], collocato dall'unico luogo per cui è passato, through { t, lat, lng }; l'eye del conducente è { x, y, z } nel modello del veicolo), lookAhead (guarda la strada e tiene il bersaglio target { lat, lng } entro circa keepDeg, e gli lancia occhiate di glanceS seguite da roadS sulla strada quando è a più di glanceBeyondDeg; pitchShare dice fino a che parte della sua altezza alza lo sguardo), lean (verso lo specchietto: l'occhio si sposta di offsetM in turnS, per holdS) e watch (nello specchietto mirror, un punto del modello del veicolo: firstS, poi mirrorS tra due sguardi altrove, un'occhiata diretta di glanceS una volta su due fino a glancesUntil, la strada per roadS altrimenti). Ogni evento dice di chi è in who, con un id della registrazione che nient'altro ha: quello del testimone (observer.id, o "observer" per un testimone senza id; un evento che non ne dice nessuno è suo), di una forma o di un gruppo di forme, di un corpo, di un oggetto della scena. L'editor non salva una registrazione con un evento su niente, o con due cose dello stesso id. Un evento di un oggetto della scena: fly (un aereo lungo una linea retta che porta a from { lat, lng }, con rotta headingDeg, alle velocità speeds, a at.metresBefore da quel luogo all'istante at.t, a heights [{ t, altitudeM }] sopra l'occhio del testimone). Una sua luce (id/luce, f-hobs/landing-nose), o un gruppo di luci che i groups dell'oggetto nominano (f-hobs/strobes): light (a intensity dall'inizio dell'evento, 0 spenta, lampeggiando come prima, e tornata a ciò che era alla sua fine quando ne dichiara una) e blink (accesa per onS, spenta per offS, a intensity o a ciò che era, fino alla fine dell'evento, poi come prima): un faro di atterraggio spento, dei flash accesi, un lampeggiante, il balisaggio della cima di un edificio. Quelli del fenomeno (who la forma con cui è disegnato, o il gruppo delle sue forme) danno le forme del resoconto, come il testimone lo ha descritto: stand (nel luogo place che ha dichiarato, { lat, lng }, i suoi metres [{ t, widthM, heightM }] la sua larghezza e la sua altezza sopra l'occhio, da cui seguono a ogni istante la sua direzione e la sua dimensione nel suo cielo), appearance (il suo aspetto da t in poi, le sue parts: forme collocate e dimensionate in parti della sua larghezza apparente, sourceId, kind, points, color, brightness, halo, widthShare, heightShare, alongShare, upShare; una parte che un altro aspetto ha e questo no non è vista), blink (le forme di cui è, un gruppo di quelle del fenomeno o una di esse, accese per onS, spente per offS, che prendono off da spente) e vanish (non è più visto). Oppure, senza luogo, attraversando il cielo, un resoconto di sole direzioni: travel (from una direzione { azimuthDeg, altitudeDeg } towards un'altra, lungo il cerchio massimo che le unisce, alle velocità speeds [{ t, degPerS }], gradualmente tra due; sizeDeg di larghezza allo zenit, più piccolo come il seno della sua altezza quando sizeBy è "altitude"; le sue parti disposte lungo il suo cammino nell'immagine del testimone, alongShare davanti o dietro, upShare alla sua sinistra, girate con esso), turn (di byDeg verso il suo lato side, "left" o "right", gradualmente; l'altro lato nel cielo quando seenFrom è "craft", come lo dice un pilota), roll (inclinato fino a toDeg, e tornato in piano con andBack, più stretto di traverso secondo il coseno), vibrate (da un lato all'altro hz volte al secondo, di amplitudeShare della sua dimensione, da niente in riseS, poi sempre meno fino alla fine dell'evento) e spiral (turns giri di un cerchio accanto al suo cammino, clockwise o no, di radiusDeg una volta aperto, ridotto di shrink alla fine, rollando di rollDeg); observer-saint-lo.json. Quelli di un corpo della lettura (who il suo id; o, su una parte del suo modello, un nodo o un osso, id/parte: craft/legs, etre-2/head, che spin e turn fanno girare da sola attorno al proprio asse verticale, in senso orario vista dall'alto, il resto del corpo così com'è; una luce, con il suo nome nel modello, engin/front-red, o un gruppo delle sue parti che i groups del corpo nominano, engin/rear; è il file del modello a dire quali parti ha) si aggiungono ai fotogrammi chiave che dichiara: motion (un movimento del suo modello eseguito una volta, motion fino a to, il tubo centrale che rientra), spin (uno che continua a girare, turnsPerS, le gambe), rise (distanceM lungo una retta a angleDeg dalla verticale, 0 dritto in alto, verso headingDeg, da fermo, rallentando fino a fermarsi o, stops: false, sempre più veloce mentre se ne va), turn (voltarsi verso headingDeg), ride (portato dal corpo in, aboveM più in alto), light (una luce, o un gruppo di luci, accesa a cdM2 dall'inizio dell'evento, 0 spenta, e riaccesa com'era alla sua fine quando ne dichiara una) e blink (una luce che lampeggia, accesa per onS, spenta per offS, a cdM2 da accesa o a ciò che era prima, fino alla fine dell'evento, poi come prima; di colpo, mai in dissolvenza: i flash di un aereo, un lampeggiante, la luce in cima a un traliccio) e vanish; anche una postura è un movimento del modello (motion su crouch, che porta una figura esportata con le sue posture: 0 in piedi, 1 accovacciata); il velivolo e gli esseri di observer-valensole.json. observer-silly-le-long.json esprime così il suo testimone, il suo aereo e il suo fenomeno |
sampleMs | Ogni quanto si prende un fotogramma chiave, in ms: dal registratore dell'editor quando si sposta una forma a mano, e dove gli eventi sono sviluppati in valori (le forme del resoconto, lo sguardo che le segue, un corpo che si alza), tutti allo stesso passo, perché ciò che è disegnato e lo sguardo per cui lo è non si sfasino mai. Di ciò che ne risulta, i fotogrammi chiave che dicono la stessa cosa conservano solo il primo e l'ultimo: il lettore disegna lo stesso tra di essi. Assente, ciascuno conserva il proprio: 25 ms per un fenomeno che attraversa il cielo e lo sguardo che lo segue, 2 s per uno immobile, 250 ms per un corpo che si alza |
weatherTrack | { keyframes: [{ t, weather }] } — le condizioni del cielo lungo la registrazione: precipitazioni, vento, temporale, e le nuvole come strati ad altezze reali, ognuno in grado di contenere nuvole singole collocate in metri. Ogni campo di un weather è nella sezione seguente |
weatherSource | { id, name, url } del dato da cui è stato ricavato il meteo. La sua presenza significa che la registrazione viene riprodotta esattamente come è stata composta e non viene mai più consultata. Se manca, è il resoconto del testimone stesso |
lightPollution | La brillanza del cielo notturno del luogo, città comprese: lo zenit di una notte senza Luna in magnitudini per secondo d'arco quadrato, come lo legge uno Sky Quality Meter o come lo dà l'atlante mondiale della brillanza artificiale del cielo notturno (la sua cifra «SQM», Falchi et al. 2016, che lightpollutionmap.info mostra per ogni luogo). 22 è un cielo naturale, una periferia intorno a 19, un centro città 17. Se manca, un cielo naturale. La parte delle città, ciò che resta tolti i 22 naturali, si aggiunge al cielo come luce: più forte verso l'orizzonte, dove l'aria bassa ne rimanda di più, e disegnata nel bianco caldo di una lampada a 3000 K. Annega la Via Lattea e la luce zodiacale, e toglie stelle, della differenza nella stella più debole che un occhio distingue (Crumey 2014): circa due magnitudini a 19. Ora la Luna fa lo stesso. "derived" quando è ricavata dall'atlante, "stated" quando il testimone l'ha misurata. L'editor la compila dall'atlante per un'osservazione dal 2015 in poi, come "derived" con l'atlante nominato, e non sostituisce mai una cifra scritta a mano; prima del 2015 non consulta nulla, perché il cielo era più buio di quello dell'atlante |
observerMap | Se la mappa di dove si trovava il testimone parte aperta quando la registrazione viene riprodotta o modificata: true o false. Se manca, decide il lettore: aperta per un testimone che si è spostato, chiusa per uno rimasto fermo. Una pagina che incorpora il lettore ha l'ultima parola (il suo attributo show-observer-map). L'editor lo scrive quando la mappa viene aperta o chiusa al suo interno, così che un lettore veda ciò che l'autore ha lasciato |
snapshots | Dove sono conservati, in file accanto alla registrazione (allegati), i dati che la scena chiederebbe altrimenti a terzi a ogni riproduzione, perché una registrazione finita si riproduca uguale fra dieci anni senza chiedere nulla a nessuno: relief (l'altezza del suolo, come la fonte di quota l'ha data per ogni porzione di terreno che la scena costruisce, uno zip), imagery (la foto del suolo, come le tessere servite dalla fonte di immagini, uno zip), roads, water, railways (strade, acque e binari di ogni porzione, in JSON), upperAir (l'aria alla quota degli aerei, in JSON) e map (la foto sotto la mappa del testimone, come le tessere servite dalla fonte di immagini per il terreno a cui la mappa è adattata, uno zip: una mappa presa come istantanea mostra quella foto e non ne chiede altre, ingrandita avvicinandosi, vuota oltre allontanandosi). Ognuno è { src, takenOn, attribution }, con src letto rispetto all'indirizzo della registrazione, o un URL data: per un allegato conservato dentro la registrazione stessa. Un gruppo letto dal suo allegato non chiede nulla a nessuno; uno senza allegato è chiesto in diretta, come tutto prima. "live": true su un gruppo lo chiede in diretta a ogni riproduzione e non ne prende mai un'istantanea (ciò che dice scegliere la sua fonte in diretta invece di File), e su snapshots stesso tutti i gruppi; "refresh": true su un gruppo lo chiede in diretta una volta, e l'editor lo rileva al salvataggio successivo. L'editor rileva ciò che manca al salvataggio, e salva la registrazione e i suoi allegati in un unico zip da decomprimere dove è pubblicata. weather, place, lightPollution e decor dicono che il meteo (weatherTrack, weatherSource), il nome del luogo, la cifra del cielo notturno e la scenografia sono letti dal file invece di essere richiesti di nuovo (ai dati meteo quando cambiano la data o il luogo, al geocodificatore, all'atlante e al rilievo quando il testimone si sposta): {} se sono dentro la registrazione, { src } per un allegato con le loro chiavi, che i lettori rimettono nella registrazione caricandola. Se mancano, sono dentro la registrazione e l'editor li richiede. Il fuso orario non è qui: è scritto nella registrazione stessa |
modules | I moduli di cui la registrazione ha bisogno per essere disegnata come è stata fatta (un catalogo da cui vengono i suoi modelli), per l'indirizzo del manifesto di ognuno, relativo alla registrazione o assoluto: vedi moduli. Un lettore riceve ciò che ogni manifesto dichiara, mai il suo script a meno che non abbia aggiunto quel modulo lui stesso. Assente, non ne serve nessuno |
soundTrack | { keyframes: [{ t, sound }] } — kind (none/hum/whistle/rumble/crackle), volume, pitchHz, e un src facoltativo di una registrazione reale. volume e pitchHz scorrono fra i fotogrammi chiave, kind e src cambiano al fotogramma chiave. Un src su un altro sito deve essere servito a qualsiasi origine (CORS) |
references | Immagini del luogo sovrapposte alla scena: src (un indirizzo, o un URL data: per un'immagine aggiunta da un disco), kind (photo/panorama/video), registration (headingDeg, pitchDeg, rollDeg, fovDeg), opacity, credit/creditUrl, t e drawing facoltativi, from ({ lat, lng }, dove è stata scattata: il lettore la dissolve man mano che il testimone si allontana da quel punto; se manca, non si dissolve mai), e i landmarks su cui è stata allineata (id, label, picture come { u, v } dall'angolo in alto a sinistra, scene come { azimuthDeg, altitudeDeg }). Un video indica anche t, dove inizia il suo tratto sulla timeline, video (fromS, toS, rate: quale parte del file, a che velocità) e registrationTrack, dove puntava la sua camera in ogni istante allineato. |
traces | Ciò che un investigatore ha disegnato sul luogo, importato dal suo file Google Earth (KML, KMZ) o dal GeoJSON del suo GIS e mostrato sulla scena come suo, mai come parte della ricostruzione: [{ id, title, kind, points, altitude, color, source }], dove kind è point, line o polygon, points i vertici come [{ lat, lng, altM }] esattamente come li aveva il file, altitude come si legge altM (ground, predefinito, relative al suolo sotto ogni punto, o absolute sul livello del mare), color un #rrggbb e source di chi è |
instrument, exposureSeconds | Attraverso che cosa è stato osservato, e per quanto tempo è rimasto aperto l'otturatore. Se manca, l'occhio nudo. instrument è uno fra eye, rectilinear-lens (una fotocamera di marca sconosciuta), roamer-1-120, instamatic-126, slr-35mm-50, slr-35mm-zoom, phone-landscape, phone-portrait, o una reflex digitale (eos-5d-iii, nikon-d7000… i sensori del catalogo di Stellarium), un binocolo (binoculars-nikon-10x42-edg…) o un telescopio (telescope-celestron-c8…); exposureSeconds è un unico valore per tutta la registrazione, contenuto nell'intervallo proprio di quel dispositivo; un apparecchio che registra un'immagine (una fotocamera, un telefono) vi aggiunge i riflessi fantasma del suo obiettivo su ogni luce, come fanno il vetro e il sensore: una copia più debole e sfocata sulla retta che passa per il centro dell'immagine, simmetrica rispetto a esso per il riflesso principale di un telefono, il disco rosso opposto a un semaforo. Un telefono si espone da sé in base a ciò che vede, fino a ISO 3200: una notte che filma resta scura attorno alle sue lampade |
lens | Attraverso cosa è stata presa l'immagine oltre all'obiettivo, e cosa c'era su quel vetro, per un apparecchio che ne registra una: glass (filter, window o windscreen: un filtro aggiunge un riflesso simmetrico rispetto al centro, un vetro un doppio più debole di ogni luce appena accanto, più lontano per un parabrezza inclinato), drops, condensation e dirt (da 0 a 1, ognuno con un alone attorno a ogni luce, che perde ciò che l'alone prende) e sheltered. Senza drops, le gocce seguono la pioggia o la neve che cade a ogni istante, salvo se sheltered è vero: ne cadono di nuove tanto più spesso quanto più la pioggia colpisce il vetro di fronte (un obiettivo alzato, un vetro di fronte al vento, un parabrezza inclinato ne ricevono di più), si fondono con le vicine; le piccole restano attaccate per minuti, le grandi scendono dopo qualche secondo lasciando una scia di perle e pulendo ciò che incontrano, e continuano anche quando ha smesso di piovere. I riflessi dell'obiettivo stesso seguono la sua apertura: più larghi a obiettivo aperto, e col poligono delle sue lamelle una volta diaframmato. ghosts indica i riflessi di un'ottica posta davanti all'obiettivo, che nessun catalogo conosce (lo specchio e i prismi di un periscopio), ciascuno come quelli di un obiettivo: scale, share, blur, offset, tint; reachDeg fin dove, oltre l'angolo dell'inquadratura, una luce colpisce ancora la sua prima superficie (30° per un obiettivo); placedDrops gocce indicate una a una invece di quelle che drops sparge a caso, ciascuna un radius (parte dell'altezza dell'immagine) e una track di {t, x, y} (ms, parti della larghezza e dell'altezza dell'immagine dal suo angolo in alto a sinistra), tenuta alle estremità; drops dice allora solo quanta luce diffondono |
lighting | Ciò che l'immagine mostra della luce in cui è stata presa, quando dice dove fosse il Sole (un lato illuminato, un lato in ombra): sunFromViewDeg, l'arco degli azimut del Sole, in senso orario dalla direzione in cui guardava lo strumento all'inizio ({ fromDeg: 105, toDeg: 285 }: dietro di esso, da una parte o dall'altra), e sunAltitudeDeg ({ minDeg, maxDeg }), la sua altezza minima e massima. Vincola una lettura dell'osservazione: la data, l'ora, il luogo e la rotta che indica possono muoversi entro ciò che si sa di ciascuno, ma il Sole che compongono deve illuminare la scena come la mostra l'immagine, così che spostare il luogo sposta le ore consentite, e viceversa |
iso | La sensibilità della pellicola o del sensore su cui è stata scattata l'immagine, quando è nota: 400 per una pellicola da 400 ISO. Se manca, quella del dispositivo stesso (il negativo a colori di una reflex è 100, quello di una Instamatic 64). L'immagine di una fotocamera non risponde come quella di un occhio: una pellicola non si adatta al cielo, riceve un'esposizione — la luce, per il tempo di otturazione, divisa per il quadrato del numero f — e vi risponde con la propria curva (quella morbida di un negativo, quella più ripida di una diapositiva, la linea retta di un sensore che si ferma al bianco). Così una posa notturna esce con un cielo nero e ciò che vi brillava in risalto. Indicata per un apparecchio che regola da sé l'esposizione (un telefono), è quell'apparecchio regolato a mano, come nella sua modalità manuale |
film | La pellicola della ripresa, quando è nota, con il suo identificativo nel catalogo: "kodachrome-64". Dà la sensibilità, salvo che iso ne indichi un'altra, e la risposta alla luce, bianco e nero compreso. Se manca, nessuno lo dice. |
metering | Come un apparecchio che regola da sé l'esposizione ha letto la luce, quando lo si sa: "average", la media di tutta l'immagine, come le videocamere e i telefoni vecchi, che brucia in bianco una luce viva in un'immagine scura; oppure "highlights", come i telefoni recenti, trattenendosi perché una luce che occupa una parte notevole dell'immagine mantenga il suo colore (una lanterna a venti metri esce arancione, bianca solo vicino alla fiamma), il resto della notte più scuro. Assente: quella dell'apparecchio (un telefono protegge le sue alte luci) |
sway | Quanto il corpo che tiene lo strumento muove la vista quando non cammina: 1 per una persona in piedi o seduta, 0 per una fotocamera su treppiede, qualsiasi valore intermedio o superiore per meno o per più. Se manca, 1 — tranne per un testimone che il resoconto dice paralizzato (tag paralysis), per cui è 0, e per un'esposizione più lunga di mezzo secondo, che nessuna mano tiene ferma: quello è un treppiede, e anche 0 |
vehicle | Il veicolo in cui si trovava il testimone, quando lo scenario non lo disegna: { kind, windowsOpen, noise }, dove kind è o un veicolo stradale (car, van, truck, motorcycle, generic) o un aeromobile, per la sua classe come si chiamano gli aerei del cielo (business-jet, airliner-narrow, helicopter-light…): un solo campo per entrambi, non avendo i due vocabolari alcuna parola in comune. Sentito dall'interno: il suo motore segue il tragitto del testimone stesso — la marcia dalla velocità, i giri dalla marcia, lo sforzo dall'accelerare o dal rallentare — con il rotolamento e il vento, attutiti da un abitacolo chiuso, lasciati entrare da finestrini aperti. Un aeromobile non ha né marce né cilindri: ciò che se ne sente è il rombo continuo della sua cabina, al livello che vi misura un passeggero per quella classe di macchina. noise è il suo livello sonoro rispetto a uno ordinario del suo tipo (1 per impostazione predefinita). Ciò su cui viaggia il testimone si frappone inoltre fra lui e tutto ciò che sta fuori, e toglie più agli acuti che ai gravi: un aereo a cento metri non è che un rombo attraverso una fusoliera, e sotto il rombo della cabina non si sente più affatto; la pioggia e il vento entrano attutiti allo stesso modo. windowsOpen lascia rientrare quasi tutto. È anche ciò che tiene attivo il pulsante del suono del lettore quando il file non ha soundTrack: il pulsante risponde di tutto ciò che la scena riproduce — questo motore, un engine dello scenario, un aeromobile dello scenario in volo, un corpo di una lettura che si sente, la pioggia e il vento — e non solo della traccia. Le sue luci: headlights è una regolazione come per un veicolo dello scenario (off, position, dipped, main, fog) o auto, predefinito: gli anabbaglianti dal crepuscolo e niente di giorno, come fa un conducente. headlightKeyframes è [{ t, mode }] per un cambiamento durante la registrazione. Il fascio illumina la strada davanti al testimone, nella direzione in cui va il veicolo. |
decor | Scenario a eastM/northM reali dal testimone: edifici (con floors, windows), alberi, arbusti, lampioni, veicoli, ponti, linee aeree, altri testimoni, aeromobili — facoltativamente con una track e delle lights il cui pattern porta una cadenza di lampeggio reale. Vedi sotto |
Un elemento dello scenario si esprime in metri, come tutto ciò che non è il fenomeno:
| Campo | Significato |
|---|---|
eastM, northM, headingDeg | Dove si trova rispetto al testimone, e verso dove è rivolta la sua parte anteriore, in senso orario dal nord vero |
sizeM | { widthM, lengthM, heightM } lungo i suoi assi, la lunghezza essendo la direzione verso cui è rivolto. Ogni asse è facoltativo: uno che nessuno ha misurato mantiene la proporzione propria della forma integrata |
model | Un vero modello 3D al posto della forma integrata: una voce del catalogo tramite id, o un file glTF/GLB a url (che prevale, deve essere leggibile da qualsiasi origine, e allora richiede il suo credit; uno relativo si legge dal file che lo indica). Non decide mai la dimensione: viene scalato, mantenendo le proporzioni, sul primo asse misurato fra lunghezza, altezza e larghezza, o sulla dimensione reale che gli dà il catalogo. Visto dall'interno, e ogni volta che il modello non si può ottenere, viene disegnata invece la forma integrata. headingOffsetDeg ruota il modello caricato attorno al suo asse verticale perché il muso punti dove la scena se lo aspetta (0 guarda a nord con una prua di 0); una voce del catalogo porta la sua. credit è { title, author, license, sourceUrl }: license come la enuncia il suo autore ("CC BY 4.0") e sourceUrl da dove viene, perché l'affermazione sia verificabile. |
bridge | Per un "bridge": come è costruito. sizeM.lengthM è tutta la sua lunghezza lungo la strada, rilevati compresi, widthM la larghezza dell'impalcato e heightM l'altezza della carreggiata sull'impalcato sopra il suolo; spanM è la luce libera sotto l'impalcato, con la strada che corre su un rilevato di terra digradante fino al suolo su ciascun lato; deckThicknessM lo spessore della soletta (1,2 per impostazione predefinita); railing { heightM, postSpacingM, rails } il parapetto lungo entrambi i bordi, montanti e correnti le cui aperture sono rettangoli (1,05 m, 1,5 m e 2 correnti per impostazione predefinita). Disegnato con quelle misure, mai stirato |
wire | Per un "wire" (una linea elettrica o telefonica): sizeM.lengthM è la campata fra i suoi pali, lungo il suo headingDeg, e heightM l'altezza del filo più basso; strands [{ heightM, acrossM }] ne appende diversi (quelli sovrapposti condividono un acrossM, quelli di una traversa differiscono); poles è both (predefinito), start o end (l'estremità da cui la sua direzione si allontana o verso cui punta: l'altra è ancorata a un edificio) o none; diameterM (8 mm per impostazione predefinita) e poleHeightM (mezzo metro sopra il filo più alto). Dritta, senza catenaria, e disegnata a quelle misure, mai allungata |
track | [{ t, eastM, northM, altitudeM, headingDeg }] quando si muove, altitudeM sopra il suolo sotto di esso (l'occhio è a elevationM + 1,6 m: un corpo all'altezza dell'occhio ha quell'altitudeM). La posizione è interpolata fra i fotogrammi chiave; la direzione è mantenuta dall'uno al successivo |
lights | Le sue luci: id, offsetM { x, y, z } dal suo centro (destra, alto, davanti), color, intensity (1 è una normale luce di navigazione) e un pattern: { "kind": "steady" }, oppure { "kind": "flash", perMinute, dutyCycle, phase }, la cadenza come la stabiliscono i regolamenti, la frazione accesa di ogni ciclo (circa 0,5 per un lampeggiatore a filamento, 0,01 per uno stroboscopio) e uno sfasamento da 0 a 1 fra le luci. L'editor le compila da preimpostazioni: “Aereo di linea”, “Elicottero”, “Auto, fari accesi”, “Auto, luci di emergenza”, “Lampeggianti di veicolo di soccorso”, “Lampione”. Come si accende o si spegne durante la registrazione, da ogni istante in poi, keyframes [{ t, intensity, pattern }]: ciò che danno gli eventi light e blink che la riguardano |
groups | Le sue luci prese insieme, perché un solo evento le riguardi tutte: { id, title, members }, i suoi membri sue luci o altri suoi gruppi. Nominato in un evento come una luce, id/gruppo: i due flash di un aereo, f-hobs/strobes. Facoltativo |
engine | Un veicolo che si sente in moto: { kind, noise }, come vehicle sopra. Il suo motore segue la sua track, sentito da dove si trova il testimone, più debole e più sordo con la distanza |
aircraftSound | Un aeromobile (kind aircraft) che si sente mentre vola, cosa che fa quando la sua track lascia il suolo: il tipo di rumore che fa, una classe di aeromobile (airliner-narrow per impostazione predefinita, airliner-wide, regional-jet, helicopter-light, light-piston…) o silent per uno che non ne fa alcuno. Ciò che dice il suo modello vale quando questo manca (i sostituti di un fenomeno sono silenziosi). Si sente come gli aerei di un registro di traffico aereo: più debole e più cupo con la distanza, in ritardo per il tempo che il suono impiega ad arrivare (circa tre secondi per chilometro), così da essere sentito dov'era, più acuto mentre si avvicina e più grave mentre si allontana, e mascherato dal rumore del luogo |
occludesSourceIds | I fenomeni davanti ai quali il testimone ha detto che questo elemento si trovava: vedi le regole della pagina del formato |
facade | Solo il genere building: { color?, plain? }. color è il muro, "#rrggbb"; salvo che plain sia true, si disegnano finestre a ogni piano e una porta al piano terra della faccia frontale. Disegnata alla sizeM enunciata (devono esserlo tutti e tre i lati), mai stirata, e non per un edificio con un testimone dentro. L'editor prende il colore dal materiale che la carta enuncia per i muri (pietra, mattone, calcestruzzo, blocco, legno), o un intonaco dove non ne enuncia. Assente è la semplice scatola. |
roof | Solo il genere building: { shape, riseM, color?, ridge? }. shape è "flat" (la scatola), "gable" (due falde fino a un colmo lungo il lato maggiore, o la profondità con ridge: "depth") o "hip" (quattro falde); riseM è quanto il colmo sta sopra la gronda, quindi i muri sono sizeM.heightM meno quello; color è il tetto visto dall'alto, "#rrggbb". L'editor li legge dal laser e dalla foto aerea del rilievo. Assente è un tetto piano del colore dei muri. |
origin | Il rilievo da cui è stato ricavato questo oggetto, dall'id del suo fornitore ("ign-lidar-topo"), quando l'editor lo ha preso dal rilievo del luogo e l'autore non lo ha collocato a mano: un albero, un edificio, un ponte o una campata di linea. Scegliere un altro rilievo, o nessuno, o un altro luogo, sostituisce o toglie ciò che porta un origin, e mai ciò che non lo porta |
surveyedOn | Il giorno (AAAA-MM-GG) del rilievo più recente da cui è tratto questo oggetto, quando viene da uno (vedi origin): l'editor avvisa quando è successivo all'osservazione. |
lit, litKeyframes | Se la lampada di un lampione o i fari di un veicolo sono accesi. litKeyframes è [{ t, lit }], ordinato per t, per una luce che si accende o si spegne durante la registrazione; senza, lit vale per tutta la durata. Ignorato per un edificio, un albero o un testimone |
headlights, headlightKeyframes | Come sono regolate le luci di un veicolo, perché non tutti le accendono, né come si dovrebbe: off, position (le luci di posizione, che mostrano il veicolo e non illuminano nulla), dipped (gli anabbaglianti), main (gli abbaglianti: lontani, stretti, accecanti) o fog (i fendinebbia: bassi e larghi). Un fascio illumina la strada, i bordi, gli alberi e i muri davanti al veicolo, comunque sia disegnato. headlightKeyframes è [{ t, mode }], ordinato per t, per una regolazione che cambia durante la registrazione. Senza nessuno dei due, lo dice lit: acceso sono gli anabbaglianti. Ignorato per tutto ciò che non è un veicolo. Solo quattro veicoli (quello del testimone, poi i più vicini dello scenario) hanno un vero fascio. I fari del testimone proiettano ombre (una scarpata, un palo o una pila di ponte trattiene la luce di ciò che sta dietro), e il fascio si vede nell'aria in proporzione a ciò che l'aria ne diffonde: una traccia lieve con aria limpida, un cono di luce nella nebbia |
observerSide, observerFacing, observerKeyframes, occupiedFloor | Il testimone dentro l'oggetto, per un building o un veicolo (un solo oggetto alla volta lo contiene). observerSide dice dov'è: front, behind, left, right, front-left, front-right, behind-left o behind-right, l'occupante di un veicolo trovandosi a una delle sue quattro portiere. observerFacing è il finestrino da cui guarda quando non è quello del suo posto: un conducente siede in front-left e guarda dal parabrezza, front. observerKeyframes, [{ t, side, facing }], dice dove siede nel tempo, ciascuno mantenuto fino al successivo, e un fotogramma senza side significa fuori da lì in poi, come un conducente che scende. occupiedFloor è il piano di un edificio su cui si trova, da 0 (piano terra) a floors |
modelParameters | Le impostazioni del modello con cui l'oggetto è disegnato, per la chiave con cui la voce del catalogo pubblica ciascuna: { "costumeColor": "#5a6b3a" } per i vestiti di una persona, foliageColor per un albero, hullColor per un velivolo, gearUp per un aereo di linea in volo. Un modello porta le sue (l'editor disegna un campo per ciascuna); un oggetto disegnato come forma integrata non ne ha, è dipinto da color |
sightingUrl | Per un observer: l'indirizzo della registrazione propria di quell'testimone, quando è noto, così che il menu della scena possa offrire di vedere la sua testimonianza |
Eventi del cielo#
Ciò che è accaduto nel cielo durante la registrazione, come fatti: un tiro laser, un lancio di razzo, un rientro. Ciascuno è avvenuto che qualcuno l'abbia visto o no: non è quindi la lettura del resoconto, né lo scenario, che dura più dell'osservazione (una casa, un albero). Sono dichiarati sotto skyEvents, al primo livello della registrazione; una registrazione che li metteva nella sua interpretation, come facevano le versioni precedenti, viene ancora letta.
{
"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
}]
}
}
| Campo | Significato |
|---|---|
reentries | I rientri atmosferici avvenuti, un satellite o uno stadio di razzo che si disintegra in pezzi che bruciano. Non sono corpi: un rientro brucia tra 70 e 100 km di quota e si vede a centinaia di chilometri, quindi è collocato sulla Terra e visto attraverso la sua curvatura dal punto in cui stava il testimone. La sua track dà il punto di testa in istanti della registrazione, { t, lat, lng, altitudeKm }, uniti da cerchi massimi; ciascuno dei suoi fragments segue lo stesso percorso lagS secondi dietro, si vede da fromT finché si spegne a untilT, brilla della sua absoluteMagnitude (a 100 km, come per un bolide) riportata alla distanza reale, nel suo color, con una scia degli ultimi trainS secondi del percorso (4 se manca: la scia di un rientro è lunga). Ogni pezzo si disgrega come fanno i pezzi che bruciano (sheds): uno sgretolarsi lento in frammenti deboli, ciascuno con la sua striscia, che restano indietro, si scostano e scendono in un ventaglio stretto, e una raffica di una trentina a ogni picco della sua lightCurve, un picco essendo una rottura (Zander & Löhle, CEAS Space Journal 2025). Un elenco di fasi lo dichiara al suo posto, { fromT, untilT, perS, lifeS, magnitudeDrop, dropBack, spreadKmS, sinkKmS, trainS }, e un elenco vuoto un pezzo che non perde nulla. Un picco più brillante della magnitudine −12 sotto i 50 km si sente come una detonazione, dopo il tempo che il suono impiega a percorrere la distanza (Čeljabinsk: due minuti e mezzo). La sua luce è propria: si vede che il Sole la raggiunga o no. object nomina ciò che è ricaduto (name, cosparId, norad). Nulla è propagato da elementi orbitali, sbagliati di minuti nell'ultima orbita: il percorso è ciò che le fonti stabiliscono, con la sua provenienza |
launches | I lanci di razzo avvenuti, illuminato da un Sole tramontato per il suolo ma non per la scia, la «medusa spaziale». Collocati sulla Terra come un rientro: la loro track dà lo stadio in istanti della registrazione, { t, lat, lng, altitudeKm } (può cominciare prima della registrazione), e burnFromT e burnUntilT i secondi in cui il motore ha bruciato. La scia è una fila di sbuffi lasciati lungo quel percorso, ciascuno che si allarga con l'età; ciò che si vede di ciascuno è la luce del Sole che diffonde verso il testimone. L'ombra della Terra (dove il Sole illumina o no all'altezza dello sbuffo, e quanta aria ha sfiorato la sua luce, che la arrossa o la rende blu), l'angolo di diffusione e l'espansione sono calcolati dal vero Sole alla vera data: nulla ne è dichiarato. Un plume facoltativo sostituisce i valori predefiniti: exhaustKgPerS (273, un Merlin Vacuum), condensedShare (0,065, l'unico numero che nessuno ha misurato), particleRadiusUm, expansionKmPerS, initialRadiusKm, lifetimeS, e per il collare (lo scarico appena rilasciato, largo e presto sparito, accanto alla scia stretta che resta) collarShare (0,85), collarExpansionKmPerS (2,5), collarLifetimeS (20). vehicle nomina ciò che ha volato e, in engine, il motore di cui è lo scarico: thrustKN e specificImpulseS (da cui si ricavano la portata dello scarico e la sua velocità, quindi la larghezza del collare) e propellant (rp1-lox, methane-lox, hydrogen-lox, hypergolic o solid, che dice quanta parte diventa particelle e di che dimensione). Ciò che dice plume prevale su ciò che dice il motore. La scia ha bisogno della data della registrazione: senza non c'è Sole che la illumini. vehicle.mission nomina la missione che compiva ("Starlink Group 10-49"). Ogni sbuffo vola da solo una volta rilasciato, alla velocità dello stadio più quella con cui è stato lanciato, attratto dalla Terra e frenato dall'aria solo dove è abbastanza densa da scorrergli attorno (sotto i 200-300 km): la scia è la stessa cosa nello spazio vista da ogni lato, una scia vista di fronte è un disco, una spirale vista di taglio una linea. Il suo colore è quello della dimensione delle sue particelle: il ghiaccio grosso diffonde bianco, quello più fine della lunghezza d'onda blu. jets elenca cos'altro rilascia lo stadio, ciascuno { kind, fromT, untilT, angleDeg, azimuthDeg, spinPeriodS, speedKmPerS, massKgPerS, condensedShare, particleRadiusUm, expansionKmPerS, initialRadiusKm, lifetimeS }: kind burn (un'altra accensione del motore, con i valori della scia; una frenata di deorbitazione è angleDeg 180, lo scarico che parte davanti) o vent (propellenti scaricati dai serbatoi, più lenti, fini e freddi: 0,7 km/s, 20 kg/s, metà che gela, per default); angleDeg da dietro il moto (0) fino al lato (90); azimuthDeg il lato da cui esce attorno al moto (0 opposto alla Terra); spinPeriodS il giro dello stadio attorno al suo moto, che fa girare il getto con lui e disegnare una spirale ai propellenti scaricati. Quando ci sono getti, l'accensione dell'ascesa è disegnata solo se è dato burnFromT o burnUntilT. |
beams | I fasci di luce inviati nell'aria dal suolo, un tiro laser o un proiettore. Ciascuno ha un path di almeno due punti { lat, lng, altitudeM } (altitudini sul mare): dove lascia l'emettitore, dove uno specchio lo devia se c'è, e dove finisce. Tra due punti è una retta nello spazio, non lungo il suolo, che si abbassa sotto di essa. wavelengthNm è il suo colore (532 per un laser verde), powerW la sua potenza ottica media, divergenceMrad quanto in fretta si allarga (0,1 se assente) e apertureM la sua larghezza alla partenza (0,01 m se assente); fromT e untilT dicono quando è acceso. Nulla della sua luminosità è dichiarato: ciò che si vede di ogni metro è ciò che l'aria in quel punto (molecole e foschia, alla sua lunghezza d'onda) diffonde verso l'occhio della potenza che gli resta, secondo l'angolo di cui la luce deve girare; è quindi molto più vivo visto risalendolo che guardandolo allontanarsi. È nascosto da ciò che gli sta davanti e si ferma dove incontra il suolo. |
Il meteo, e le sue nuvole#
Un fotogramma chiave weather esprime le condizioni del cielo in un momento dell'orologio
della registrazione; fra due fotogrammi chiave ogni numero viene interpolato, mentre il tipo di precipitazione e il
temporale vengono mantenuti. Contiene:
| Campo | Significato |
|---|---|
cloudLayers | Le nuvole, come elenco di strati — vedi sotto. Se manca, le descrivono i campi più vecchi delle righe vicine, adattati in uno strato d'acqua e un velo di cirri; un elenco vuoto significa un cielo sereno che qualcuno ha guardato |
cloudCover, lowerCloudCover, highCloudCover | Frazioni di cielo (0–1): il totale, solo gli strati d'acqua, e solo il velo ghiacciato. Scritte dalle registrazioni fatte prima che esistessero gli strati, e ancora tenute aggiornate dall'editor come riassunto di questi |
cloudBaseM, cloudDarkness | L'unica base della stessa epoca, in metri sopra il suolo di riferimento, e un'unica tonalità (0 bianco, 1 molto scuro) |
iceCrystalAlignment | 0–1, con quanta regolarità cadevano i cristalli di ghiaccio — ciò che trasforma un semplice anello in pareli, archi e una colonna. Nessun dato lo misura; uno strato di cirri porta il proprio |
rareIceCrystals | 0–1, la quota dei cristalli di un velo di cirri che sono di tipi rari: colonne con estremità piramidali (gli aloni a raggio dispari, a 9°, 20° e 35°) e lastrine libere di ruotare attorno a un asse orizzontale (gli archi di Lowitz). Assente significa 5%, un velo ordinario. Come l'allineamento, nessun dato li conta: è dichiarato. La simulazione che ne deriva è stata verificata coerente con Atmospheric Optics |
relativeHumidity | 0–1, vicino al suolo. Decide quanto è lattiginoso il cielo sereno: la foschia si gonfia d'acqua man mano che l'aria si avvicina alla saturazione. Un dato consultato la contiene (dalla temperatura e dal punto di rugiada di ERA5); se manca, una foschia tipica |
visibilityKm | La visibilità meteorologica vicino al suolo, in chilometri, come la dà un bollettino. È la foschia stessa: dichiarata, decide quanta ce n'è, per la lontananza come per il cielo, e l'umidità non viene più letta per questo Oltre i 30 km, è anche la distanza fino a cui è disegnato il rilievo (150 km al massimo), che scende con la curvatura della Terra: una montagna che un'aria limpida mostra lontano c'è. |
precipitationType, precipitationIntensity | none/rain/snow/hail, e 0–1. Indicata a un fotogramma chiave, riprodotta come cade: un rovescio inizia al fotogramma chiave che lo avvia con le sue prime gocce, e non raggiunge l'intensità indicata più in fretta di una pioggia reale (da niente al massimo in venti secondi); smette allo stesso modo. Un cambiamento che i fotogrammi chiave distribuiscono su un tempo più lungo viene seguito esattamente. precipitationAmount (0–1, assente significa tutta) dice quanta parte di quella precipitazione sta già cadendo. |
windDirectionDeg, windSpeed | Il vento generale: la direzione VERSO cui soffia, in senso orario dal nord, e metri al secondo. È ciò che trasporta le nuvole — dall'istante zero, così che cercare e riprodurre di nuovo diano lo stesso cielo |
storm | Fulmini e tuoni, con il giusto ritardo |
Ogni strato di cloudLayers è una coltre di nuvole a un'altezza
reale, e resta sé stesso da un fotogramma chiave al successivo:
| Campo | Significato |
|---|---|
id | Stabile fra i fotogrammi chiave — gli strati vengono abbinati tramite esso, mai per posizione nell'elenco. Uno strato presente in un fotogramma chiave e assente dal successivo svanisce; riordinarli non cambia nulla |
type | cumulus, stratus, stratocumulus, cirrus o unknown. Decide la forma delle sommità e quanto è sottile il velo; un cirro è anche quello che rifrange gli aloni. Cambia al fotogramma chiave, non viene interpolato |
baseM, thicknessM | Metri. La base è sopra il suolo di RIFERIMENTO della registrazione, non sopra un testimone che sale; un testimone sopra la base è dentro la coltre o al di sopra, e il cielo viene disegnato di conseguenza |
coverage | 0–1, e significa ciò che dice: la frazione di cielo che questo strato copre, qualunque sia la dimensione delle sue nuvole |
sizeM | La larghezza caratteristica di una nuvola, in metri. Indipendente dalla copertura: la stessa frazione di cielo può essere molte nuvole piccole o poche grandi |
density | 0–2, quanto è opaca la materia della nuvola; 0 è trasparente. Anch'essa indipendente dalla copertura |
darkness | Da 0 bianco a 1 molto scuro. Se manca, il cloudDarkness del fotogramma chiave |
seed | Quale motivo, fra gli infiniti che gli stessi numeri possono disegnare. Se manca, uno ricavato dall'id, ed è per questo che l'id non deve cambiare |
windDirectionDeg, windSpeed | Il vento proprio di questo strato, quando differisce da quello generale — di solito è il caso dello strato alto. Se manca, il vento generale |
iceCrystalAlignment | Solo per un cirro |
instances | Nuvole singole all'interno di questo strato — vedi sotto |
Una nuvola singola in instances è una nuvola del suo strato che il
file colloca con esattezza, perché il resoconto lo ha fatto: quella dietro cui è passato il fenomeno, quella che
era lì e da nessun'altra parte. Viene disegnata come una delle altre del suo strato — la stessa texture, la stessa
soglia —, distinta dalle vicine soltanto da dove si trova e da quanto è grande,
ed è presente anche quando la coverage dello strato è nulla. Segue il vento dello strato
come le altre, e nasconde un fenomeno davanti al quale passa.
| Campo | Significato |
|---|---|
id | Stabile fra i fotogrammi chiave, stessa regola di uno strato |
eastM, northM | Dove si trovava il suo centro all'istante zero, in metri dal punto di partenza del testimone. Il vento la trasporta da lì |
baseM, thicknessM | La sua base e la sua altezza, in metri — una nuvola può stare più in basso o elevarsi più della sua coltre |
widthM, depthM, rotationDeg | La sua impronta, in metri, e la direzione verso cui quell'impronta è ruotata |
density, darkness | Le proprie; se manca l'oscurità, quella dello strato |
{
"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 registrazione il cui meteo è stato consultato (ha un weatherSource)
contiene la risposta del dato, non un link a esso: ERA5 fornisce le fasce bassa, media e alta come tre
strati chiamati record-low, record-mid e record-high, la
base bassa stimata dallo scarto fra temperatura e punto di rugiada, le altre due a 3 500 m
e 8 000 m. Il loro tipo è unknown (cirro per quello alto), la loro dimensione e la loro
densità sono ipotesi di disegno: una rianalisi sa quanta parte di ogni fascia era coperta, non che aspetto
avessero le nuvole. Richiedi il dato dall'editor e gli strati vengono riscritti; modifica
uno strato a mano e la registrazione diventa dell'autore, con la fonte rimossa.