Repository navigation
docs: time sync accuracy, offset mapping and dejitter tuning - #336
Merged
Merged
Conversation
Moves the measurement theory from the main LSL site's time synchronization page (which keeps the practical guidance): why the offset is biased by half the path asymmetry and why the remaining error is dominated by network-stack differences, the ways to map offsets onto timestamps (latest offset, linear fit, robust fit) and how recorders defer that choice, and why and how to tune the dejitter half-time, with alternatives to RLS.
myd7349
pushed a commit
to myd7349/labstreaminglayer
that referenced
this pull request
Oct 17, 2026
- Time Synchronization keeps the practical guidance (synchronize at import with LabRecorder and the XDF importers, online options, non-LSL clocks, header parameters, validation). The measurement theory moved to liblsl's time synchronization page (sccn/liblsl#336). Fixes a link to an old commit of inlet.h. - Getting LSL: the liblsl section is a short summary with the lag caveat, linking to Getting liblsl instead of repeating its list. - User's Guide: a short overview of discovery, data, clock offsets and recovery, instead of an outdated copy of liblsl's internals. - Examples: link to liblsl's examples folder and README for C/C++. - FAQs: high data rates mention the synchronous outlet mode (1.18) instead of a 2022 pull request; current release file names; the two Binaries warnings were comments (missing ::) and are now shown. - Documentation Syntax becomes Contributing to the documentation: where each part of the docs lives, how to build both, the :liblsl: role.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Moves the measurement theory from the main site's Time Synchronization page into liblsl's
internals/time_syncpage (the main site keeps the practical guidance and links here; companion PR on sccn/labstreaminglayer):uncertaintymeans, link to the validation results.proc_clocksyncdoes), linear fit over(remote_time, offset)pairs, robust fit; recorders store raw data so the mapping is chosen at import.No Sphinx warnings.