Créer une observation

1. Dans l'éditeur#

La voie ordinaire, et celle à prendre sauf raison contraire. Dessinez ce qui a été vu, dites quand et où, enregistrez le mouvement — et le ciel, la météo et le sol sont relevés pour vous plutôt que remémorés.

Ouvrir l'éditeur Lire le manuel

Cela se termine par Exporter, qui vous remet un fichier. Ce fichier est l'enregistrement complet : il n'y a pas de compte, et rien n'est conservé ici. Posez-le quelque part avec une adresse publique et il est prêt à partager.

Vous en avez déjà un et voulez le modifier ? L'éditeur s'ouvre sur un enregistrement existant — le panneau ? de toute reconstitution publiée porte le lien qui le fait.

2. À la main, ou depuis vos propres archives#

Un enregistrement est un fichier de forme documentée : rien ne vous empêche d'en écrire un dans un éditeur de texte, ni d'en engendrer mille depuis une base que vous avez déjà. Tout ce qui suit est ce que l'éditeur lui-même écrit.

Un enregistrement est un simple fichier JSON. Rien dedans n'est un blob binaire, un identifiant dans une base de données, ni une référence à ce site — vous pouvez en écrire un à la main, en engendrer depuis vos propres archives, ou en comparer deux dans une relecture de code.

L'observation#

Ce qui a été vu#

timeline.keyframes est une liste de { t, shapes }, t en millisecondes depuis le début. Chaque forme porte un sourceId — plusieurs formes peuvent partager une chronologie (le phénomène, une flamme qui traîne, une seconde lumière) — et une shape :

{
  "kind": "oval",          // ou "polygon", qui prend alors aussi "points"
  "bounds": { "x": 0, "y": 0, "width": 0, "height": 0 },
  "color": "#39ff14",      // n'importe quelle couleur CSS
  "angle": 0,              // radians
  "transparency": 0,       // 0 opaque .. 1 invisible
  "haloScale": 1.5,        // 0 = aucune lueur
  "brightness": 0,         // l'éblouissement : un voile, les aigrettes du diaphragme, un cœur saturé au blanc
  "blur": 0,               // à quel point le témoin a dit les contours indistincts
  "selected": false,
  "title": "le phénomène",
  "behindCloud": false,    // ÉNONCÉ par le témoin, jamais déduit
  "angular": { "widthDeg": 1.2, "heightDeg": 0.4 }
}

C'est angular qui fait foi. bounds est cet angle projeté sur le canevas fixe de 640×360 au champ de la pose et à travers l'instrument de l'enregistrement ; il est redérivé au chargement, si bien qu'un fichier survit à un changement de canevas, de champ ou d'instrument. Si les deux divergent, c'est l'angle qui gagne.

timeline.order est l'ordre de tracé de l'arrière vers l'avant, timeline.groups les identifiants groupés. Les deux sont facultatifs.

Tout ce qu'il y a autour#

Un fichier entier#

Le plus petit enregistrement qui énonce encore quelque chose — un ovale silencieux traversant le ciel en douze secondes, à une date réelle et en un lieu réel. Tout le reste du format est facultatif, et tout ce qui suit sert à quelque chose :

{
  "version": 1,
  "description": "The smallest recording that still states something: one silent orange oval, a degree and a half wide, crossing the south-western sky from left to right over twelve seconds.",
  "time": { "year": 2024, "month": 8, "day": 12, "hour": 22, "minute": 30 },
  "durationSeconds": 12,
  "utcOffsetHours": 2,
  "place": [{ "lat": 45.19, "lng": 5.72, "name": "Grenoble, Isère, France" }],
  "timeline": {
    "keyframes": [
      {
        "t": 0,
        "shapes": [
          {
            "sourceId": "ufo-1",
            "shape": {
              "kind": "oval",
              "bounds": { "x": 150, "y": 150, "width": 10, "height": 3 },
              "angular": { "widthDeg": 1.6, "heightDeg": 0.5 },
              "color": "#ff8c1a",
              "angle": 0,
              "transparency": 0,
              "haloScale": 1.2,
              "selected": false
            }
          }
        ]
      },
      {
        "t": 12000,
        "shapes": [
          {
            "sourceId": "ufo-1",
            "shape": {
              "kind": "oval",
              "bounds": { "x": 480, "y": 130, "width": 10, "height": 3 },
              "angular": { "widthDeg": 1.6, "heightDeg": 0.5 },
              "color": "#ff8c1a",
              "angle": 0,
              "transparency": 0,
              "haloScale": 1.2,
              "selected": false
            }
          }
        ]
      }
    ]
  },
  "witnessTrack": {
    "keyframes": [
      {
        "t": 0,
        "pose": { "lat": 45.19, "lng": 5.72, "elevationM": 0, "headingDeg": 215, "pitchDeg": 20, "fovDeg": 60 }
      }
    ]
  },
  "soundTrack": { "keyframes": [{ "t": 0, "sound": { "kind": "none", "volume": 0, "pitchHz": 100 } }] }
}

À vous d'y taper : il complète sur chaque clé du format, propose les mots que chacune accepte, et dit ce que le modèle en dit. Rien n'est enregistré ni joué ici — pour en voir une tourner, le lecteur prend un fichier.

C'est /demo-data/example-minimal.json sur ce site : vous pouvez le récupérer, et le jouer avant d'y toucher. Remarquez que angular et bounds y figurent tous deux : l'angle est ce que le fichier SIGNIFIE, et les pixels en sont redérivés au chargement — écrivez l'angle, et laissez corriger une mauvaise estimation des pixels.

De plus gros, à lire#

Chaque démo de ce site est un simple fichier que vous pouvez ouvrir. Ces quatre-là valent la lecture pour voir comment un vrai enregistrement est bâti :

Quatre règles qui décident du sens d'un fichier#

• Les champs discrets sont tenus, les continus sont interpolés. Une forme absente d'un keyframe ultérieur reste dans son état ; une forme dont le premier keyframe est à cinq secondes est déjà peinte, dans cet état, dès zéro. Pour qu'une chose cesse d'être visible, posez-lui un keyframe à transparency: 1.
• Des angles, rien d'autre. Aucune taille ni distance réelle n'est stockée où que ce soit. Les mètres sont déduits, en inégalités, de ce que le phénomène a été déclaré passer derrière ou devant (decor[].occludesSourceIds).
• L'énoncé l'emporte sur le déduit. behindCloud et occludesSourceIds sont des affirmations du témoin. Rien dans ce format ne peut les déduire : il décrit une apparence dans un champ de vision, pas une position dans l'espace.
• Absent n'est pas zéro. Pas de piste sonore signifie que personne n'a posé la question ; kind: "none" signifie que le témoin a déclaré n'avoir rien entendu. La même distinction traverse la météo et les nuages de glace.

Le README porte la référence complète, champ par champ, avec le raisonnement derrière chaque choix ; c'est lui qui fait foi si cette page et lui venaient à diverger.