Comparison mode
You can open two or more data sources on a shared playback timeline while keeping each source distinct using comparison mode. This is useful when the sources share topics and you want to view the data together, either overlaid or side-by-side. For example, comparing a run before and after a code change, or aligning a simulation against a real-world log.
Starting a comparison
On the Recordings, Sessions, or Events pages, select two or more items and click Compare.
To compare local files, open more than one file at once (from the dashboard, the command palette, Ctrl + O / Cmd + O, or by dragging files into Foxglove). Foxglove merges local files by default. To keep them separate, open the Sources sidebar and switch to Compare at the top.
Reading the comparison
Each item you compare (such as a recording, session, or event) is a source. Each source occupies a slot labeled A, B, C, and so on, assigned in the order you select them. Slot badges appear next to the source name in the top bar, in Plot and State Transitions legends and series settings, in the Sources sidebar, and in the scrubber tooltip. Map represents each slot with a distinct color instead of a badge.
Some panels, such as Plot, State Transitions, and Map, are multi-source: they render every source at once. Others are single-source: they display one source at a time. Both types have a data source picker in the panel toolbar. Use it to focus a multi-source panel on one slot, or to switch a single-source panel between slots.
Hovering a slot highlights its data across the app and dims any single-source panel showing a different source.
Adjusting a comparison
Every source begins at time zero on the shared timeline, regardless of when it was originally recorded. Shift a source's start time to align two sources recorded at different real-world times.
Open the Sources sidebar to:
- Add local files. Click Add in the footer. Local-file comparisons only.
- Remove a source. Click × next to its heading and confirm.
- Reorder slots and change start times. Click Manage in the footer (or the clock icon on the playback bar) to open the editor. Drag rows in the editor to reorder slots, type new offsets in each row's field, or drag each source's bar on the playback timeline to shift its start time.
Setting a source's start time before time zero re-anchors the whole set. The earliest source moves to zero, and every other source shifts by the same amount.
Hovering the playback scrubber shows the Elapsed time followed by each source's local timestamp.
