/

Ambitwin · source-available, not open source · © 2026 Nicolò Ghignatti

Telemetry Distribution

Keywords on this page
WordMeaningExample
Building StatusThe state of every room of a building, right nowScience Hall at 14:05
Latest ValueThe newest reading of a metric in a roomLab 2, 27 °C
Metric CatalogEverything that can be measuredTemperature, People, Capacity
FocusThe metrics a building compares its rooms on, most important firstTemperature, then People
ReadingOne value from one room at one momentLab 2, 14:05, 27 °C
TwinThe 3D copy of a real buildingThe 3D Science Hall

Question: how do people follow a building, live? Kind: Core. Needs: Telemetry Ingestion, something to follow.

Readings exist. Now each person has to be able to follow them, in a way that fits their work.


In the real world

Sam looks after Science Hall from the facilities office.


The model

classDiagram
    class BuildingStatus {
        building
        rooms
    }
    class LatestValue {
        room
        metric
        value
    }
    class Focus {
        building
        metrics
    }
    class CatalogEntry {
        metric
        unit
        owner
    }
    BuildingStatus "1" *-- "many" LatestValue
    Focus "1" o-- "many" CatalogEntry : picks, by importance

Importance is part of the model. What matters most comes first.


The catalog is collected, not invented

Each domain describes what it owns. This domain just gathers them.

flowchart LR
    T["Telemetry Ingestion: temperature, people, air quality"] --> C["Metric Catalog"]
    B["Building Management: capacity"] --> C
    C --> L["Focus: the building's pick"]

A new metric can be picked as soon as its owner describes it.


Two separate things

This is the idea to remember.

Building StatusFocus
HoldsEvery metric of every roomOnly the chosen metrics
Decided byWhat really happensPeople
Used forEverything that shows the buildingComparing rooms

Example. Ada removes Temperature from the Focus. The 3D twin still colours Lab 2 by temperature, because the status still knows it. The Focus changes what is compared, not what is known.

flowchart LR
    R["Reading Recorded"] --> F["Status of Science Hall"]
    F --> T3["3D twin"]
    F --> L{"In the Focus?"}
    L -- yes --> C["Rooms are compared on it"]
    L -- no --> H["Left out of the comparison"]

Rules

  1. A reading changes the status of its own building, and no other.
  2. Every room of the building can be compared, on its Latest Values.
  3. A room with no reading has no value, which is not 0. Zero people is a real value.
  4. A new building already has a Focus. Nobody has to set one up first.
  5. Only people whose pass allows the building can follow it.

Staying current

A person must never take an old value for the current one.

14:04  Sam stops following. Last value: 25 °C.
14:05  Reading: 27 °C. Sam misses it.
14:07  Sam is back. Sam knows 27 °C.

Missed readings do not matter one by one. Only now matters here. The past lives in Telemetry Ingestion.


Open questions