Timestamps Mapping Data
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
deviceTimestampNs | syncedTimestampNs |
---|---|
monotonically increasing timestamps in ns | monotonically increasing timestamps in ns |