Update README.md
Browse files
README.md
CHANGED
|
@@ -10,19 +10,29 @@ pipeline_tag: robotics
|
|
| 10 |
|
| 11 |
# LEAD: Minimizing Learner–Expert Asymmetry in End-to-End Driving
|
| 12 |
|
|
|
|
| 13 |
> ## ⚠️ Coordinate System Warning
|
| 14 |
>
|
| 15 |
> **This model was trained in the left-handed coordinate system of CARLA** (x-forward, **y-right**, z-up), **not** the ISO 8855 convention used by NAVSIM / nuPlan / most AD stacks (x-forward, **y-left**, z-up).
|
| 16 |
>
|
| 17 |
> If you use `ltfv6.py` directly, the predicted `waypoints` and `headings` are in CARLA's left-handed frame. **You must convert the planning output back to ISO 8855 before feeding it to any downstream planner, simulator, or evaluation tool that expects the right-handed convention.**
|
| 18 |
>
|
| 19 |
-
>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 20 |
> ```python
|
| 21 |
> waypoints_iso[..., 0] = waypoints_carla[..., 0] # x unchanged
|
| 22 |
> waypoints_iso[..., 1] = -waypoints_carla[..., 1] # flip y
|
| 23 |
> headings_iso = -headings_carla # flip yaw sign
|
| 24 |
> ```
|
| 25 |
-
> Forgetting this step will produce mirrored trajectories (e.g. left turns executed as right turns) and silently broken metrics.
|
| 26 |
|
| 27 |
|
| 28 |
[**Project Page**](https://ln2697.github.io/lead) | [**Paper**](https://huggingface.co/papers/2512.20563) | [**Code**](https://github.com/autonomousvision/lead)
|
|
|
|
| 10 |
|
| 11 |
# LEAD: Minimizing Learner–Expert Asymmetry in End-to-End Driving
|
| 12 |
|
| 13 |
+
|
| 14 |
> ## ⚠️ Coordinate System Warning
|
| 15 |
>
|
| 16 |
> **This model was trained in the left-handed coordinate system of CARLA** (x-forward, **y-right**, z-up), **not** the ISO 8855 convention used by NAVSIM / nuPlan / most AD stacks (x-forward, **y-left**, z-up).
|
| 17 |
>
|
| 18 |
> If you use `ltfv6.py` directly, the predicted `waypoints` and `headings` are in CARLA's left-handed frame. **You must convert the planning output back to ISO 8855 before feeding it to any downstream planner, simulator, or evaluation tool that expects the right-handed convention.**
|
| 19 |
>
|
| 20 |
+
> ### ✅ Recommended: use the prepared NAVSIM workspaces
|
| 21 |
+
>
|
| 22 |
+
> For correct, reproducible evaluation, Use one of the prepared workspaces below — they already wire up the model with the correct coordinate conversion, input preprocessing, and metric computation:
|
| 23 |
+
>
|
| 24 |
+
> - **NAVSIM v1.1**: [`3rd_party/navsim_workspace/navsimv1.1`](https://github.com/kesai-labs/lead/tree/main/3rd_party/navsim_workspace/navsimv1.1)
|
| 25 |
+
> - **NAVSIM v2.2**: [`3rd_party/navsim_workspace/navsimv2.2`](https://github.com/kesai-labs/lead/tree/main/3rd_party/navsim_workspace/navsimv2.2)
|
| 26 |
+
>
|
| 27 |
+
> These are the only configurations we have validated end-to-end against the reported numbers. If you evaluate outside of them, results may silently disagree with the paper.
|
| 28 |
+
>
|
| 29 |
+
> ### Manual conversion (only if you must integrate the model yourself)
|
| 30 |
+
>
|
| 31 |
> ```python
|
| 32 |
> waypoints_iso[..., 0] = waypoints_carla[..., 0] # x unchanged
|
| 33 |
> waypoints_iso[..., 1] = -waypoints_carla[..., 1] # flip y
|
| 34 |
> headings_iso = -headings_carla # flip yaw sign
|
| 35 |
> ```
|
|
|
|
| 36 |
|
| 37 |
|
| 38 |
[**Project Page**](https://ln2697.github.io/lead) | [**Paper**](https://huggingface.co/papers/2512.20563) | [**Code**](https://github.com/autonomousvision/lead)
|