QuadricFormer
[NeurIPS 2025] Scene as Superquadrics for 3D Semantic Occupancy Prediction
Install / Use
/learn @zuosc19/QuadricFormerREADME
QuadricFormer: Scene as Superquadrics for 3D Semantic Occupancy Prediction
Paper
QuadricFormer: Scene as Superquadrics for 3D Semantic Occupancy Prediction
Sicheng Zuo<sup>*</sup>, Wenzhao Zheng<sup>*</sup>$\dagger$, Xiaoyong Han<sup>*</sup>, Longchao Yang, Yong Pan, Jiwen Lu
<sup>*</sup> Equal contribution. $\dagger$ Project leader.
QuadricFormer proposes geometrically expressive superquadrics as scene primitives, enabling efficient and powerful object-centric representation of driving scenes.


Overview
We propose a probabilistic superquadric mixture model for efficient 3D occupancy prediction in autonomous driving scenes. Unlike previous methods based on dense voxels or ellipsoidal Gaussians, we leverage geometrically expressive superquadrics as scene primitives to effectively capture the diverse structures of real-world objects with fewer primitives. Our model interprets each superquadric as an occupancy distribution with geometry priors and aggregates semantics via probabilistic mixture. Additionally, we design a pruning-and-splitting module to dynamically allocate superquadrics in occupied regions, enhancing modeling efficiency. Extensive experiments on the nuScenes dataset demonstrate that QuadricFormer achieves state-of-the-art performance while significantly reducing computational costs.

Getting Started
Installation
Follow instructions HERE to prepare the environment.
Data Preparation
-
Download nuScenes V1.0 full dataset data HERE.
-
Download the occupancy annotations from SurroundOcc HERE and unzip it.
-
Download pkl files HERE.
-
Download the pretrained weights for the image backbone HERE and put it inside pretrain.
Folder structure
QuadricFormer
├── ...
├── data/
│ ├── nuscenes/
│ │ ├── maps/
│ │ ├── samples/
│ │ ├── sweeps/
│ │ ├── v1.0-test/
| | ├── v1.0-trainval/
│ ├── surroundocc/
│ │ ├── samples/
│ │ | ├── xxxxxxxx.pcd.bin.npy
│ │ | ├── ...
│ ├── nuscenes_temporal_infos_train.pkl
│ ├── nuscenes_temporal_infos_val.pkl
├── pretrain/
│ ├── r101_dcn_fcos3d_pretrain.pth
Inference
We provide the following model configs on the SurroundOcc dataset. Checkpoints will be released soon.
| Name | Repre | #Primitives | Latency | Memory| mIoU | | :---: | :---: | :---: | :---: | :---: | :---: | | GaussianFormer | Gaussians | 144000 | 372 ms | 6229 MB | 19.10 | | GaussianFormer-2 | Gaussians | 12800 | 451 ms | 4535 MB | 19.69 | | QuadricFormer-small | Quadrics | 1600 | 162 ms | 2554 MB | 20.04 | | QuadricFormer-base | Quadrics | 6400 | 165 ms | 2560 MB | 20.79 | | QuadricFormer-large | Quadrics | 12800 | 179 ms | 2563 MB | 21.11 |
Evaluate QuadricFormer on the SurroundOcc validation set:
bash scripts/eval_base.sh config/nusc_surroundocc_sq1600.py work_dir/ckpt.pth work_dir/xxxx
Train
Train QuadricFormer on the SurroundOcc validation set:
bash scripts/train_base.sh config/nusc_surroundocc_sq1600.py work_dir/xxxx
Visualize
Install packages for visualization according to the documentation.
Visualize QuadricFormer on the SurroundOcc validation set:
bash scripts/vis_base.sh config/nusc_surroundocc_sq1600.py work_dir/ckpt.pth scene-0098 work_dir/xxxx
Related Projects
Our work is inspired by these excellent open-sourced repos: TPVFormer PointOcc SelfOcc GaussianFormer SurroundOcc OccFormer BEVFormer
Citation
If you find this project helpful, please consider citing the following paper:
@article{zuo2025quadricformer,
title={QuadricFormer: Scene as Superquadrics for 3D Semantic Occupancy Prediction},
author={Zuo, Sicheng and Zheng, Wenzhao and Han, Xiaoyong and Yang, Longchao and Pan, Yong and Lu, Jiwen},
journal={arXiv preprint arXiv:2506.10977},
year={2025}
}
