# F1THEDATA

> F1THEDATA (f1thedata.com) is a free, open-source Formula 1 telemetry and race data visualization dashboard covering all F1 circuits and drivers from 2018 to 2026.

## What it does

F1THEDATA lets fans and analysts explore Formula 1 session data through interactive visualizations:

- **Race Replay**: 25 FPS telemetry replay with real car positions on the circuit map
- **Telemetry Traces**: Speed (km/h), throttle %, brake %, gear for each driver
- **Sector Times**: S1, S2, S3 with personal bests (green) and session bests (purple)
- **Tyre Strategy**: Visual timeline of compound choices (Soft/Medium/Hard/Intermediate/Wet) per stint
- **Race Gaps**: Gap-to-leader chart by lap number showing position changes
- **Pit Stops**: Pit timing, compound changes, and undercut/overcut analysis
- **Lap Comparison**: Side-by-side telemetry overlay between two drivers on any lap
- **Championship**: Driver and constructor standings with progression charts
- **Weather**: Air/track temperature, humidity, rainfall, and wind data
- **Race Control**: Flags, safety car, virtual safety car, and penalty messages

## 8-Panel Dashboard Layout

The main dashboard displays 8 synchronized panels: track map with car positions, leaderboard with live timing, 4-channel telemetry traces, race trace gap chart, tyre strategy timeline, sector times table, weather conditions, and race control messages.

## Data Coverage

- **Telemetry**: 2018-2026 seasons (from F1 live timing via FastF1)
- **Championship Data**: 2001-2026 (26 seasons, 130+ drivers, 40+ constructors via Jolpica API)
- **Sessions**: Practice 1, Practice 2, Practice 3, Qualifying, Sprint Qualifying, Sprint, Race
- **Driver Stats**: Championship position, points, wins, podiums, pole positions, DNFs, average grid position per season
- **Constructor Stats**: Championship position, points, wins, podiums, race count per season
- **Team Lineage**: Historical team rebranding chains (e.g., Jordan to Force India to Racing Point to Aston Martin)
- **Circuits**: All Formula 1 circuits worldwide
- **Data freshness**: Historical data available immediately. Current-season data updated weekly via Jolpica API.

## How to Use

1. Visit f1thedata.com
2. Select a season year (2018–2026)
3. Choose a Grand Prix round
4. Pick a session type (Race, Qualifying, Practice, Sprint)
5. Wait for data to load (first visit downloads from F1 servers)
6. Explore the 8-panel dashboard, click drivers to highlight telemetry, use replay controls

## Technical Stack

- **Frontend**: Next.js (React 19, TypeScript, App Router)
- **Backend**: FastAPI (Python) with FastF1 library
- **Charts**: ECharts (echarts-for-react)
- **Caching**: SQLite (local) + Cloudflare R2 (edge CDN)
- **Replay**: WebSocket-based 25 FPS telemetry stream

## Use Cases

- F1 fans analyzing driver performance lap by lap
- Comparing driver telemetry (speed, throttle, braking) on specific laps
- Understanding tyre degradation and pit stop strategy effectiveness
- Studying sector time differences between teammates or rivals
- Reviewing how weather changes affected race pace
- Analyzing race control decisions and their timing impact
- Tracking championship points progression after each round

## URL Structure

- `/` — Home page with session selector
- `/drivers` — All drivers directory with career totals (searchable, 130+ drivers)
- `/drivers/{driverId}` — Individual driver career profile (e.g., /drivers/lewis-hamilton)
- `/season/{year}` — Championship standings with points bars (e.g., /season/2025)
- `/teams/{year}` — Constructor standings with team lineage (e.g., /teams/2025)
- `/race/{year}/{round}/{session}` — Main telemetry dashboard (e.g., /race/2025/5/R)
- `/race/{year}/{round}/{session}/compare` — Lap comparison view

## Frequently Asked Questions

### What is F1THEDATA?
F1THEDATA is a free Formula 1 telemetry dashboard that lets you replay race sessions at 25 FPS, analyze speed/throttle/brake/gear traces, compare driver laps, view tyre strategies, and track championship standings.

### What F1 data can I analyze?
Telemetry (speed, throttle, brake, gear), sector times (S1/S2/S3), tyre strategy, race gaps, pit stops, weather, race control messages, and results for Practice, Qualifying, Sprint, and Race sessions.

### Which seasons are covered?
2018 to 2026. Telemetry data from F1 live timing wasn't available before 2018.

### Is it free?
Yes, completely free with no registration required.

### Where does the data come from?
The FastF1 Python library processes publicly available F1 live timing data from Formula 1's SignalR feed.

## Disclaimer

F1THEDATA is an unofficial fan project. It is not affiliated with, endorsed by, or connected to Formula One World Championship Limited, Formula 1, FIA, or any F1 team. All data is sourced from publicly available timing feeds via the FastF1 library.

## Embeddable Charts

- Tyre strategy embed: https://f1thedata.com/embed/tire-strategy/{year}/{round}/{session}
- Race trace embed: https://f1thedata.com/embed/race-trace/{year}/{round}/{session}

## Links

- Website: https://f1thedata.com
- llms-full.txt: https://f1thedata.com/llms-full.txt
- GitHub: https://github.com/subinium/awesome-f1
- Powered by FastF1 (Python F1 telemetry library)