How It Works
1
Upload an MCAP file
Upload your MCAP or ROS bag file to a dataset. The platform extracts the topic list and schema metadata from the recording.
2
Topics are detected
Each topic is classified by schema type and keyword matching. For example, a
sensor_msgs/PointCloud2 topic is identified as 3D point cloud data, while a topic named /camera/front/compressed is identified as an image stream.3
Panels are assigned
Every detected topic is mapped to one of eight panel types. The viewer selects the panel that best represents the data — image panels for cameras, 3D panels for LiDAR, plot panels for IMU, and so on.
4
Layout is built
The layout engine arranges panels into a three-column layout optimized for the specific combination of topics in your recording. Image panels are arranged in a smart grid, while plots and other secondary data are placed below.
5
Playback is ready
All panels are synchronized to a shared timeline. Navigate frame-by-frame, seek to any timestamp, or play back the full recording.
Panel Types
The viewer supports eight panel types. Each panel is automatically assigned based on the topic’s schema and name.Layout System
The viewer uses a three-column layout that adapts to the topics in your recording.Column Structure
Smart Image Grid
When multiple image topics are present, the center area arranges them in an optimized grid:Mixed-Type Splitting
When the recording contains both spatial data (images, point clouds) and time-series data (plots, gauges), the center area splits vertically:- Top 70% — Image and 3D / Point Cloud panels
- Bottom 30% — Plot, Gauge, and other secondary panels
Auto-Detection
The viewer classifies topics using two methods, applied in order.Schema-Based Detection
When a topic uses a known schema, the viewer assigns the panel type directly:Keyword-Based Detection
When a topic does not match a known schema by exact name, the viewer checks for keywords in the schema name and topic name:Synchronized Playback
All panels in the viewer share a single timeline. Playback controls include:- Play / Pause — Stream all panels at the recording’s original rate
- Frame stepping — Advance or rewind one frame at a time across all panels
- Timestamp seeking — Jump to any point in the recording; all panels update simultaneously
- Playback speed — Adjust playback rate for slow-motion or fast-forward review
Multi-Camera Support
Recordings with multiple camera topics are fully supported:- Grid display — All camera streams are arranged in the smart image grid within the center area
- Calibration-aware projection — When camera intrinsics and extrinsics are present in the recording, LiDAR points can be projected onto camera images for visual verification
- Independent zoom — Each camera panel can be zoomed and panned independently while maintaining timeline synchronization
Next Steps
Panel Types
Detailed reference for each of the eight panel types and their configuration options.
MCAP / ROS Overview
Supported MCAP and ROS formats, schemas, and data pipeline setup.