The dominant application is translating hardware timestamps of a sensor into the system time of a receiving computer system.

Currently it covers on way communication based translation only. I.e. the foreign clock does not answer to any delay estimation / synchronization messages.

Please note that typically this cannot be carried out perfectly. There will be noise in the translation and an unknown bias (offset), such as the offset from the blue to the green points above. In particular in the one way case. However, in many applications it is possible to calibrate for the offset using additional information such at sensor measurements. Howevere, this step is beyond this repository. If you need that the following repositories might be interesting for you:

• ethz-asl/hand_eye_calibration
• ethz-asl/kalibr
• ethz-asl/oomact

Because synchronization refers to what one does to clocks to make them run at the same speed and yield similar times when read at the same time (as for instance NTP and PTP do to computer clocks), whereas the algorithms in this repository are trying to only translate the time of one clock for a given event into the another clock's time for the same event and not touch the clocks at all.

See usage examples.

This work is supported in part by the European Union's Seventh Framework Programme (FP7/2007-2013) under grant #610603 (EUROPA2) and the European Union's Horizon 2020 research and innovation programme under grant agreement No 644227 (FLOURISH).