Track session¶
A track session is a folder of runs on the same track. It's the unit of analysis in Racecraft: one session, one track, one reference run, one leaderboard.
What a track session contains¶
- a name (set by the rider or coach who created it)
- one reference run that defines the track
- any number of target runs aligned against the reference
- the leaderboard derived from those runs
Why one session = one track¶
The reference run defines the geometry of the track — where it starts, where it ends, which intermediate splits matter. Mixing two different tracks in one session would mean one of them aligns against a reference that isn't actually for that track.
When the line, start, or finish of a track changes meaningfully — the course gets re-routed, a feature is added — that's a different geometry. Create a new track session for it rather than re-pointing the reference of the old one.
Private vs team sessions¶
A track session can be:
- private to a single rider — only that rider sees the runs
- team-shared — every member of the team sees the session, can upload runs into it, and compares against the same reference
Whether a session is private or team-shared is decided when it's created and is part of how riders work with the product, not part of how the analysis works. The analysis is the same either way.
Track sessions vs public events¶
A track session and a public event have a lot in common — both centre on a single track and a single reference run. They differ in audience:
- a track session is private to a rider or a team
- a public event is open on the web with a public leaderboard
Most riders and coaches live in track sessions. Public events are specific to race-day setups. See Public events for the differences in detail.
Lifecycle¶
Track sessions don't expire. A session you created last season is still there, with the same reference run, the same runs, the same leaderboard. Returning to a track from a previous season usually means returning to that session.
If you're starting fresh — a new course layout, a different bike setup you want measured separately — create a new session.