F1 Telemetry Analyzer

Превращает сырую телеметрию круга F1 22 в компактные Markdown-отчёты для анализа через LLM. Сырой круг — около 1М токенов; отчёты — 1–35k.

# из папки tool/
python -m telemetry technique ../zandvoort_P_L7_74.074_ferrari.csv
# -> ../reports/zandvoort_P_L7_74.074_ferrari_technique.md   (~34k токенов)

Или просто двойной клик по run-gui.bat и кнопка Generate report.

Установка

Python 3.10+ (только стандартная библиотека — без pip install).
Для GUI нужен Tk; он идёт в стандартном установщике Python на Windows/macOS. CLI работает и без него.

Скачай или склонируй репозиторий. Держи CSV-файлы телеметрии в папке на уровень выше tool/ (см. структуру папок).

Что умеет

Пять режимов. Четыре строят отчёты, один переименовывает файлы.

Режим	Вход	Для анализа
`technique`	один круг	как едешь — точки торможения, скорости в апексах, работа газом, блокировки, расход ресурсов
`setup`	один круг	что настроено — баланс (US/OS), температуры шин, тормоза, rake и крен подвески
`compare`	два+ круга	где один круг быстрее — дельта по поворотам и накопленная
`race`	папка кругов	вся гонка — темп, деградация в стинтах, износ резины, ERS по кругам
`rename`	файлы/папка	вставить номер круга в имя файла (`..._74.074_...` → `..._L7_74.074_...`)

Отчёты содержат легенду с пояснением каждой колонки — LLM понимает данные без дополнительных подсказок. Готовые промпты для анализа лежат в prompts/ — по одному на режим.

Структура папок

Программа живёт в tool/; телеметрия — на уровень выше, отчёты выходят рядом с ней:

Telemetry/
  zandvoort_P_L7_74.074_ferrari.csv   <- сырые круги здесь
  races/
    Zandvoort_Race_2026/              <- по папке на гонку (для режима `race`)
  reports/                            <- сюда выходят отчёты
  tool/                               <- этот репозиторий
    telemetry/
    prompts/
    run-gui.bat

Полезное

GUI — двойной клик по run-gui.bat (или run-gui.pyw без окна консоли, либо python -m telemetry gui). Выбери режим, укажи файл/папку, нажми Generate. Кнопка Rename unprocessed добавляет номера круга к файлам, у которых их ещё нет, и не трогает остальные.

CLI — из папки tool/:

python -m telemetry technique ../lap.csv
python -m telemetry setup     ../lap.csv
python -m telemetry compare   ../lap_a.csv ../lap_b.csv
python -m telemetry race      ../races/Zandvoort_Race_2026
python -m telemetry rename    ../races/Zandvoort_Race_2026   # или отдельные файлы

Каждый прогон печатает путь к отчёту и оценку токенов:

C:\...\Telemetry\reports\lap_technique.md
~33834 tokens (budget 60k)

Rename трогает только необработанные файлы. Файл считается обработанным, как только в имени появляется токен L<номер> — поэтому повторный запуск безопасен и идемпотентен.

Входной формат

Телеметрия F1 22 (UDP), экспортированная в CSV (тестировалось на F1Laps). UTF-8, ~1800 строк на круг (≈29 Гц), 108 каналов. Один файл = один круг. Для режима race сложи все круги гонки в одну папку.

Для разработчиков

Чистый Python на стандартной библиотеке. Конвейер: parser → segments (+ corner_metrics) → resample → report_*. См. ARCHITECTURE.ru.md.

cd tool
python -m pytest -q        # прогнать тесты
python -m telemetry gui    # запустить GUI

Новый режим: добавь telemetry/report_<mode>.py с функцией generate(...) -> (abs_path, tokens) и одну строку в telemetry/__main__.py. Парсер, детекция поворотов, адаптивная трасса и общие блоки отчётов переиспользуются.

Благодарности

Сделано для разбора личных хотлапов в F1 22. Формат экспорта телеметрии — F1Laps.

Лицензия

MIT — см. LICENSE.

5.5 KiB Raw Blame History Unescape Escape