ln2697 commited on
Commit
d27ed76
·
verified ·
1 Parent(s): 43e881b

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +12 -2
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
- > Minimum conversion:
 
 
 
 
 
 
 
 
 
 
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)