ScenarioCharacterization: A Modular Toolkit for Characterizing Safety across Trajectory Datasets
Organizations: Robotics Institute, School of Computer Science, Carnegie Mellon University · Work done as part of an internship at Stack AV · Stack AV · Bosch Center for Artificial Intelligence
Abstract
We introduce ScenarioCharacterization, an open-source framework for automated, dataset-agnostic profiling of driving scenarios in trajectory datasets. Our framework is packaged as a modular, configuration-driven pipeline of three layers: a dataset adapter that maps custom datasets onto an open Scenario representation, a characterizer that performs feature extraction, behavior probing, and criticality scoring at scenario and agent levels, and an analysis layer for scenario visualization and feature, score, and probe analyses. Because the layers communicate only through Pydantic-validated schemas composed via configurations, a new dataset can easily plug in without rewriting the characterization and analysis stack. This technical report describes the design and APIs, shows example outputs on Waymo Open Motion, Argoverse2, and nuPlan, and discusses downstream uses of the approach. The framework is available at https://github.com/navarrs/ScenarioCharacterization.
Figures & tables
| Component Base Class | Entry point | Output |
| BaseDataset ( IV ) | transform(Raw Scenario) | Scenario |
| BaseFeature ( V-A ) | compute( Scenario ) | ScenarioFeatures |
| BaseScorer ( V-B ) | compute( Scenario , ScenarioFeatures ) | ScenarioScores |
| BehaviorProber ( V-C ) | probe( Scenario ) | ScenarioProbe |
| BaseVisualizer ( VI-B ) | visualize( Scenario ) | Rendered Scenario |
| Individual Features | Interaction Features |
| Speed, Acceleration, Jerk [ 4 ] | Time-to-Collision (TTC) [ 4 , 13 ] |
| Speed Limit Diff [ 4 ] | Time Headway (THW) [ 4 , 13 ] |
| Waiting Period at Conflict Point [ 4 , 13 ] | Deceleration Rate to Avoid Crash (DRAC) [ 4 , 13 ] |
| Trajectory Type [ 12 ] | Minimum Time to Conflict Point (mTTCP) [ 4 , 13 ] |
| Kalman Difficulty [ 12 , 22 ] | Collisions [ 4 , 13 ] |
| Trajectories | Ego interactions | |||||
| Dataset | Vehicles | Pedestrians | Cyclists | Ego-Vehicle | Ego-Pedestrian | Ego-Cyclist |
| WOMD [ 1 ] | 49.2 (290k) | 3.4 (37k) | 0.0 (2.6k) | 31.5 (215k) | 0.8 (18k) | 0.0 (2.1k) |
| Argoverse2 [ 2 ] | 37.8 (202k) | 2.8 (25k) | 0.5 (6.0k) | 25.8 (144k) | 1.1 (17k) | 0.2 (4.5k) |
| nuPlan [ 3 ] | 32.6 (174k) | 21.0 (194k) | 0.3 (3.2k) | 20.6 (127k) | 3.5 (112k) | 0.2 (2.5k) |
Autonomous Driving Safety Evaluation
Autonomous driving safety evaluation studies how to measure, test, and improve the safety of self-driving systems in routine and hazardous conditions.
See all 158 papers