← Observations

Around what was seen

The rest of an observation's file, after what was seen: the witness's movements and what they did, the instrument, the sound, the decor and the vehicles, what happened in the sky, and the weather with its clouds.

Every excerpt below is read-only, and each knows the format: put the caret inside an object and press Ctrl+Space (⌥+I on a Mac) to list every key that could go there, with what the model says of each.

The fields around what was seen

FieldMeaning
observerTrack{ keyframes: [{ t, pose }] } — pose holds lat, lng, elevationM (above the local ground), headingDeg, pitchDeg, rollDeg, fovDeg, and for a camera fNumber and focusDistanceM. Played the way a person moves: exactly the stated pose at each keyframe, and between them a movement that gathers speed, carries it through the keyframes that keep moving, and slows down into a pause — two keyframes with the same place, or the same heading. A look starts and ends still; a walk or drive already under way at the first keyframe carries on. Stopping and setting off on foot add their own jolt, a nod of the head that dies within a second and a half, turned into the image as much as the instrument lets it (an eye hardly, a hand-held camera fully). And a body at rest is never quite still: standing or waiting, the view sways by millimetres and drifts by a tenth of a degree, slowly, the same way at the same instant — except for a witness the account says was paralysed (tag paralysis). The pitchDeg stated is how the witness looked in the frame of what carried them: while they travel, the player adds how the vehicle itself climbs (the grade of the road under the track, read from the relief, uphill positive, or for an aircraft its own climb, faded as the view turns off the way they go), so a climb raises the view and the Tilt chip states the sum. filter is what was held in front of the instrument, a FILTERS id such as solar-visual for an eclipse. It is held between keyframes, not blended (nobody wears half a pair of glasses), and taken off by stating "none". A keyframe stating viewOnly: true sets the view of its instant alone (the editor writes it when the view is turned with Alt held): the camera's turn to it and from it is left out of the picture, and an exposure over it is drawn as if the camera had stood still, pointed as it is at the instant shown. A witness flying at a stated altitude gives it as altitudeM (metres above the sea): the player puts the eye there over whatever relief it draws, elevationM then being only the height over the ground the file was written against, which the decor of a cabin round the eye is stated against too.
eventsWhat the witness did, stated as events with their parameters instead of the poses they imply: [{ type: "event", eventType, t, until, params }], t and until in ms of the recording. The player works the poses out of them when it reads the recording, by the same law for every recording (a turn of the head starts from still and settles, a vehicle's line is a curve), and writes the events alone back as long as nothing has changed those poses; an observerTrack with keyframes of its own wins over them. A parameter takes its provenance like any value. A table of instants (speeds, speedDivisors, heights, metres) has as many rows as the account needs; its value goes from one row to the next gradually, or at once at a row with step: true. On foot: look (a look held from t on, headingDeg, pitchDeg), walk (from from to to, two { lat, lng }, between t and until, as a person walks and stops) and follow (a body of the reading, or a phenomenon going across the sky, target, which the eyes reach reactionS after, lagS behind it, with no keyframes of its own to be looked at but every sampleMs, looked at at each of its keyframes, in the middle of what they see, the look turning between them as a head does; held where it is lost, at until; observer-valensole.json). In a vehicle: drive (the vehicle the witness is in, a decor object named by vehicle, follows path, a list of { lat, lng }, at speeds [{ t, kmh }], possibly divided by speedDivisors [{ t, divisor }], placed by the one place it went through { t, lat, lng }; the driver's eye is { x, y, z } in the vehicle's model), lookAhead (they look down the road and keep the target { lat, lng } within about keepDeg, and glance at it for glanceS, then at the road for roadS, once it is more than glanceBeyondDeg off; pitchShare is how much of its height they look up to), lean (towards the mirror: the eye moves by offsetM over turnS, for holdS) and watch (in the mirror, a point of the vehicle's model: firstS, then mirrorS between looks away, glances at the target of glanceS every other time until glancesUntil, the road for roadS otherwise). Every event says whom it is about in who, by an id of the recording, which nothing else of it has: the witness's (observer.id, or "observer" for a witness without one; an event that says none is theirs), a shape's or a group of shapes', a body's, a decor object's. The editor does not save a recording with an event about nothing, or two things of one id. An event of a decor object: fly (an aircraft along a straight line leading to from { lat, lng }, on headingDeg, at speeds, at.metresBefore that place at at.t, at heights [{ t, altitudeM }] above the witness's eye). A lamp of it (id/lamp, f-hobs/landing-nose), or a group of them that the object's groups name (f-hobs/strobes): light (at intensity from the event's start, 0 off, blinking as it did, and back to what it was at its end when it states one) and blink (on for onS, off for offS, at intensity or what it was, until the event's end, then as before): a landing light put out, strobes switched on, a beacon, the lights on top of a building. The phenomenon's (who the shape it is drawn as, or the group of its shapes) give the account's shapes, as the witness described it: stand (at the place they stated, { lat, lng }, its metres [{ t, widthM, heightM }] its width and its height above the eye, from which its direction and its size in their sky follow at every instant), appearance (how it looked from t on, its parts: shapes placed and sized in shares of its apparent width, sourceId, kind, points, color, brightness, halo, widthShare, heightShare, alongShare, upShare; a part another appearance has and this one has not is not seen), blink (the shapes it is about, a group of the phenomenon's or one of them, on for onS, off for offS, taking off while off) and vanish (no longer seen). Or, with no place, going across the sky, an account of directions only: travel (from a direction { azimuthDeg, altitudeDeg } towards another, along the great circle between them, at speeds [{ t, degPerS }], from still between two; sizeDeg wide at the zenith, smaller as the sine of its altitude when sizeBy is "altitude"; its parts laid along its way on the witness's picture, alongShare ahead or behind, upShare to its left, turned with it), turn (by byDeg to its side, "left" or "right", from still and settling; the other side on the sky when seenFrom is "craft", as a pilot says it), roll (banked to toDeg, and back level when andBack, narrower across its way by the cosine of it), vibrate (from side to side hz times a second, by amplitudeShare of its size, from nothing over riseS, then less and less to the event's end) and spiral (turns round a circle beside its way, clockwise or not, radiusDeg wide once open, narrower by shrink by its end, rolling rollDeg as it does); observer-saint-lo.json. A body of the reading's (who its id; or, about one part of its model, a node or a bone of it, id/part: craft/legs, etre-2/head, which spin and turn turn alone about its own upright axis, clockwise seen from its top, the rest of the body as it is; a light of it, by its name in the model, engin/front-red, or a group of its parts that the body's groups name, engin/rear; the model's file says which parts it has) add to the keyframes it states: motion (one of its model's movements played once, motion to to, the central tube drawn in), spin (one kept turning, turnsPerS, the legs), rise (distanceM along a straight line angleDeg off the vertical, 0 straight up, towards headingDeg, from still, slowing into its stop or, stops: false, faster and faster as it leaves), turn (to face headingDeg), ride (carried by the body in, aboveM higher), light (a light, or a group of them, lit at cdM2 from the event's start, 0 switched off, and lit again as it was at its end when it states one) and blink (one blinking, on for onS, off for offS, lit at cdM2 while on or at what it was lit at before, until the event's end, then lit as before; at once, never a fade: an aircraft's strobes, a beacon, the light on top of a mast) and vanish; a posture is a movement of the model too (motion on crouch, which a figure exported with its postures carries: 0 standing, 1 crouched); observer-valensole.json's craft and beings. observer-silly-le-long.json states its witness, its aircraft and its phenomenon this way
sampleMsHow often a keyframe is taken, ms: by the editor's recorder as a shape is moved by hand, and where the events are worked out into values (the account's shapes, the look that follows them, a body that rises), all at that same pace, so that what is drawn and the look it is drawn for never fall apart. Of what that gives, keyframes that say the same thing are kept as the first and the last of them: the player draws the same between them. Absent, each keeps its own: 25 ms for a phenomenon going across the sky and the look that follows it, 2 s for one that stands, 250 ms for a body that rises
weatherTrack{ keyframes: [{ t, weather }] } — the sky's conditions along the recording: precipitation, wind, storm, and the clouds as layers with real heights, each able to hold individual clouds placed in metres. Every field of a weather is in the next section
weatherSource{ id, name, url } of the record the weather was looked up from. Its presence means the recording is replayed exactly as authored and never looked up again. Absent means the witness's own account
lightPollutionHow bright the night sky of the place is, towns and all: the zenith of a moonless night in magnitudes per square arcsecond, as a Sky Quality Meter reads it or as the World Atlas of the artificial night sky brightness gives it (its “SQM” figure, Falchi et al. 2016, which lightpollutionmap.info shows for any place). 22 is a natural sky, a suburb about 19, a city centre 17. Absent means a natural sky. The towns' share, what is left once the natural 22 is taken out, is added to the sky as light: brighter toward the horizon, where the low air scatters more of it back, and drawn in the warm white of a 3000 K lamp. It drowns the Milky Way and the zodiacal light, and takes stars away, by the difference in the faintest star an eye can pick out (Crumey 2014): about two magnitudes at 19. The Moon now does the same. "derived" when looked up in the atlas, "stated" when the witness measured it. The editor fills it in from the atlas for an observation from 2015 on, as "derived" with the atlas named, and never replaces a figure typed by hand; before 2015 it asks nothing, the sky having been darker than the atlas's
observerMapWhether the map of where the witness stood starts open when the recording is played or edited: true or false. Absent says nothing, and the player decides: open for a witness who went somewhere, closed for one who stayed put. A page embedding the player has the last word (its show-observer-map attribute). The editor writes it when the map is opened or closed there, so that a reader is shown what the author left
snapshotsWhere the data the scene would otherwise ask third parties for at every play is kept, in files beside the recording (annexes), so that a finished recording plays the same way in ten years without asking anybody: relief (the ground's height, as the elevation source answered for each patch of ground the scene builds, a zip), imagery (the photograph of the ground, as the tiles the imagery source served, a zip), roads, water, railways (the ways, rivers and tracks of each patch, JSON), upperAir (the air at the levels of the aircraft, JSON) and map (the photograph under the witness map, as the tiles the imagery source served for the ground the map is fitted to, a zip: a map taken as a snapshot shows that photograph and asks for no other, larger when zoomed into, blank beyond it when zoomed out). Each is { src, takenOn, attribution }, src read relative to the recording's own address, or a data: URL for an annex kept inside the recording itself. A group read from its annex asks nobody for anything; a group without one is asked for live, as everything was before. "live": true on a group asks it live at every play and never takes a snapshot of it (what picking its live source rather than File says), and on snapshots itself every group; "refresh": true on one group asks it live once, and the editor takes it again at the next save. The editor takes what is missing when the recording is saved, and saves the recording and its annexes as one zip to unpack where it is published. weather, place, lightPollution and decor say the weather (weatherTrack, weatherSource), the place's name, the night sky's figure and the scenery are read from the file rather than asked again by the editor (of the weather record as the date or the place change, of the geocoder, the atlas and the survey as the witness moves): {} for those kept inside the recording, { src } for an annex holding their keys, which the players put back in the recording as they load it. Absent, they are inside the recording and the editor asks again. The time zone is not here: it is written in the recording itself
modulesThe modules the recording needs to be drawn as it was made (a catalogue its models come from), by the address of each one's manifest, relative to the recording or absolute: see modules. A reader gets what each manifest states, never its script unless they added that module themselves. Absent, it needs none
soundTrack{ keyframes: [{ t, sound }] } — kind (none/hum/whistle/rumble/crackle), volume, pitchHz, optional src of a real recording. volume and pitchHz glide between keyframes, kind and src change at the keyframe. A src on another site must be served to any origin (CORS)
referencesPictures of the place laid over the scene: src (an address, or a data: URL for a picture added from a disk), kind (photo/panorama/video), registration (headingDeg, pitchDeg, rollDeg, fovDeg), opacity, credit/creditUrl, optional t and drawing, from ({ lat, lng }, where it was taken: the player fades it out as the witness walks away from that point; absent, it is never faded), and the landmarks it was lined up on (id, label, picture as { u, v } from the top-left corner, scene as { azimuthDeg, altitudeDeg }). A video also states t, where its stretch starts on the timeline, video (fromS, toS, rate: which part of the file, how fast), and registrationTrack, where its camera pointed at each instant it was lined up at.
tracesWhat an investigator drew over the place, imported from their Google Earth file (KML, KMZ) or their GIS's GeoJSON and drawn over the scene as theirs, never as part of the reconstruction: [{ id, title, kind, points, altitude, color, source }], kind being point, line or polygon, points the vertices as [{ lat, lng, altM }] exactly as the file held them, altitude how altM is read (ground, the default, relative to the ground under each point, or absolute above sea level), color a #rrggbb and source whose it is
instrument, exposureSecondsWhat it was observed through, and how long the shutter was open. Absent means the naked eye. instrument is one of eye, rectilinear-lens (a camera of unknown make), roamer-1-120, instamatic-126, slr-35mm-50, slr-35mm-zoom, phone-landscape, phone-portrait, or a digital SLR (eos-5d-iii, nikon-d7000… the sensors of Stellarium's catalogue), binoculars (binoculars-nikon-10x42-edg…) or a telescope (telescope-celestron-c8…); exposureSeconds is one value for the whole recording, held to that device's own range. A device that records a picture (a camera, a phone) lays its lens ghosts over every light of it, as glass and a sensor do: a fainter, out-of-focus copy on the line through the centre of the picture, mirrored through it for a phone's main one, the red disc across the frame from a traffic light. A phone exposes itself from what it sees, up to ISO 3200: a night it films stays dark round its lamps
lensWhat the picture was taken through besides the lens, and what was on that glass, for a device that records one: glass (filter, window or windscreen: a filter adds a ghost mirrored through the centre, a pane a fainter twin of every light just aside of it, further off for a windscreen leaning back), drops, condensation and dirt (0 to 1, each scattering a halo round every light, which loses what the halo takes) and sheltered. When drops is absent, they follow the rain or snow falling at each instant, unless sheltered is true: new ones land as often as the rain meets the glass squarely (a lens looking up, a pane facing the wind, a windscreen leaning back catch more), merge with their neighbours; the small ones cling for minutes, the large ones run down after a few seconds, leaving a trail of beads and wiping what they cross, and go on doing so once the rain has stopped. The ghosts of the lens itself follow its aperture: wider for a lens opened up, and the polygon of its blades once stopped down. ghosts states the ghosts of an optic set before the lens, which no catalogue holds (a periscope's mirror and prisms), each as a lens's are: scale, share, blur, offset, tint; reachDeg how far beyond the frame's corner a light still strikes its front glass (30° for a lens); placedDrops drops stated one by one instead of those drops scatters at random, each a radius (share of the picture's height) and a track of {t, x, y} (ms, shares of the picture's width and height from its top left), held at its ends; drops then only says how much light they scatter
lightingWhat the picture shows of the light it was taken in, when that says where the Sun was (a side lit, a side in shade): sunFromViewDeg, the arc of the Sun's bearing clockwise from the way the instrument looked at the start ({ fromDeg: 105, toDeg: 285 }: behind it, on either side), and sunAltitudeDeg ({ minDeg, maxDeg }), its least and greatest height. It binds a reading of the observation: the date, the hour, the place and the heading it states may move within what is known of each, but the Sun they put together has to light the scene as the picture shows it, so moving the place moves the hours it allows, and the other way round
isoThe speed of the film or sensor the picture was taken on, when it is known: 400 for a 400 ISO film. Absent means the device's own (an SLR's colour negative is 100, an Instamatic's 64). A camera's picture is not answered like an eye's: a film does not adapt to the sky, it receives an exposure — the light, times the shutter, over the square of the f-number — and answers it with its own curve (a negative's soft one, a slide's steeper one, a sensor's straight line that stops at white). So a night pose comes out with a black sky and whatever was bright on it standing out. Stated for a device that sets its own exposure (a phone), it is that device set by hand, as in its manual mode
filmThe film the picture was taken on, when it is known, as an id of the catalogue: "kodachrome-64". It gives the speed, unless iso says otherwise, and how the picture answers light, black and white included. Absent means nobody says.
meteringHow a device that sets its own exposure read the light, when it is known: "average", the mean of its whole frame, as camcorders and older phones did, which burns a bright light in a dark frame out to white; or "highlights", as recent phones do, held back so that a light taking up a fair part of the frame keeps its colour (a lantern twenty metres off comes out orange, white only by its flame), the rest of the night then darker. Absent means the device's own (a phone keeps its highlights)
swayHow much the body holding the instrument moves the view when not walking: 1 for a person standing or sitting, 0 for a camera on a tripod, anything between or above for less or more. Absent means 1 — except for a witness the account says was paralysed (tag paralysis), for whom it is 0, and for an exposure longer than half a second, which no hand holds still: that is a tripod, and 0 too
vehicleThe vehicle the witness was in, when the decor does not draw it: { kind, windowsOpen, noise }, kind being a road vehicle (car, van, truck, motorcycle, generic) or an aircraft, by its class as the sky's own aircraft are named (business-jet, airliner-narrow, helicopter-light…): one field for both, the two vocabularies having no word in common. Heard from inside: its engine follows the witness's own journey — the gear from the speed, the revs from the gear, the effort from speeding up or slowing down — with the road and the wind, muffled by a closed cabin, let in by open windows. An aircraft has neither gears nor cylinders: what is heard of it is the steady roar of its cabin, at what a passenger measures in that class of machine. noise is its loudness against an ordinary one of its kind (1 by default). Whatever the witness rides also stands between them and everything outside it, and takes more from the highs than from the lows: an aircraft a hundred metres off is a rumble through a fuselage, and under the cabin's own roar it is not heard at all; the rain and the wind come in muffled the same way. windowsOpen lets almost all of it back in. It is also what keeps the player's sound button active when the file has no soundTrack: the button answers for everything the scene plays — this engine, an engine in the decor, an aircraft of the decor in flight, a body of a reading that is heard, rain and wind — not only for the track. Its lights: headlights is a setting as for a decor vehicle (off, position, dipped, main, fog) or auto, the default: the dipped beam from the dusk on and nothing by day, which is what a driver does. headlightKeyframes is [{ t, mode }] for a change during the recording. The beam lights the road ahead of the witness, in the direction the vehicle goes.
decorScenery at a real eastM/northM from the witness: buildings (with floors, windows), trees, shrubs, streetlights, vehicles, bridges, overhead lines, other witnesses, aircraft — optionally with a track and lights whose pattern carries a real flash rate. See below

A decor object is stated in metres, like everything that is not the phenomenon:

FieldMeaning
eastM, northM, headingDegWhere it stands from the witness, and which way its front faces, clockwise from true north
sizeM{ widthM, lengthM, heightM } along its own axes, length being the way it faces. Each axis is optional: one nobody measured keeps the built-in shape's own proportion
modelA real 3D model standing in for the built-in shape: a catalogue entry by id, or a glTF/GLB file at url (which wins, must be readable from any origin, and then needs its credit; a relative one is read from the file that states it). It never decides the size: it is scaled, keeping its proportions, to the first measured axis among length, height and width, or to the real size the catalogue gives it. Seen from inside, and whenever the model cannot be had, the built-in shape is drawn instead. An observer or an entity that names none is never drawn as a built-in shape: it is one of the catalogue's realistic people, picked by its id (a child, or a being a statement describes, names its own model). headingOffsetDeg turns the loaded model about its vertical axis so that its nose points the way the scene expects (0 faces north at a heading of 0); a catalogue entry brings its own. credit is { title, author, license, sourceUrl }: license as its author states it ("CC BY 4.0") and sourceUrl where it came from, so that the claim can be checked.
bridgeFor a "bridge": how it is built. sizeM.lengthM is its whole length along the road, embankments included, widthM the deck's width and heightM the height of the road on the deck above the ground; spanM is the open span under the deck, the road running on a bank of earth sloping down to the ground on each side of it; deckThicknessM the slab's thickness (1.2 by default); railing { heightM, postSpacingM, rails } the railing along both edges, posts and rails whose openings are rectangles (1.05 m, 1.5 m and 2 rails by default). Drawn at those measurements, never stretched
wireFor a "wire" (an electric or telephone line): sizeM.lengthM is the span between its poles, along its headingDeg, and heightM the height of the lowest strand; strands [{ heightM, acrossM }] hangs several (stacked ones share an acrossM, a crossarm's differ); poles is both (default), start or end (the end its heading points away from or towards: the other is anchored on a building) or none; diameterM (8 mm by default) and poleHeightM (half a metre over the highest strand). Straight, without sag, and drawn at those measurements, never stretched
track[{ t, eastM, northM, altitudeM, headingDeg }] when it moves, altitudeM above the ground under it (the eye is at elevationM + 1.6 m, so a body at the eye's level has an altitudeM of that). Position blends between keyframes; the heading is held from one to the next
lightsIts lamps: id, offsetM { x, y, z } from its centre (right, up, front), color, intensity (1 is an ordinary navigation light) and a pattern: { "kind": "steady" }, or { "kind": "flash", perMinute, dutyCycle, phase }, the rate as regulations state it, the lit fraction of each cycle (about 0.5 for a filament flasher, 0.01 for a strobe) and an offset from 0 to 1 between lamps. The editor fills them from presets: airliner, helicopter, car headlights, car hazard flashers, emergency beacons, streetlamp. How it is switched during the recording, from each instant on, keyframes [{ t, intensity, pattern }]: what the events light and blink about it give
groupsIts lamps taken together, so that one event is about them all: { id, title, members }, its members lamps of it or other groups of its. Named in an event as a lamp is, id/group: an aircraft's two strobes, f-hobs/strobes. Optional
engineA vehicle heard running: { kind, noise }, as vehicle above. Its engine follows its own track, heard from where the witness stands, fainter and duller with distance
aircraftSoundAn aircraft (kind aircraft) heard while it flies, which it does when its track leaves the ground: the sort of noise it makes, an aircraft kind (airliner-narrow by default, airliner-wide, regional-jet, helicopter-light, light-piston…) or silent for one that makes none. What its model says applies when this is absent (the stand-ins for a phenomenon are silent). It is heard like the aircraft of a record of air traffic: fainter and duller with distance, late by the time sound takes to come (about three seconds per kilometre) so that it is heard where it was, higher in pitch as it comes and lower as it leaves, and masked by the noise of the place
occludesSourceIdsThe phenomena the witness said it stood in front of: see the rules on the format page
facadeKind building only: { color?, plain? }. color is the wall, "#rrggbb"; unless plain is true, windows are drawn on every floor and a door on the ground floor of the front face. Drawn at the stated sizeM (all three sides must be stated), never stretched, and not for a building with a witness inside. The editor takes the colour from the material the map states for the walls (stone, brick, concrete, breeze block, wood), or a plaster where it states none. Absent is the plain box.
roofKind building only: { shape, riseM, color?, ridge? }. shape is "flat" (the box), "gable" (two slopes to a ridge along the longer side, or along the depth with ridge: "depth") or "hip" (four slopes); riseM is how far the ridge stands above the eaves, so the walls are sizeM.heightM less that; color is the roof seen from above, "#rrggbb". The editor reads them off the laser and the aerial photograph of the survey. Absent is a flat roof the colour of the walls.
originThe survey this object was taken from, by the id of its provider ("ign-lidar-topo"), when the editor took it from the survey of the place and the author did not place it by hand: a tree, a building, a bridge or a span of line. Choosing another survey, or none, or another place replaces or removes what carries an origin, and never what does not
surveyedOnThe day (YYYY-MM-DD) of the newest survey this object was drawn from, where it comes from one (see origin): the editor warns when it is later than the observation.
lit, litKeyframesWhether a streetlight's lamp or a vehicle's headlights are on. litKeyframes is [{ t, lit }], sorted by t, for one that is switched on or off during the recording; without it lit holds throughout. Ignored for a building, a tree or a witness
headlights, headlightKeyframesHow a vehicle's lights are set, since not everybody puts them on, nor as they should: off, position (the position lights, which show the vehicle and light nothing), dipped (the dipped beam), main (the main beam: far, narrow, dazzling) or fog (the fog lamps: low and wide). A beam lights the road, the verges, the trees and the walls in front of the vehicle, whatever the vehicle is drawn as. headlightKeyframes is [{ t, mode }], sorted by t, for a setting that changes during the recording. Without either, lit says it: lit is the dipped beam. Ignored for anything but a vehicle. Only four vehicles (the witness's own, then the nearest of the decor) have a real beam. The witness's own lamps cast shadows (a bank, a post or a bridge pier keeps the light from what is behind it), and the beam shows in the air in proportion to what the air scatters of it: a faint trace in clear air, a cone of light in fog
observerSide, observerFacing, observerKeyframes, occupiedFloorThe witness inside the object, for a building or a vehicle (at most one object holds them). observerSide is where they are: front, behind, left, right, front-left, front-right, behind-left or behind-right, a vehicle's occupant being at one of its four doors. observerFacing is the window they look through when it is not their seat's: a driver sits at front-left and looks through the windshield, front. observerKeyframes, [{ t, side, facing }], says where they sit over time, each held until the next, and a keyframe without side means outside from then on, as a driver who gets out. occupiedFloor is the floor of a building they are on, 0 (ground floor) up to floors
modelParametersThe settings of the model the object is drawn as, by the key the catalogue entry publishes each under: { "costumeColor": "#5a6b3a" } for the clothes of a person, foliageColor for a tree, hullColor for a craft, gearUp for an airliner in flight. A model brings its own (the editor draws a field for each of them); an object drawn as a built-in shape has none, it is painted by color
sightingUrlFor an observer: the address of that witness's own recording, when it is known, so that the scene's menu can offer to view their account

Events of the sky#

What happened in the sky while the recording runs, as facts: a laser shot, a rocket launch, a re-entry. Each was there whether anybody saw it or not, so it is neither part of the reading of the account nor decor, which outlasts the observation (a house, a tree). They are stated under skyEvents, at the top of the recording; a recording that put them in its interpretation, as earlier versions did, is still read.

{
  "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
    }]
  }
}
FieldMeaning
reentriesThe atmospheric re-entries that happened, a satellite or rocket stage breaking up into burning pieces. Not bodies: a re-entry burns 70 to 100 km up and is seen from hundreds of kilometres, so it is placed on the Earth and seen through its curvature from wherever the witness stood. Its track gives the leading point at instants of the recording, { t, lat, lng, altitudeKm }, joined by great circles; each of its fragments follows the same path lagS seconds behind, is seen from fromT until it burns out at untilT, shines with its absoluteMagnitude (at 100 km, as for a fireball) moved to its real distance, in its color, with a tail of the last trainS seconds of its path (4 when absent: a re-entry's tail is long). Each piece comes apart as burning pieces do (sheds): a slow crumbling into faint fragments, each with its own streak, dropping back, drifting and sinking into a narrow fan, and a burst of some thirty at each flare of its lightCurve, a flare being a fragmentation (Zander & Löhle, CEAS Space Journal 2025). A list of phases states it instead, { fromT, untilT, perS, lifeS, magnitudeDrop, dropBack, spreadKmS, sinkKmS, trainS }, and an empty list a piece that sheds nothing. A flare brighter than magnitude −12 below 50 km is heard as a detonation, after the time sound takes to cover the distance (Chelyabinsk: two and a half minutes). Its light is its own: it shows whether or not the Sun reaches it. object names what came down (name, cosparId, norad). Nothing is propagated from orbital elements, which are off by minutes in the last orbit: the path is what the sources establish, with its provenance
launchesThe rocket launches that happened, lit by a Sun that has set for the ground but not for the plume, the "space jellyfish". Placed on the Earth like a re-entry: its track gives the stage at instants of the recording, { t, lat, lng, altitudeKm } (it may begin before the recording does), and burnFromT and burnUntilT the seconds the engine burned. The plume is a string of puffs let go along that path, each spreading with age; what shows of each is the sunlight it scatters towards the witness. The Earth's shadow (where the Sun is lit or not at the puff's height, and how much air its light grazed, which reddens or blues it), the scattering angle and the spreading are computed from the real Sun at the real date, so nothing is stated of them. An optional plume overrides the defaults: exhaustKgPerS (273, a Merlin Vacuum), condensedShare (0.065, the one number nobody has measured), particleRadiusUm, expansionKmPerS, initialRadiusKm, lifetimeS, and for the collar (exhaust just let go, wide and soon gone, beside the narrow trail that stays) collarShare (0.85), collarExpansionKmPerS (2.5), collarLifetimeS (20). vehicle names what flew and, in engine, the engine whose exhaust it is: thrustKN and specificImpulseS (from which the exhaust per second and its velocity follow, hence how wide the collar spreads) and propellant (rp1-lox, methane-lox, hydrogen-lox, hypergolic or solid, which says how much of it turns into particles and how big). What plume states beats what the engine implies. The plume needs the recording's date: without one there is no Sun to light it. vehicle.mission names the mission it flew ("Starlink Group 10-49"). Each puff flies on its own once let go, at the stage's velocity plus the one it was thrown at, pulled by the Earth and stopped by the air only where the air is thick enough to flow round it (below 200 to 300 km), so the plume is the same thing in space from every side: a trail seen end on is a disc, a spiral seen edge on a line. Its colour is the size of its particles': coarse ice scatters white, ice finer than the wavelength blue. jets lists what else the stage lets go, each { kind, fromT, untilT, angleDeg, azimuthDeg, spinPeriodS, speedKmPerS, massKgPerS, condensedShare, particleRadiusUm, expansionKmPerS, initialRadiusKm, lifetimeS }: kind burn (another burn of the engine, its values those of the plume, a deorbit burn being angleDeg 180, the exhaust leaving ahead of the stage) or vent (propellant let out of the tanks, slower, finer and colder: 0.7 km/s, 20 kg/s, half of it freezing, by default); angleDeg from straight back along the motion (0) through sideways (90); azimuthDeg the side it leaves on round the motion (0 away from the Earth); spinPeriodS the stage's turn round its motion, which turns the jet with it and makes vented propellant draw a spiral. When there are jets, the ascent's burn is drawn only if burnFromT or burnUntilT is stated.
beamsBeams of light sent through the air from the ground, a laser shot or a searchlight. Each has a path of at least two points { lat, lng, altitudeM } (altitudes above the sea): where it leaves the emitter, where a mirror turns it if one does, and where it ends. Between two points it is a straight line through space, not along the ground, which falls away under it. wavelengthNm is its colour (532 for a green laser), powerW its mean optical power, divergenceMrad how fast it widens (0.1 when absent) and apertureM how wide it leaves (0.01 m when absent); fromT and untilT say when it is on. Nothing of its brightness is stated: what is seen of each metre of it is what the air there (molecules and haze, at its wavelength) scatters of the power left in it towards the eye, at the angle it has to turn, so it is far brighter looking up it than looking along it. It is hidden by what stands in front of it and stops where it meets the ground.

The weather, and its clouds#

A weather keyframe states the sky's conditions at one moment of the recording's clock; between two keyframes every number is blended, and precipitation type and storm are held. It carries:

FieldMeaning
cloudLayersThe clouds, as a list of layers — see below. Absent means the older fields on this row's neighbours describe them, and they are adapted into one water layer and one cirrus veil; an empty list means a clear sky somebody looked at
cloudCover, lowerCloudCover, highCloudCoverFractions of sky (0–1): the total, the water decks alone, and the icy veil alone. Written by recordings made before there were layers, and still kept in step by the editor as a summary of them
cloudBaseM, cloudDarknessThe same era's one base, in metres above the reference ground, and one shade (0 white, 1 very dark)
iceCrystalAlignment0–1, how steadily the ice crystals fell — what turns a bare ring into sundogs, arcs and a pillar. No record measures it; a cirrus layer carries its own
rareIceCrystals0–1, the share of a cirrus deck's crystals that are the rare kinds: pyramid-ended columns (the odd-radius haloes at 9°, 20° and 35°) and plates free to turn about a level axis (Lowitz's arcs). Absent means 5%, an ordinary deck. Like the alignment, no record counts them, so it is stated. The simulation behind it was checked against Atmospheric Optics
relativeHumidity0–1, near the ground. It decides how milky the clear sky is: haze swells with water as the air nears saturation. A looked-up record carries it (from ERA5's temperature and dew point); absent means a typical haze
visibilityKmThe meteorological visibility near the ground, in kilometres, as a weather report states it. It is the haze itself: stated, it decides how much there is, for the distance as for the sky, and the humidity is no longer read for it Past 30 km, it is also how far the relief is drawn (up to 150 km), curving away under the line of sight: a mountain that clear air shows far off is there.
precipitationType, precipitationIntensitynone/rain/snow/hail, and 0–1. Stated at a keyframe, played the way it falls: a shower begins at the keyframe that starts it with its first drops, and reaches the stated rate no faster than real rain does (nothing to heaviest in twenty seconds); it stops the same way. A change the keyframes spread over longer is followed exactly. precipitationAmount (0–1, absent meaning all of it) says how much of that precipitation is falling yet.
windDirectionDeg, windSpeedThe general wind: the bearing it blows TOWARD, clockwise from north, and metres per second. It is what carries the clouds — from time zero, so seeking and replaying give the same sky
stormLightning and thunder, at the right delay

Each layer of cloudLayers is a deck of clouds at a real height, and stays itself from one keyframe to the next:

FieldMeaning
idStable across keyframes — layers are matched by it, never by position in the list. A layer present in one keyframe and absent from the next fades out; reordering them changes nothing
typecumulus, stratus, stratocumulus, cirrus or unknown. It decides the shape of the tops and how thin the veil is; a cirrus is also the one that refracts haloes. It switches at the keyframe, it is not blended
baseM, thicknessMMetres. The base is above the recording's REFERENCE ground, not above a witness who climbs; a witness above the base is inside or over the deck, and the sky is drawn accordingly
coverage0–1, and it means what it says: the fraction of the sky this layer covers, whatever the size of its clouds
sizeMThe characteristic width of one cloud, in metres. Separate from coverage: the same fraction of sky can be many small clouds or a few large ones
density0–2, how opaque the cloud matter is; 0 is transparent. Separate from coverage too
darkness0 white to 1 very dark. Absent means the keyframe's cloudDarkness
seedWhich pattern, out of the endless ones the same numbers can draw. Absent means one derived from the id, which is why the id must not change
windDirectionDeg, windSpeedThis layer's own wind, when it differs from the general one — the high deck usually does. Absent means the general wind
iceCrystalAlignmentFor a cirrus only
instancesIndividual clouds inside this layer — see below

An individual cloud in instances is one cloud of its layer that the file places exactly, because the account did: the one the phenomenon went behind, the one that was there and nowhere else. It is drawn as one of its layer's own — the same texture, the same threshold — told apart from its neighbours by nothing but where it stands and how big it is, and it stands even when the layer's coverage is nought. It rides the layer's wind like the rest, and it hides a phenomenon it passes in front of.

FieldMeaning
idStable across keyframes, same rule as a layer's
eastM, northMWhere its centre was at time zero, in metres from the witness's starting point. The wind carries it from there
baseM, thicknessMIts own base and height, metres — a cloud can sit lower or stand taller than its deck
widthM, depthM, rotationDegIts footprint, metres, and the bearing that footprint is turned to
density, darknessIts own; darkness absent means the layer's
{
  "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
  }
}

A recording whose weather was looked up (it has a weatherSource) holds the record's answer, not a link to it: ERA5 gives the low, middle and high bands as three layers named record-low, record-mid and record-high, the low base estimated from the spread between temperature and dew point, the other two at 3 500 m and 8 000 m. Their type is unknown (cirrus for the high one), their size and density are drawing assumptions: a reanalysis knows how much of each band was covered, not what the clouds looked like. Ask the record again from the editor and the layers are rewritten; edit a layer by hand and the recording becomes the author's, the source dropped.