Skip to content

feat(ansible): add the Kashiwanoha CARLA map to demo_artifacts - #7301

Merged
xmfcx merged 1 commit into
mainfrom
feat/ansible-demo-artifacts-carla-kashiwanoha
Sep 3, 2026
Merged

feat(ansible): add the Kashiwanoha CARLA map to demo_artifacts#7301
xmfcx merged 1 commit into
mainfrom
feat/ansible-demo-artifacts-carla-kashiwanoha

Conversation

@xmfcx

@xmfcx xmfcx commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Description

The demo_artifacts role now downloads the Kashiwanoha map for the CARLA demo. The map lives on Hugging Face as the dataset AutowareFoundation/map-carla-kashiwanoha, pinned to tag 0.2.0. It lands in ~/autoware_data/maps/carla-kashiwanoha/, beside the two sample maps.

The dataset is a complete Autoware map directory plus the CARLA side of the same roads:

File Read by
lanelet2_map.osm Autoware
map_projector_info.yaml Autoware
kashiwanoha.xodr CARLA, to build the world

CARLA has no map of this area. The world is built from the OpenDRIVE at run time. The dataset card carries that step and the provenance of each file: https://huggingface.co/datasets/AutowareFoundation/map-carla-kashiwanoha

The task uses the same hf download loop shape as the artifacts role, so the next map dataset is one more loop entry. It passes --repo-type dataset, because this is a dataset repository. It excludes the demo video in the dataset, which no node reads. The huggingface_cli role joins the dependencies of demo_artifacts, so hf is present on a clean host.

The role README gets the new directory in the layout tree and a short note on the three files.

The map was first proposed as files inside autoware_universe. That PR was closed, and the data moved to the Hub, the same route as the models.

The CARLA demo compose file does not use this map yet. That change waits for the next release, because the published images carry an autoware_carla_interface from before the carla_map override.

AI usage

AI usage: Written with Claude Code: the role change, the README, the dataset completion on Hugging Face, and the verification below. I read every line.

Self-review: It downloads fine, also ran carla on my local. Safe to merge.

Verification: The task ran standalone against tag 0.2.0 and produced the three map files with matching checksums. The result directory then carried a full autonomous drive in CARLA.

The download task, standalone against localhost

The new task, copied verbatim into a one host playbook. Ubuntu 24.04, hf 1.28.0 from pipx.

  • Recap ok=2 changed=0 unreachable=0 failed=0, rc: 0, 3 s.
  • Result directory: kashiwanoha.xodr, lanelet2_map.osm, map_projector_info.yaml, README.md, .gitattributes. No .mp4.
  • sha256sum lanelet2_map.osm is 4fe358f2d1e182dc76de296e5619086f8d8ad2fcab3e6d8f99f6e3d724a84e6d, equal to planning/autoware_diffusion_planner/test_map/lanelet2_map.osm in autoware_universe.
  • sha256sum kashiwanoha.xodr is fbd06aec46853270548a62f16d8754c8cdb669113b52726fc6477e9789302df5, equal to the LFS object the Hub reports for the tag.
  • Not run: the full demo_artifacts role. Its unzip task needs sudo, and this host has no passwordless sudo.

The map files, loaded by Autoware nodes

  • ros2 launch autoware_map_projection_loader map_projection_loader.launch.xml on the downloaded map_projector_info.yaml: the node logged Loaded map projector info, and /map/map_projector_info published LocalCartesianUTM, origin 35.9033135426554 / 139.93338978245356, scale_factor: 0.9996.
  • lanelet2.io.loadRobust on the downloaded lanelet2_map.osm with the Autoware regulatory elements registered: 0 errors, 190 lanelets, 51 regulatory elements.

A drive on the downloaded directory

CARLA 0.9.16 in Docker, the universe-cuda-jazzy-1.9.0 image with the main branch autoware_carla_interface overlaid, planning_simulator.launch.xml with ground truth localization. 2026-09-03.

  • The world was built from kashiwanoha.xodr in 5.9 s: Carla/Maps/OpenDriveMap, 238 spawn points.
  • Engage at 10:01:04 UTC, ARRIVED at 10:02:01, 143 m route at 4.2 m/s.
  • Not run: the demo compose file as it is in the repository. It cannot load this map with the published images.

Static checks

  • ansible-playbook autoware.dev_env.install_dev_env --tags demo_artifacts --syntax-check passed.
  • pre-commit run on the three files passed: yamllint, prettier, markdownlint.
  • Not run: ansible-lint, not installed on this host. Not run: a Humble or 22.04 host.

The CARLA demo needs a map directory that holds the same roads twice: a lanelet2 map for Autoware and an OpenDRIVE for CARLA. The AutowareFoundation/map-carla-kashiwanoha dataset on Hugging Face carries both, plus the map origin, at tag 0.2.0.

The role downloads that tag into maps/carla-kashiwanoha with the same hf download loop shape as the artifacts role, so the next map dataset is one more loop entry. The demo video in the dataset is excluded, because no node reads it. The huggingface_cli role joins the dependencies, so hf is present on a clean host.

Signed-off-by: Mete Fatih Cırıt <mfc@autoware.org>
@xmfcx xmfcx self-assigned this Sep 3, 2026
@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

Thank you for contributing to the Autoware project!

🚧 If your pull request is in progress, switch it to draft mode.

Please ensure:

@xmfcx xmfcx added the run:health-check Run health-check label Sep 3, 2026
@xmfcx
xmfcx marked this pull request as ready for review September 3, 2026 11:26

@oguzkaganozt oguzkaganozt left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@xmfcx
xmfcx merged commit f3b365c into main Sep 3, 2026
35 of 39 checks passed
@xmfcx
xmfcx deleted the feat/ansible-demo-artifacts-carla-kashiwanoha branch September 3, 2026 13:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

run:health-check Run health-check

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants