> ## Documentation Index
> Fetch the complete documentation index at: https://offthepace.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# int_track_geometry

> Circuit geometry (gradient + curvature) from raw X/Y/Z telemetry, binned to 25m distance intervals.

<Note>Part of the [Physics](/transform/families/physics) family.</Note>

Circuit geometry (gradient + curvature) from raw X/Y/Z telemetry, binned to 25m distance intervals. Grain is (race\_year, track\_id, distance\_bin) -- per-season, not collapsed to a single per-circuit shape, since GPS origin/heading can drift between seasons (verified at Bahrain: 2019 diverges from 2020-2024). Start/finish bin has NULL gradient/curvature (no wraparound across the lap boundary).

## Lineage

```mermaid theme={null}
flowchart LR
  int_track_geometry
  style int_track_geometry fill:#e40404,stroke:#e40404,color:#fff
```

## Overview

| Property          | Value                                  |
| ----------------- | -------------------------------------- |
| Layer             | `intermediate`                         |
| Family            | [Physics](/transform/families/physics) |
| Contract enforced | No                                     |

**3 tests** [guard](/transform/ci/overview) this model  -  3 generic, 0 singular.

## Columns

| Column                    | Type | Nullable | Tests                                  | Description                                                                                                       |
| ------------------------- | ---- | -------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `race_year`               |      | Yes      | [`not_null`](/transform/ci/structural) | Season                                                                                                            |
| `track_id`                |      | Yes      | [`not_null`](/transform/ci/structural) | Circuit identifier (from race\_to\_track)                                                                         |
| `distance_bin`            |      | Yes      | [`not_null`](/transform/ci/structural) | Lower edge of the 25m distance bin (meters from start line)                                                       |
| `gradient_dz_ds`          |      | Yes      |                                        | Elevation gradient dZ/ds between the previous and next bin                                                        |
| `curvature_per_m`         |      | Yes      |                                        | Menger curvature (1/m) from 3 consecutive binned points. NULL at season boundaries or where points are collinear. |
| `lateral_accel_proxy_ms2` |      | Yes      |                                        | v^2 \* curvature\_per\_m, using median speed at the bin (m/s^2)                                                   |