Skip to content

Commit 193179b

Browse files
committed
docs: add AWSIM autonomous driving pipeline to README
- Add AWSIM pipeline section with quick start commands - Update scope to include lanelet2 generation and AWSIM pipeline - Add AWSIM tutorial link to docs section - Highlight lanelet2 auto-generation and one-command demo in Why This Repo
1 parent 595b2fe commit 193179b

1 file changed

Lines changed: 44 additions & 2 deletions

File tree

README.md

Lines changed: 44 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,19 +21,22 @@ This repository is for people who want:
2121

2222
- ROS 2 LiDAR SLAM with loop closure
2323
- pointcloud maps that Autoware can load
24+
- lanelet2 maps auto-generated from SLAM trajectories
25+
- end-to-end autonomous driving on self-made maps (AWSIM + Autoware)
2426
- a non-GPL default workflow
2527

2628
Out of scope for the public path:
2729

28-
- `lanelet2_map.osm` generation
29-
- Autoware planning/localization bringup
30+
- Autoware planning/localization bringup beyond the provided demo scripts
3031
- GPL-only frontend or backend components in the default workflow
3132

3233
## Why This Repo
3334

3435
- non-GPL default path: `graph_based_slam` (BSD-2-Clause), `scanmatcher` (project-local), `RKO-LIO` (MIT), `DLIO` (MIT), `FAST_GICP` (BSD-3-Clause)
3536
- pointcloud-map authoring is treated as a first-class workflow, not just a side-effect of odometry
3637
- Autoware pointcloud-map flow is exercised end-to-end
38+
- **AWSIM → lidarslam → Autoware autonomous driving** pipeline with one-command demo
39+
- **lanelet2 auto-generation** from SLAM trajectories (multi-segment with shared boundary nodes)
3740
- default benchmark path is tracked on `NTU VIRAL`
3841
- current long-loop evidence is tracked on `MID360`
3942
- optional GNSS georeferencing writes `map_projector_info.yaml`
@@ -85,13 +88,52 @@ bash scripts/run_autoware_quickstart.sh
8588
bash scripts/run_autoware_map_beginner.sh /path/to/rosbag2
8689
```
8790

91+
## AWSIM Autonomous Driving Pipeline
92+
93+
Build a pointcloud map from AWSIM simulator data, auto-generate a lanelet2 map from the SLAM trajectory, and run autonomous driving with Autoware — all from self-made maps.
94+
95+
```
96+
AWSIM (LiDAR + IMU) → rosbag2 → lidarslam → pointcloud_map + lanelet2 → Autoware → Driving
97+
```
98+
99+
```bash
100+
# 1. Setup verification
101+
bash scripts/test_awsim_setup.sh
102+
103+
# 2. One-command Autoware map from SLAM output
104+
bash scripts/build_autoware_map_from_slam.sh \
105+
--pcd-dir ./pointcloud_map \
106+
--g2o ./pose_graph.g2o \
107+
--awsim-config /path/to/config.json \
108+
--output ./autoware_map
109+
110+
# 3. Autonomous driving demo with self-made map
111+
bash scripts/run_awsim_selfmade_map_demo.sh
112+
113+
# 4. Or step-by-step with sample map
114+
bash scripts/run_awsim_autoware_demo.sh awsim # Terminal 1
115+
bash scripts/run_awsim_autoware_demo.sh autoware # Terminal 2
116+
bash scripts/run_awsim_autoware_demo.sh engage # Terminal 3
117+
```
118+
119+
Generate a lanelet2 map from any TUM trajectory:
120+
121+
```bash
122+
python3 scripts/simple_lanelet2_generator.py \
123+
--input traj.tum --output lanelet2_map.osm \
124+
--lane-width 7.0 --origin-lat 35.68 --origin-lon 139.69
125+
```
126+
127+
See [AWSIM Autonomous Driving Tutorial](docs/awsim-autonomous-driving-tutorial.md) for the full walkthrough.
128+
88129
## Point-Cloud Map Example
89130
Autoware-compatible browser proof built from a live `/map/pointcloud_map`: the rendered map comes from Autoware map loaders, map verify is `PASS`, and GNSS runs emit `LocalCartesian`.
90131
![Autoware-compatible proof](lidarslam/images/autoware_map_loader_proof.png)
91132
Save-time dynamic-object filtering on Leo Drive `bag6` cuts saved points by about `50%` while keeping verification `PASS`.
92133
![Dynamic-object filter summary](lidarslam/images/dynamic_object_filter_bag6_summary.svg)
93134

94135
## Docs
136+
- [AWSIM Autonomous Driving Tutorial](docs/awsim-autonomous-driving-tutorial.md)
95137
- [Autoware-Compatible Map Authoring](docs/autoware-map-authoring.md) / [Autoware Quickstart](docs/autoware-quickstart.md) / [Autoware Foxglove](docs/autoware-foxglove.md)
96138
- [Operator Workflows](docs/workflows.md)
97139
- [Benchmarking And Release Gate](docs/benchmarking.md)

0 commit comments

Comments
 (0)