DriveAdapter: New Paradigm for End-to-End Autonomous Driving to Alleviate Causal Confusion
July 2, 2025 ยท View on GitHub
Important
๐ Stay up to date at opendrivelab.com!
DriveAdapter: New Paradigm for End-to-End Autonomous Driving to Alleviate Causal Confusion
DriveAdapter: Breaking the Coupling Barrier of Perception and Planning in End-to-End Autonomous Driving
- arXiv Paper, accepted at ICCV 2023 (Oral)
Getting Started
- Installation
- Closed-Loop Evaluation in Carla
- Prepare Dataset
- Train Your Own Model
- Calibrations for Different Camera Settings (Optional)
Quick Run in Carla
- Install the environment as stated in Installation
- Download the checkpoint
189K frames Training Set: GoogleDrive or BaiduYun(ๆๅ็ 9xou)2M frames Training Set: GoogleDrive or BaiduYun(ๆๅ็ g6ki)
- Put it into open_loop_training/ckpt, and run:
## In the DriveAdapter/ directory
CUDA_VISIBLE_DEVICES=0 nohup bash ./leaderboard/scripts/evaluation_town05long.sh 22023 22033 driveadapter_agent False True open_loop_training/ckpt/driveadapter_2m.pth+open_loop_training/configs/driveadapter.py all_towns_traffic_scenarios_no256 driveadapter_town05long 2>&1 > driveadapter_town05long.log &
Check closed_loop_eval_log/eval_log to see how our model drives in Carla! :oncoming_automobile:
In case you have a screen to see the interface of Carla simulator, you could remove
DISPLAY=in leaderboard/leaderboard/leaderboard_evaluator.py and then you could watch with Carla straight ahead.
Code Structure
We give the structure of our code. Note that we only introduce those folders/files are commonly used and modified.
DriveAdapter/
โโโ agents # From Carla official
โโโ camera_calibration # When you want to use cameras with different FOV
โโโ closed_loop_eval_log # Save eval logs
โโโ collect_data_json # Save data collection logs
โโโ dataset # Data and metadata for training
โโโ leaderboard # Code for Closed-Loop Evaluation
โ โโโ data # Save routes and scenarios
โ โโโ scripts # Run with Carla
โ โโโ team_code # Your
| | โโโ roach_ap_agent_data_collection.py # Data collection
โ | โโโ driveadapter_agent.py # Interface for closed-loop evaluation of our model
โ โโโ leaderboard # From Carla official
| | โโโ leaderboard_evaluator.py # Entrance of closed-loop evaluation
โโโ roach # Roach for data collection
โโโ scenario_runner # From Carla official
โโโ open_loop_training # Training and Neural Network
| โโโ ckpt # Checkpoints
| โโโ work_dirs # Training Log
| โโโ code # Preprocessing, DataLoader, Model
| โ โโโ apis # Training pipeline for mmdet3D
| โ โโโ core # The hooks for mmdet3D
| โ โโโ datasets # Preprocessing and DataLoader
| | | โโโ pipelines # Functions of Preprocessing and DataLoader
| โ | โโโ samplers # For DDP
| โ | โโโ carla_dataset.py # Framework of Preprocessing and DataLoading
| โ โโโ model_code # Neural Network
| | | โโโ backbones # Module of Encoder
| | | โโโ dense_heads # Module of Decoder and Loss Functions
| โ โโโ encoder_decoder_framework.py # Entrance of Neural Network
| โโโ train.py # Entrance of Training
License
All assets and code are under the Apache 2.0 license unless specified otherwise.
Bibtex
If this work is helpful for your research, please consider citing the following BibTeX entry.
@inproceedings{jia2023driveadapter,
title={DriveAdapter: Breaking the Coupling Barrier of Perception and Planning in End-to-End Autonomous Driving},
author={Jia, Xiaosong and Gao, Yulu and Chen, Li and Yan, Junchi and Liu, Patrick Langechuan and Li, Hongyang},
booktitle={ICCV},
year={2023}
}
DriveAdapter is developed based on our prior work ThinkTwice, have a look if you are interested and please consider citing if you find it helpful:
@inproceedings{jia2023thinktwice,
title={Think Twice before Driving: Towards Scalable Decoders for End-to-End Autonomous Driving},
author={Jia, Xiaosong and Wu, Penghao and Chen, Li and Xie, Jiangwei and He, Conghui and Yan, Junchi and Li, Hongyang},
booktitle={CVPR},
year={2023}
}
One More Thing: End-to-End Autonomous Driving
From an OpenDriveLab Perspective

Check out the latest End-to-end Autonomous Driving Survey for more information!
Related Resources
Many thanks to the open-source community!
- ThinkTwice (:rocket:Ours!)
- End-to-end Autonomous Driving Survey (:rocket:Ours!)
- TCP (:rocket:Ours!)
- PPGeo (:rocket:Ours!)
- BEVFormer (:rocket:Ours!)
- UniAD (:rocket:Ours!)
- ST-P3 (:rocket:Ours!)
- Carla
- Roach
- BEVFusion
- Mask2Former
- BEVDepth
- Transfuser
- CARLA_GARGE
- LAV
- IBISCape