https://github.com/ethz-asl/cuckoo_time_translator

algorithms for synchronizing clocks
https://github.com/ethz-asl/cuckoo_time_translator

clock-synchronization ros sensor-fusion time-series timestamps

Last synced: about 2 months ago
JSON representation

algorithms for synchronizing clocks

• Host: GitHub
• URL: https://github.com/ethz-asl/cuckoo_time_translator
• Owner: ethz-asl
• License: other
• Created: 2017-03-07T18:07:26.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2022-06-30T20:47:22.000Z (over 2 years ago)
• Last Synced: 2024-10-31T09:42:37.941Z (about 2 months ago)
• Topics: clock-synchronization, ros, sensor-fusion, time-series, timestamps
• Language: C++
• Size: 156 KB
• Stars: 89
• Watchers: 58
• Forks: 22
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build Status](https://jenkins.asl.ethz.ch/buildStatus/icon?job=cuckoo_time_translator)](https://jenkins.asl.ethz.ch/job/cuckoo_time_translator/)

# CuckooTimeTranslator

### Algorithms for translating times emitted by other (cheap) clocks into local system time

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

[!["Point Grey Chameleon3 timing"](https://github.com/ethz-asl/cuckoo_time_translator/wiki/images/chameleon10kHz-with-legend.png "Point Grey Chameleon3 timing")](https://github.com/ethz-asl/cuckoo_time_translator/wiki#example-plot)

### Scope

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](https://github.com/ethz-asl/hand_eye_calibration)

* [ethz-asl/kalibr](https://github.com/ethz-asl/kalibr/)

* [ethz-asl/oomact](https://github.com/ethz-asl/oomact/)

### Why call it translation rather than synchronization? 

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.

### Dependencies

* [caktin_simple](https://github.com/catkin/catkin_simple)

* ros-*-cmake-modules

* ros-*-rosconsole-bridge

* ros-*-dynamic-reconfigure

### Examples for how to use it in a ROS sensor driver:

See [usage examples](https://github.com/ethz-asl/cuckoo_time_translator/wiki#usage-examples-ros-sensor-drivers).

## Acknowledgments

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).