Documentation — TELOS F1

01

Getting Started

TELOS F1 is a browser-based telemetry analysis platform. No installation required — open the dashboard and start exploring.

Select a Grand Prix — choose any round from the 2026 calendar (22 circuits, Bahrain and Saudi Arabia not included this season).
Choose a Session — FP1, FP2, FP3, Qualifying, Sprint, or Race.
Pick a Driver — select the target driver from the driver selector. Optionally add a reference driver for comparison.
Select a Lap — choose any lap from the lap history panel. Star laps to bookmark them.
Analyze — explore the telemetry charts, gap delta, sector splits, stint analysis, and X-Mode data.

02

Telemetry Channels

Each channel is rendered as a time-series or distance-series chart. All channels are synchronized to the same x-axis for direct comparison.

Channel	Color	Unit	Description
Speed	CYAN	km/h	Car speed over the lap. Primary telemetry channel.
Throttle	GREEN	%	Throttle pedal application (0–100%).
Brake	RED	bool / %	Brake pedal application. Binary or pressure-based depending on session.
Gear	YELLOW	1–8	Gear position. Step chart style.
X-Mode	PURPLE	zones	Activation zones overlaid on speed trace as purple highlights.
DRS	GREEN	zones	DRS open/closed zones overlaid on speed trace.
Gap Delta	±	seconds	Time gap between target and reference driver, calculated via distance interpolation.

03

Dashboard Controls

Control	Location	Description
GP Selector	Top bar	Select Grand Prix from the 2026 calendar (22 rounds).
Year Selector	Top bar	Switch between 2024 and 2025 historical data.
Session Selector	Top bar	FP1 / FP2 / FP3 / Q / Sprint / Race.
Driver Selector	Left panel	Primary (target) driver for analysis.
Reference Driver	Left panel	Secondary driver for comparison overlay.
Swap Drivers	Left panel	One-click swap between target and reference.
Lap History	Left panel	All laps for the session. Click to select. Star to bookmark.
Sort Mode	Left panel	Sort laps by lap number, time, or sector.
ENG Button	Top right	Toggle Engineer View (compact dense layout).
Share Button	Top right	Screenshot session summary and share via Web Share API.

04

Keyboard Shortcuts

Key	Action
`E`	Toggle Engineer View
`R`	Swap / set reference driver
`Esc`	Close any open modal or overlay
`↑` / `↓`	Navigate lap history (when panel focused)

05

Gap Delta

The gap delta chart shows the time difference between the target and reference driver at each point on the lap. A negative value means the target driver is ahead (faster); a positive value means they are behind.

Gap is calculated using distance-based interpolation — both drivers' telemetry is resampled to a common distance axis, then the time difference is computed at each meter. This is the same method used by F1 pitwall engineers and is significantly more accurate than raw lap-time subtraction, which does not account for where on track time is gained or lost.

Interpretation

A sharp drop in the gap delta curve at a specific distance marker indicates a braking point advantage. A gradual gain through a corner sequence suggests better exit speed or traction. The end-of-lap value equals the overall lap time difference.

06

X-Mode

X-Mode is a special performance mode deployed by drivers in designated circuit zones to maximize power delivery or aerodynamic efficiency. On the speed trace, X-Mode activation segments are highlighted as purple overlays.

The Lap Insights panel displays the total X-Mode usage percentage for each lap. High X-Mode % typically correlates with lower sector times in activation zones.

07

Engineer View

Engineer View is a compact, information-dense layout designed for power users who want to see maximum data simultaneously. It reduces padding, compresses panels, and increases chart density.

Toggle via the ENG button in the top-right dashboard controls, or press E on your keyboard. Settings persist across reloads via LocalStorage.

08

Export

Any selected lap can be exported from the telemetry panel:

CSV — flat table with all channel values per sample point. Compatible with Excel, Python (pandas), R.
JSON — structured object with full metadata (session info, driver, lap time, sector splits) and channel arrays.
Share Image — session summary screenshot via html2canvas, shareable via Web Share API or clipboard.

09

Data Sources

TELOS sources telemetry from two primary APIs:

Source	Type	Coverage
FastF1	Python library	2018–2025 historical sessions, full telemetry
OpenF1 API	REST API	2023–present, live and historical

Data Gaps

Some sessions may have incomplete telemetry due to missing data in the upstream APIs. If you encounter persistent data gaps, please report them via contact with the circuit name, year, and session type.

DOCS