← Documentation

Create a reading

A reading is an alternative explanation of what was seen (a kite, a planet, an aircraft), written as an observation of its own and replayed beside the witness's.

In the case editor#

The dialog of the + button: the observation the new one is an interpretation of is chosen.
The dialog of the + button: the observation the new one is an interpretation of is chosen.

In the case editor, a reading is added with the + button, as an observation that names the one it reads.

  1. Open the case, or add the witness's observation to a new one. The reading needs a primary observation to be a reading of.
  2. Press + and choose the type Reading. In Reading of, choose the primary observation: that is what makes it a reading and not another witness. It is dated today.
  3. In Source, choose where it starts: A blank recording, or An existing recording (a file from your disk or an address). Give it a Title of the reading (“A kite”) and its Investigator, then press OK.
  4. It opens in the observation editor. Describe what the alternative would have looked like: the bodies it is made of (the Bodies group), and which shapes of the witness's account each one explains. The player then shows the two side by side.
  5. Save the case. The primary observation cannot be deleted while a reading refers to it: delete the readings first.

By hand#

In case.json, a reading is an event of type sighting that names, in interpretationOf, the id of the observation it reads (or several), and has a url of its own:

{
  "events": [
    { "type": "event", "eventType": "sighting", "id": "kite", "interpretationOf": "qb",
      "title": "A kite", "url": "reading-kite.json" }
  ]
}

Its recording is written like any observation, with bodies that say which shapes they explain.

To go on#

What a case is, how events are linked, and how a reading is written, field by field.