query-recording

Inspect CARLA .log recordings for header info, collisions, and blocked actors without replaying them.

3|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/carla-simulator/carla-agentic-tools --skill query-recording-carla-simulator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: query-recording
Source: https://github.com/carla-simulator/carla-agentic-tools/tree/main/skills/python-api/query-recording
Command: npx skills add https://github.com/carla-simulator/carla-agentic-tools --skill query-recording-carla-simulator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires carla, and includes scripts (resource) and references (resource) components.

What problem does it solve? Replaying an entire CARLA simulation recording just to answer a simple question — what map was used, which vehicles collided, which actors got stuck — wastes time. This Skill reads facts directly out of a recorded .log file on the server and returns text reports, so you can diagnose a run without touching the simulation world. ## Core Features & Use Cases - Recording overview: Run the info query to get the map, duration, frame count, and full actor list from a .log header, with an optional --all flag for per-frame detail. - Collision queries: Find recorded collisions between actor categories (hero, vehicle, walker, traffic light, other, any) using show_recorder_collisions, with each row giving frame, time, and actor ids. - Blocked-actor detection: Identify vehicles that moved less than a threshold distance (in centimetres) over a minimum time (in seconds) to spot gridlock or wedged actors. - Use Case: After recording a traffic scenario, ask "did any car hit a pedestrian?" — the collisions query with --type1 v --type2 w returns the exact frames and actor ids, which you then feed to the replay-recording skill to watch that moment. ## Quick Start Ask the agent to show what is inside your recording, for example: "what's in /tmp/run.log and did any vehicles collide with walkers?"

Frequently Asked Questions about query-recording

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I see what is inside a CARLA recording .log file?▼

Run the info query, which calls the server's show_recorder_file_info on the .log path. It returns the map, duration, frame count, and actor list; add --all to include every frame's state, though that output is very large on long logs.

How do I find collisions in a CARLA recording?▼

Use the collisions query with two category codes, for example --type1 v --type2 w for vehicle versus walker. Categories are h (hero), v (vehicle), w (walker), t (traffic light), o (other), and a (any); each result row gives the frame, time, and both actor ids.

How do I detect stuck or blocked vehicles in a CARLA log?▼

Use the blocked query with --min-time in seconds and --min-distance in centimetres, for example --min-time 30 --min-distance 100 finds actors that moved under 1 metre in 30 seconds. Raise min-time to ignore normal stops at red lights.

Does querying a CARLA recording require replaying the simulation?▼

No. All three queries ask the server to parse the .log and return a text report without changing the world or writing files. The .log must exist on the server's filesystem, and an absolute server-side path is recommended.

Why does the CARLA collisions query return nothing when a crash happened?▼

The category codes may be too narrow, or one party was not captured in the recording. Widen the search with --type2 a (any) and confirm with the info query that both actors were actually recorded.

What are the prerequisites for querying a CARLA recording?▼

You need the carla Python module importable by the active interpreter and a reachable, already-running CARLA server set via CARLA_HOST and CARLA_PORT. UE4_ROOT is not required, and the check_env.sh script verifies both prerequisites before any query runs.