Skip to content

MBadran2000/DiffuDETR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Project Page Paper Hugging Face Weights

DiffuDETR: Rethinking Detection Transformers with Denoising Diffusion Process

Youssef Nawar*Β Β Β Mohamed Badran*Β Β Β Marwan Torki

Alexandria University Β Β·Β  Technical University of Munich Β Β·Β  Applied Innovation Center

* Equal Contribution


DiffuDETR Framework

DiffuDETR reformulates object detection as a conditional query generation task using denoising diffusion, improving strong baselines on COCO, LVIS, and V3Det.


πŸ”₯ Highlights

51.9

mAP on COCO
+1.0 over DINO

28.9

AP on LVIS
+2.4 over DINO

50.3

AP on V3Det
+8.3 over DINO

3Γ—

Decoder Passes
Only ~17% Extra FLOPs
  • 🎯 Diffusion-Based Query Generation β€” Reformulates object detection in DETR as a denoising diffusion process, progressively denoising queries' reference points from Gaussian noise to precise object locations
  • πŸ—οΈ Two Powerful Variants β€” DiffuDETR (built on Deformable DETR) and DiffuDINO (built on DINO with contrastive denoising queries), demonstrating the generality of our approach
  • ⚑ Efficient Inference β€” Only the lightweight decoder runs multiple times; backbone and encoder execute once, adding just ~17% extra FLOPs with 3 decoder passes
  • πŸ“Š Consistent Gains Across Benchmarks β€” Improvements on COCO 2017, LVIS, and V3Det across multiple backbones (ResNet-50, ResNet-101, Swin-B) with high multi-seed stability (Β±0.2 AP)

πŸ“‹ Abstract

We present DiffuDETR, a novel approach that formulates object detection as a conditional object query generation task, conditioned on the image and a set of noisy reference points. We integrate DETR-based models with denoising diffusion training to generate object queries' reference points from a prior Gaussian distribution. We propose two variants: DiffuDETR, built on top of the Deformable DETR decoder, and DiffuDINO, based on DINO's decoder with contrastive denoising queries. To improve inference efficiency, we further introduce a lightweight sampling scheme that requires only multiple forward passes through the decoder.

Our method demonstrates consistent improvements across multiple backbones and datasets, including COCO 2017, LVIS, and V3Det, surpassing the performance of their respective baselines, with notable gains in complex and crowded scenes.


πŸ›οΈ Method

Decoder Architecture
Decoder Architecture β€” Timestep embeddings are injected after self-attention, followed by multi-scale deformable cross-attention with noisy reference points attending to encoded image features.

How It Works

Step Description
Feature Extraction A backbone (ResNet / Swin) + transformer encoder extracts multi-scale image features
Forward Diffusion (training) Ground-truth box coordinates are corrupted with Gaussian noise at a random timestep $t \sim U(0, 100)$ via a cosine noise schedule
Reverse Denoising (inference) Reference points start as pure Gaussian noise and are iteratively denoised using DDIM sampling with only 3 decoder forward passes
Timestep Conditioning The decoder integrates timestep embeddings after self-attention: $q_n = \text{FFN}(\text{MSDA}(\text{SA}(q_{n-1}) + t), r_t, O_{\text{enc}})$

πŸ“Š Main Results

COCO 2017 val β€” Object Detection

Model Backbone Epochs AP APβ‚…β‚€ AP₇₅ APβ‚› APβ‚˜ APβ‚—
Pix2Seq R50 300 43.2 61.0 46.1 26.6 47.0 58.6
DiffusionDet R50 β€” 46.8 65.3 51.8 29.6 49.3 62.2
Deformable DETR R50 50 48.2 67.0 52.2 30.7 51.4 63.0
Align-DETR R50 24 51.4 69.1 55.8 35.5 54.6 65.7
DINO R50 36 50.9 69.0 55.3 34.6 54.1 64.6
DiffuDETR (Ours) R50 50 50.2 (+2.0) 66.8 55.2 33.3 53.9 65.8
DiffuAlignDETR (Ours) R50 24 51.9 (+0.5) 69.2 56.4 34.9 55.6 66.2
DiffuDINO (Ours) R50 50 51.9 (+1.0) 69.4 55.7 35.8 55.7 67.1
Pix2Seq R101 300 44.5 62.8 47.5 26.0 48.2 60.3
DiffusionDet R101 β€” 47.5 65.7 52.0 30.8 50.4 63.1
Align-DETR R101 12 51.2 68.8 55.7 32.9 55.1 66.6
DINO R101 12 50.0 67.7 54.4 32.2 53.4 64.3
DiffuAlignDETR (Ours) R101 12 51.7 (+0.5) 69.3 56.1 34.0 55.6 67.0
DiffuDINO (Ours) R101 12 51.2 (+1.2) 68.6 55.8 33.2 55.6 67.2

LVIS val β€” Large Vocabulary Detection

Model Backbone AP APβ‚…β‚€ APr APc APf
DINO R50 26.5 35.9 9.2 24.6 36.2
DiffuDINO (Ours) R50 28.9 (+2.4) 38.5 13.7 (+4.5) 27.6 36.9
DINO R101 30.9 40.4 13.9 29.7 39.7
DiffuDINO (Ours) R101 32.5 (+1.6) 42.4 13.5 32.0 41.5

V3Det val β€” Vast Vocabulary Detection (13,204 categories)

Model Backbone AP APβ‚…β‚€ AP₇₅
DINO R50 33.5 37.7 35.0
DiffuDINO (Ours) R50 35.7 (+2.2) 41.4 37.7
DINO Swin-B 42.0 46.8 43.9
DiffuDINO (Ours) Swin-B 50.3 (+8.3) 56.6 52.9

πŸ“ˆ Convergence & Qualitative Results

Convergence Comparison
Training Convergence β€” COCO val2017 AP (%) vs. training epochs. DiffuDINO converges to the highest AP, surpassing all baseline methods.

Qualitative Comparison
Qualitative Comparison β€” Deformable DETR vs. DiffuDETR and DINO vs. DiffuDINO on COCO 2017 val. Our models produce more accurate and complete detections, especially in crowded scenes.

πŸ”¬ Ablation Studies

All ablations on COCO 2017 val with DiffuDINO (R50 backbone).

Ablation Setting AP
Noise Distribution Gaussian (best) 51.9
Sigmoid 50.4
Beta 49.5
Noise Scheduler Cosine (best) 51.9
Linear 51.6
Sqrt 51.4
Decoder Evaluations 1 eval 51.6
3 evals (best) 51.9
5 evals 51.8
10 evals 51.4
FLOPs 1 eval β†’ 244.5G β€”
3 evals β†’ 285.2G (+17%) β€”
5 evals β†’ 326.0G β€”

πŸ›‘οΈ Multi-Seed Robustness: Across 5 random seeds, standard deviation remains below Β±0.2 AP in all settings.


πŸ› οΈ Installation

DiffuDETR is built on top of detrex and detectron2.

Prerequisites

  • Linux with Python β‰₯ 3.11
  • PyTorch β‰₯ 2.3.1 and corresponding torchvision
  • CUDA 12.x

Step-by-Step Setup

# 1. Create and activate conda environment
conda create -n diffudetr python=3.11 -y
conda activate diffudetr

# 2. Install PyTorch
pip install torch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1 --index-url https://download.pytorch.org/whl/cu121

# 3. Clone and install detrex
git clone https://github.com/IDEA-Research/detrex.git
cd detrex
git submodule init
git submodule update

# 4. Install detectron2
python -m pip install -e detectron2 --no-build-isolation

# 5. Install detrex
pip install -e . --no-build-isolation

# 6. Fix setuptools compatibility
pip uninstall setuptools -y
pip install "setuptools<81"

# 7. Install additional dependencies
pip install pytorch_metric_learning lvis

# 8. Add DiffuDETR to PYTHONPATH
export PYTHONPATH="/path/to/DiffuDETR/:$PYTHONPATH"

# 9. Set dataset path
export DETECTRON2_DATASETS=/path/to/datasets/

Dataset Preparation

Organize your datasets as follows:

$DETECTRON2_DATASETS/
β”œβ”€β”€ coco/
β”‚   β”œβ”€β”€ train2017/
β”‚   β”œβ”€β”€ val2017/
β”‚   └── annotations/
β”œβ”€β”€ lvis/
β”‚   β”œβ”€β”€ train2017/  (symlink to coco/train2017)
β”‚   β”œβ”€β”€ val2017/    (symlink to coco/val2017)
β”‚   └── annotations/
└── v3det/
    β”œβ”€β”€ images/
    └── annotations/

πŸš€ Usage

Training

# DiffuDINO with ResNet-50 on COCO
python /path/to/detrex/tools/train_net.py \
    --num-gpus 2 \
    --config-file projects/diffu_dino/configs/dino-resnet/coco-r50-4scales-50ep.py

# DiffuDINO with ResNet-101 on COCO
python /path/to/detrex/tools/train_net.py \
    --num-gpus 2 \
    --config-file projects/diffu_dino/configs/dino-resnet/coco-r101-4scales-12ep.py

# DiffuDINO on V3Det
python /path/to/detrex/tools/train_net.py \
    --num-gpus 2 \
    --config-file projects/diffu_dino/configs/dino-resnet/v3det-r50-4scales-24ep.py

# DiffuAlignDETR on COCO
python /path/to/detrex/tools/train_net.py \
    --num-gpus 2 \
    --config-file projects/diffu_align_detr/configs/coco-r50-4scales-24ep.py

Evaluation

python /path/to/detrex/tools/train_net.py \
    --num-gpus 2 \
    --eval-only \
    --config-file projects/diffu_dino/configs/dino-resnet/coco-r50-4scales-50ep.py \
    train.init_checkpoint=/path/to/checkpoint.pth

πŸ“ Project Structure

DiffuDETR/
β”œβ”€β”€ layers_diffu_detr/           # Core diffusion layers
β”‚   β”œβ”€β”€ attention.py             # Attention mechanisms
β”‚   β”œβ”€β”€ bbox_embedd.py           # Box embedding utilities
β”‚   β”œβ”€β”€ denoising.py             # Diffusion denoising logic
β”‚   β”œβ”€β”€ ldm/                     # Latent diffusion modules
β”‚   β”œβ”€β”€ transformer.py           # Timestep-conditioned transformer
β”‚   β”œβ”€β”€ multi_scale_deform_attn.py
β”‚   └── ...
β”œβ”€β”€ projects/
β”‚   β”œβ”€β”€ diffu_dino/              # DiffuDINO model & configs
β”‚   β”‚   β”œβ”€β”€ configs/
β”‚   β”‚   β”‚   β”œβ”€β”€ dino-resnet/     # ResNet backbone configs
β”‚   β”‚   β”‚   └── dino-swin/       # Swin Transformer configs
β”‚   β”‚   β”œβ”€β”€ modeling/            # Model definitions
β”‚   β”‚   └── train_net.py         # Training script
β”‚   └── diffu_align_detr/        # DiffuAlignDETR model & configs
β”‚       β”œβ”€β”€ configs/
β”‚       └── modeling/
β”œβ”€β”€ datasets_utils/              # Dataset registration & configs
β”‚   β”œβ”€β”€ lvis_detr.py
β”‚   β”œβ”€β”€ v3det.py
β”‚   └── ...
└── docs/                        # Project page & figures

πŸ“ Citation

If you find DiffuDETR useful in your research, please consider citing our paper:

@inproceedings{nawar2026diffudetr,
  title     = {DiffuDETR: Rethinking Detection Transformers with Denoising Diffusion Process},
  author    = {Nawar, Youssef and Badran, Mohamed and Torki, Marwan},
  booktitle = {International Conference on Learning Representations (ICLR)},
  year      = {2026}
}

πŸ™ Acknowledgements

This project is built upon the following open-source works:

  • detrex β€” Benchmarking Detection Transformers
  • detectron2 β€” Facebook AI Research's detection library
  • DINO β€” DETR with Improved DeNoising Anchor Boxes
  • AlignDETR β€” Improving DETR with IoU-Aware BCE Loss
  • DiffusionDet β€” Diffusion Model for Object Detection

πŸ“„ License

This project is released under the Apache 2.0 License.


About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors