How spa-junghokim/safedrive works
SafeDrive is a NAVSIM end-to-end driving agent with perception, planning, and fine-grained safety reasoning. Its main workflow builds scenario features, runs the SafeDrive model to predict a plan, and evaluates predictions with PDM scoring. Training includes dataset/feature-target processing and, as documented, PDM-simulator rollouts for safety supervision; metric caching and visualization are supporting product capabilities. Several runtime modules are unsampled, so links to them are shown only where the README or source index supports them.
Main entry points: safedrive_model.py SafeDrive model · safedrive_features.py Feature builders · agent_lightning_module.py Training module · safedrive_agent.py SafeDrive agent
Components 19
SafeDrive Agent
- Feature builders
navsim/agents/safedrive/safedrive_features.py - SafeDrive agent
navsim/agents/safedrive/safedrive_agent.py - SafeDrive model
navsim/agents/safedrive/safedrive_model.py - BEV backbone
navsim/agents/safedrive/safedrive_backbone.py - Detection and motion modules
navsim/agents/safedrive/modules - Safety and planning loss
navsim/agents/safedrive/safedrive_loss.py
NAVSIM Data
- Scenario builder
navsim/planning/scenario_builder/navsim_scenario.py - Scenario utilities
navsim/planning/scenario_builder/navsim_scenario_utils.py - Sensor and trajectory data
navsim/common/dataclasses.py
PDM Planning
- PDM observations
navsim/planning/simulation/planner/pdm_planner/observation/pdm_observation.py - Trajectory proposals
navsim/planning/simulation/planner/pdm_planner/proposal/pdm_generator.py - PDM simulator
navsim/planning/simulation/planner/pdm_planner/simulation/pdm_simulator.py - PDM scorer
navsim/planning/simulation/planner/pdm_planner/scoring/pdm_scorer.py
Training and Evaluation
- Training dataset
navsim/planning/training/dataset.py - Training module
navsim/planning/training/agent_lightning_module.py - Metric caching
navsim/planning/metric_caching - PDM evaluation
navsim/evaluate/pdm_score.py - Scene visualization
navsim/visualization/bev.py
Other components
- Agent user
Connections 21
- Agent user → SafeDrive agent: requests trajectory
- SafeDrive agent → Feature builders: builds features
- Feature builders → Scenario utilities: uses scenario data
navsim/agents/safedrive/safedrive_features.py - Scenario builder → Scenario utilities: uses utilities
navsim/planning/scenario_builder/navsim_scenario.py - Feature builders → Sensor and trajectory data: produces inputs
navsim/agents/safedrive/safedrive_features.py - SafeDrive agent → SafeDrive model: runs inference
- SafeDrive model → BEV backbone: builds BEV features
navsim/agents/safedrive/safedrive_model.py - SafeDrive model → Detection and motion modules: uses transformers
navsim/agents/safedrive/safedrive_model.py - SafeDrive model → Feature builders: consumes features
navsim/agents/safedrive/safedrive_model.py - SafeDrive model → Safety and planning loss: trains with loss
- Training dataset → Sensor and trajectory data: loads samples
- Training dataset → Scenario builder: builds targets
- Training module → SafeDrive model: trains agent
- Training module → Safety and planning loss: computes loss
- Training module → PDM simulator: rolls out plans
README.md - PDM observations → PDM observations: indexes occupancy maps
navsim/planning/simulation/planner/pdm_planner/observation/pdm_observation.py - Trajectory proposals → PDM observations: reads observations
navsim/planning/simulation/planner/pdm_planner/proposal/pdm_generator.py - PDM evaluation → PDM simulator: simulates trajectory
navsim/evaluate/pdm_score.py - PDM evaluation → PDM scorer: scores trajectory
navsim/evaluate/pdm_score.py - Metric caching → PDM scorer: computes cached metrics
navsim/planning/metric_caching/train_cache_processor.py - Scene visualization → Scenario utilities: uses scene geometry
navsim/visualization/bev.py