Awesome
Palette: Image-to-Image Diffusion Models
Brief
This is an unofficial implementation of Palette: Image-to-Image Diffusion Models by Pytorch, and it is mainly inherited from its super-resolution version Image-Super-Resolution-via-Iterative-Refinement. The code template is from my another seed project: distributed-pytorch-template.
There are some implementation details with paper descriptions:
- We adapted the U-Net architecture used in
Guided-Diffusion
, which give a substantial boost to sample quality. - We used the attention mechanism in low-resolution features (16×16) like vanilla
DDPM
. - We encode the $\gamma$ rather than $t$ in
Palette
and embed it with affine transformation. - We fix the variance $Σ_\theta(x_t, t)$ to a constant during the inference as described in
Palette
.
Status
Code
- Diffusion Model Pipeline
- Train/Test Process
- Save/Load Training State
- Logger/Tensorboard
- Multiple GPU Training (DDP)
- EMA
- Metrics (now for FID, IS)
- Dataset (now for inpainting, uncropping, colorization)
- Google colab script 🌟(now for inpainting)
Task
I try to finish following tasks in order:
- Inpainting on CelebaHQ🚀 (Google Colab)
- Inpainting on Places2 with 128×128 centering mask🚀
The follow-up experiment is uncertain, due to lack of time and GPU resources:
- Uncropping on Places2
- Colorization on ImageNet val set
Results
The DDPM model requires significant computational resources, and we have only built a few example models to validate the ideas in this paper.
Visuals
Celeba-HQ
Results with 200 epochs and 930K iterations, and the first 100 samples in centering mask and irregular mask.
Places2 with 128×128 centering mask
Results with 16 epochs and 660K iterations, and the several picked samples in centering mask.
Uncropping on Places2
Results with 8 epochs and 330K iterations, and the several picked samples in uncropping.
Metrics
Tasks | Dataset | EMA | FID(-) | IS(+) |
---|---|---|---|---|
Inpainting with centering mask | Celeba-HQ | False | 5.7873 | 3.0705 |
Inpainting with irregular mask | Celeba-HQ | False | 5.4026 | 3.1221 |
Usage
Environment
pip install -r requirements.txt
Pre-trained Model
Dataset | Task | Iterations | GPUs×Days×Bs | URL |
---|---|---|---|---|
Celeba-HQ | Inpainting | 930K | 2×5×3 | Google Drive |
Places2 | Inpainting | 660K | 4×8×10 | Google Drive |
Bs indicates sample size per gpu.
Data Prepare
We get most of them from Kaggle, which may be slightly different from official version, and you also can download them from official website.
We use the default division of these datasets for training and evaluation. The file lists we use can be found in Celeba-HQ, Places2.
After you prepared own data, you need to modify the corresponding configure file to point to your data. Take the following as an example:
"which_dataset": { // import designated dataset using arguments
"name": ["data.dataset", "InpaintDataset"], // import Dataset() class
"args":{ // arguments to initialize dataset
"data_root": "your data path",
"data_len": -1,
"mask_mode": "hybrid"
}
},
More choices about dataloader and validation split also can be found in datasets
part of configure file.
Training/Resume Training
- Download the checkpoints from given links.
- Set
resume_state
of configure file to the directory of previous checkpoint. Take the following as an example, this directory contains training states and saved model:
"path": { //set every part file path
"resume_state": "experiments/inpainting_celebahq_220426_150122/checkpoint/100"
},
- Set your network label in
load_everything
function ofmodel.py
, default is Network. Follow the tutorial settings, the optimizers and models will be loaded from 100.state and 100_Network.pth respectively.
netG_label = self.netG.__class__.__name__
self.load_network(network=self.netG, network_label=netG_label, strict=False)
- Run the script:
python run.py -p train -c config/inpainting_celebahq.json
We test the U-Net backbone used in SR3
and Guided Diffusion
, and Guided Diffusion
one have a more robust performance in our current experiments. More choices about backbone, loss and metric can be found in which_networks
part of configure file.
Test
- Modify the configure file to point to your data following the steps in Data Prepare part.
- Set your model path following the steps in Resume Training part.
- Run the script:
python run.py -p test -c config/inpainting_celebahq.json
Evaluation
-
Create two folders saving ground truth images and sample images, and their file names need to correspond to each other.
-
Run the script:
python eval.py -s [ground image path] -d [sample image path]
Acknowledge
Our work is based on the following theoretical works:
- Denoising Diffusion Probabilistic Models
- Palette: Image-to-Image Diffusion Models
- Diffusion Models Beat GANs on Image Synthesis
and we are benefiting a lot from the following projects: