PISTA Core

Performance Inspection, Signal & Telemetry Analysis — the analysis engine.

PISTA Core is the engine behind PISTA Studio, a desktop telemetry analysis application for cycling built on the motorsport analysis paradigm (WinTAX, Pi Toolbox, ATLAS) rather than the sports-science paradigm of existing cycling tools.

Core is usable on its own: it ingests FIT files, computes a channel library, and aligns multiple riders onto a common distance axis.

Status

Pre-release. Phase 0 of the roadmap — no public API yet.

What it does

Design commitments

• Immutable, append-only Parquet. One file per activity, never modified after writing. A library is a folder, so write contention cannot occur and it works over any sync service.
• No Qt dependency, ever. Core is a library; the application lives in PISTA Studio.
• Vectorized or SQL. Python orchestrates and never iterates over samples.
• Nulls are not zeros. A sensor dropout is a different fact from a genuine zero.

Development

Requires uv and Python 3.12+.

uv sync --extra dev        # create the environment
uv run pytest              # tests
uv run ruff check .        # lint
uv run ruff format .       # format
uv run pyright             # type check
uv run pre-commit install  # install the gitleaks + lint hooks (once)

Data

No rider data lives in this repository, not even anonymised. All tests and examples use the synthetic generator. A local FIT corpus belongs outside the repository.

Licence

Not yet licensed. PISTA Core will be published under an open licence (Apache-2.0 or AGPL-3.0) before the repository is made public.

© Alberto Scomparin