跳到正文
cccskills
免费在 GitHub 公开

query-recording

Inspect CARLA driving simulation logs without replaying them. Get recording details, find collisions by participant category, and identify vehicles that barely moved, with times and object IDs to locate moments worth reviewing.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Inspects a recorded CARLA .log without replaying it — show_recorder_file_info for the header/actors/frames, collision queries between actor categories, and blocked-actor queries for vehicles that got stuck. Use when the user asks to "what's in this recording", "show recorder info", "which vehicles collided", "find collisions in the log", or "which actors were blocked/stuck".

查看安装方法

适用场景

  • Check a recording's map, duration, frames, and participants
  • Find collisions between vehicles and pedestrians
  • Identify vehicles that remained stuck
  • Locate times and object IDs for a targeted replay

包含的文件(5)

  • SKILL.md4.0 KB
  • references/queries.md2.1 KB
  • scripts/check_env.sh2.1 KB
  • scripts/env.sh1.3 KB
  • scripts/query.py3.3 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Query a CARLA recording

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.

Read facts out of a .log without replaying it. The server parses the file and returns a text report. Three questions:

  • What's in it? — info (header: map, duration, frames, actor list).
  • What crashed? — collisions between two actor categories.
  • What got stuck? — blocked actors that barely moved.

Instructions

Progress:
- [ ] Step 1: Check prerequisites (bash scripts/check_env.sh), clear FAILs
- [ ] Step 2: Run the query that answers the question (info / collisions / blocked)
- [ ] Step 3: Read the report; use ids/times to drive a targeted replay if needed

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

Step 1: Check prerequisites

bash scripts/check_env.sh

Step 2: Query

source scripts/env.sh

# header + actors (add --all for every frame; large)
python3 scripts/query.py info --file /tmp/run.log

# collisions: category codes h=hero v=vehicle w=walker t=traffic-light o=other a=any
python3 scripts/query.py collisions --file /tmp/run.log --type1 v --type2 a   # any vehicle vs anything
python3 scripts/query.py collisions --file /tmp/run.log --type1 v --type2 w   # vehicle vs walker

# actors that moved < 1 m (100 cm) over >= 30 s (stuck)
python3 scripts/query.py blocked --file /tmp/run.log --min-time 30 --min-distance 100

Units matter: --min-time is seconds, --min-distance is centimetres (100 = 1 m).

Step 3: Act on it

The reports give frames, times and actor ids — feed them to replay-recording (--start, --follow) to jump to and watch the interesting moment.

Examples

Example 1: overview

User says: "what's in /tmp/run.log?"

info --file /tmp/run.log → map, duration, frame count, actors.

Example 2: find a crash

User says: "did any car hit a pedestrian?"

collisions --file /tmp/run.log --type1 v --type2 w. Each line gives the frame, time and the two actor ids; then replay play --start <t> --follow <id>.

Example 3: find gridlock

User says: "which cars got stuck?"

blocked --file /tmp/run.log --min-time 20 --min-distance 50 (moved < 0.5 m in 20 s).

Troubleshooting

Problem: parse error / empty report Cause: the .log is not on the server at that path, or has no frames. Solution: use the server-side path; confirm the recording with info first.

Problem: collisions returns nothing but I saw a crash Cause: wrong categories, or collisions need additional_data context. Solution: widen with --type2 a (any); ensure the recording captured the actors.

Problem: blocked lists everything / nothing Cause: --min-distance unit confusion (centimetres, not metres). Solution: 100 = 1 m; raise --min-time to ignore brief stops at lights.

Outputs

Text reports printed to stdout (no world change, no file written). Use them to target a replay-recording.

Detail (report fields, category codes, blocked-query semantics) in references/queries.md.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

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/carla1.5万2026年10月22日 更新

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/carla1.5万2026年10月22日 更新

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/carla1.5万2026年10月22日 更新

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/carla1.5万2026年10月22日 更新

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.

中文简介正在准备中。当前显示英语简介。

  • Adding vehicle boxes to a camera image
  • Exporting box coordinates for detection annotations
  • Checking vehicle dimensions
carla-simulator/carla1.5万2026年10月22日 更新

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/carla1.5万2026年10月22日 更新

查看 carla-simulator 的全部技能

报告此技能的问题