Skip to main content

Timestamps Mapping Data

caution

Aria Pilot Dataset documentation is stored in Archive: Aria Data Tools, because it was Project Aria's first open source initiative and it uses a different data structure compared to our latest open releases. For the most up to date tooling and to find out about our other open datasets go to Project Aria Tools.

This website will be deleted in September 2024.

Timestamps Mapping Data

Project Aria devices and multi-view devices operating in proximity to each other (<100m) can leverage SMPTE timecode to receive a synchronized time clock with sub-millisecond accuracy.

The mapping between local time clock and synchronized time clock for each sequence is stored in the file synchronization/timestamp_mapping.csv which contains two columns of data:

  • deviceTimestampNs - Timestamps in the device’s local time clock. All devices have their own time clocks which start at different times and potentially progress at different rates.
  • syncedTimestampNs - Timestamps in the synchronized time clock common to all devices.

This mapping data provides a way to convert timestamps from device local time clock to synchronized time clock and, by extension this also mean that data from multiple devices can be expressed with respect to a common time. The timestamps in timestamp_mapping.csv are increased monotonically.

To translate the local timestamp of an arbitrary piece of data recorded by the device, you can use the offset obtained by searching in the mapping file for the nearest local timestamp and calculating its delta to the synchronized time clock. An implementation of this mechanism is provided in Aria Data Tool’s code

Table 1: timestamp_mapping.csv Structure

deviceTimestampNssyncedTimestampNs
monotonically increasing timestamps in nsmonotonically increasing timestamps in ns