Skip to content
cccskills
FreePublished on GitHub

bounding-boxes

Read and display CARLA object bounding boxes, then project them onto a camera image as 2D rectangles. Export an annotated PNG and box coordinates in JSON for object detection annotation work.

OriginalShow the original description

Gets actor and level 3D bounding boxes and projects them into a camera image as 2D boxes — the dataset-annotation workflow. Lists box geometry, draws 3D boxes in the world via debug, or captures one camera frame and writes an annotated PNG plus a JSON of 2D boxes for matching actors. Use when the user asks to "get bounding boxes", "draw boxes around the cars", "project boxes onto the camera", or "generate a detection dataset / annotations".

See how to install

Good for

  • Adding vehicle boxes to a camera image
  • Exporting box coordinates for detection annotations
  • Checking vehicle dimensions
  • Displaying 3D boxes that follow moving vehicles

Files included (5)

  • SKILL.md4.2 KB
  • references/bounding-boxes.md2.2 KB
  • scripts/bounding_boxes.py9.8 KB
  • scripts/check_env.sh2.1 KB
  • scripts/env.sh1.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Bounding boxes

Paths. scripts/… and references/… below are relative to the directory holding this SKILL.md. Your working directory is the user's project, not that directory, so prefix them with its absolute path or the command is not found.

Three things: read actors' 3D boxes, draw them in the world, or project them into a camera image as 2D boxes with a JSON sidecar — the standard CARLA dataset-annotation pipeline (client_bounding_boxes.py).

Instructions

Progress:
- [ ] Step 1: Check prerequisites (bash scripts/check_env.sh), clear FAILs
- [ ] Step 2: For `project`, have a camera on the ego (create-sensor) + actors around
- [ ] Step 3: list / draw / project

Commands need CARLA_HOST/CARLA_PORT from scripts/env.sh.

Step 1: Check prerequisites

bash scripts/check_env.sh

Step 3: Boxes

source scripts/env.sh

# 3D box geometry of every vehicle
python3 scripts/bounding_boxes.py list --filter vehicle.*

# draw 3D boxes around vehicles — they track moving cars, stay 30 s (default)
python3 scripts/bounding_boxes.py draw --filter vehicle.*
python3 scripts/bounding_boxes.py draw --filter vehicle.* --seconds 60

# project vehicle boxes into a camera frame -> annotated PNG + JSON
python3 scripts/bounding_boxes.py project --camera <camera_id> --filter vehicle.* --out boxes.png

How the projection works (brief)

Capture one frame → build the camera intrinsics K from its fov + resolution → for each actor, take its 3D box's 8 world vertices (get_world_vertices), transform to camera space with the camera's inverse matrix, keep those in front, apply K → 2D points → the min/max is the 2D box. Off-frame and too-far (--max-dist) actors are skipped. Full math in the reference.

Examples

Example 1: annotate the ego camera

User says: "put boxes on the cars in the camera view"

Spawn a camera on the ego (create-sensor), then project --camera <id> --filter vehicle.* → boxes.png with green 2D boxes + boxes.json.

Example 2: how big is that actor

User says: "what are the dimensions of vehicle 137?"

list --filter vehicle.* (find 137) → its LxWxH from the extent.

Example 3: visualise in 3D

User says: "outline all the vehicles in the world"

draw --filter vehicle.* — green 3D boxes on a rendered server.

Troubleshooting

Problem: project finds no boxes Cause: no actors in front of / within --max-dist of the camera, or wrong filter. Solution: raise --max-dist, widen --filter, ensure vehicles are in view.

Problem: boxes misaligned Cause: the frame and the actor poses drifted (fast motion, async). Solution: capture in synchronous mode (set-world-settings) so the frame and poses are from the same tick.

Problem: draw shows nothing Cause: headless -nullrhi server. Solution: use a rendered server (see debug-draw).

Note: boxes always track moving actors draw re-stamps each frame for --seconds (default 30), so boxes ride moving cars automatically — the command blocks for that duration.

Outputs

  • list: box dimensions per actor.
  • draw: 3D box overlay (rendered view).
  • project: <out>.png (annotated) + <out>.json (2D boxes: id, type, xyxy).

Detail (intrinsics, world→camera transform, level boxes, lidar-to-camera) in references/bounding-boxes.md.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Add a message type to CARLA's native ROS 2 interface. Create its C++ data structure, serialization code for transmission, type identity hash, registration, and tests, with Docker-based hash calculation and build checks.

  • Adding a standard ROS 2 message type missing from CARLA
  • Defining a custom carla_msgs message
  • Investigating type-hash warnings
carla-simulator/carla14.5KUpdated Oct 18, 2026

Extend CARLA’s native ROS 2 interface to publish sensor data or receive vehicle commands. Covers topic implementation, registration, data connections, and verification, plus adding middleware, the communication layer used to exchange messages.

  • Publish obstacle sensor data to ROS 2
  • Add a topic for vehicle speed commands
  • Integrate another communication middleware
carla-simulator/carla14.5KUpdated Oct 18, 2026

Summarize ScenarioRunner results to see which scenarios passed and which checks failed. Compare runs before and after changes, or analyze recorded driving to produce measurements and plots of vehicle distance and deviation from the lane center.

  • Checking scenario pass and fail results
  • Comparing results before and after controller changes
  • Plotting vehicle distances from a recorded run
carla-simulator/carla14.5KUpdated Oct 18, 2026

audit-carla-docs

FreeSummary

Checks a local CARLA checkout for missing API documentation, outdated references, broken links, and pages absent from navigation. Produces a grouped Markdown report without building the project or running the simulator.

  • Reviewing documentation before a release
  • Finding missing or outdated API references
  • Checking broken links and navigation gaps
carla-simulator/carla14.5KUpdated Oct 18, 2026

build-carla-ue4

FreeSummary

Builds CARLA's ue4-dev branch on Linux, producing the Unreal Engine 4.26 editor, server modules, and an installed Python client package. Fetches required content, optionally compiles native ROS 2 support, and verifies the build against a source-built server.

  • Building CARLA ue4-dev from source
  • Compiling CARLA with native ROS 2 support
  • Building the Python client for an existing environment
carla-simulator/carla14.5KUpdated Oct 18, 2026

build-carla-ue58

FreeSummary

Build CARLA for Unreal Engine 5.8 using CMake, the tool that configures its build process. The skill guides engine setup, optional ROS 2 support, Python API rebuilding, editor builds, and checks that the expected files were actually produced.

  • Building CARLA for Unreal Engine 5.8
  • Building and verifying native ROS 2 support
  • Rebuilding the Python API after client changes
carla-simulator/carla14.5KUpdated Oct 18, 2026

See all skills by carla-simulator

Report a problem with this skill