IllumiDiff: Indoor Illumination Estimation from a Single Image with Diffusion Model (TVCG 2025)

Shiyuan Shen, Zhongyun Bao, Wenju Xu, Chunxia Xiao

Paper | PDF | HomePage

Differences from the original paper

1. Upgrade LDM to Stable Diffusion 1.5, using input images instead of text prompts.
2. Replace Latent HDR Guidance with an equivalent substitution using ControlNet, with the aim of accelerating the fine-tuning process.
3. (2025-10-04) Add the pre-trained model for outdoor (trained on Poly Haven and Laval Outdoor).

Structure

IllumiDiff/
├── ckpts/                        # Pre-trained model checkpoints
├── lighting_est/                 # Stage 1 (id_net, sg_net, asg_net) & Stage 3 (hdr_net)
│   ├── asg_fitting_fixed_ldr_adam_batch.py   # ASG ground truth fitting
│   ├── sg_fitting_free_nadam.py              # SG ground truth fitting
│   ├── dataset.py                            # Dataset loader (Stage 1 & 3)
│   ├── dataset_processing.py                 # Dataset preprocessing scripts
│   ├── models.py                             # Model definitions (Stage 1 & 3)
│   ├── modules.py                            # Lightning modules (Stage 1 & 3)
├── pano_gen/                    # Stage 2: panorama generation
│   ├── cldm/                                 # ControlNet core
│   ├── configs/                              # Model configuration files
│   ├── ldm/                                  # Latent Diffusion Model core
│   ├── openai/                               # OpenAI CLIP model
│   ├── dataset.py                            # Dataset loader (Stage 2)
│   ├── pano_tools.py                         # Panorama projection tools
│   ├── tool_add_control.py                   # Checkpoint initialization
│   ├── outpainting-mask.png                  # Outpainting mask
├── inference_lighting_est.py     # Inference script (Stage 1 or 3)
├── inference_pano_gen.py         # Inference script (Stage 2)
├── pipeline_lighting_est.py      # Lighting estimation pipeline (Stage 1 or 3)
├── pipeline_full.py              # Full pipeline (Stage 1 & 2 & 3)
├── train_lighting_est.py         # Training script (Stage 1 or 3)
├── train_pano_gen.py             # Training script (Stage 2)

TODO or not to do

• Config files for all networks.
• Simplify LDM code.
• Full dataset process script.
• Training all stages together.

Environment

conda create -n illumidiff python=3.10
conda activate illumidiff
conda install pytorch==2.2.2 torchvision==0.17.2 pytorch-cuda=11.8 numpy=1.26.4 -c pytorch -c nvidia
conda install lightning -c conda-forge
pip install -r requirements.txt

Checkpoints

You can download them from OneDrive. (2025-10-04 Update on outdoor)

Unzip clip-vit-base-patch32.zip to IllumiDiff/pano_gen/openai/clip-vit-base-patch32/,

put all ckpts into IllumDiff/ckpts/,

control_sd15_clip_asg_sg.ckpt is required only when training from scratch.

Inference

Full pipeline inference, where the input is a single image:

python pipeline_full.py --input_path <path> --output_path <path>

Inference for Stage 1 or Stage 3 only:

python pipeline_lighting_est.py --input_path <path> --input_pano_path <path> --output_path <path>

Single network only:

for id_net, sg_net, asg_net, or hdr_net:

python inference_lighting_est.py --task <network>

for pano_gen:

python inference_pano_gen.py

Dataset

See more details in the paper.

Training

All networks are trained separately.

For id_net, sg_net, asg_net or hdr_net:

python train_lighting_est.py --task <network>

For pano_gen:

python train_pano_gen.py --ckpt_path <path> --config_path <path>

Contact

For questions, please contact: syshen@whu.edu.cn

References

ControlNet

LDM

Skylibs

Citation

@article{shen2025illumidiff,
  title={IllumiDiff: Indoor Illumination Estimation from a Single Image with Diffusion Model},
  author={Shen, Shiyuan and Bao, Zhongyun and Xu, Wenju and Xiao, Chunxia},
  journal={IEEE transactions on visualization and computer graphics},
  year={2025},
  publisher={IEEE}
}