Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nv-tlabs/datasetGAN_release


https://github.com/nv-tlabs/datasetGAN_release

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README 

        

# DatasetGAN



This is the official code and data release for:



#### DatasetGAN: Efficient Labeled Data Factory with Minimal Human Effort



[Yuxuan Zhang*](https://www.alexyuxuanzhang.com/), [Huan Ling*](http://www.cs.toronto.edu/~linghuan/), [Jun Gao](http://www.cs.toronto.edu/~jungao/), [Kangxue Yin](https://kangxue.org/), [Jean-Francois Lafleche](), [Adela Barriuso](), [Antonio Torralba](https://groups.csail.mit.edu/vision/torralbalab/), [Sanja Fidler](http://www.cs.toronto.edu/~fidler/)



\* authors contributed equally 



**CVPR'21, Oral** **[[paper](https://arxiv.org/abs/2104.06490)] [[supplementary](https://drive.google.com/file/d/1td1nP8FP0axHXFxl9_EXCtHQHhnaUQl8/view?usp=sharing)] [[Project Page](https://nv-tlabs.github.io/datasetGAN/)]**






## News



- Benchmark Challenge - A benchmark with diversed testing images is coming soon -- stay tuned!



- Generated dataset for downstream tasks is coming soon -- stay tuned!



- **New version released under [[EditGAN](https://github.com/nv-tlabs/editGAN_release)].**.  

   :white_check_mark: Training on real images with encoder.  

   :white_check_mark: Support Stylegan2 backbone.  

   :white_check_mark: Support high precision semantic editing.  

      

   

## License



For any code dependency related to Stylegan, the license is under the [Creative Commons BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) license by NVIDIA Corporation.  To view a copy of this license, visit [LICENSE](https://github.com/NVlabs/stylegan/blob/master/LICENSE.txt ).



The code of DatasetGAN is released under the MIT license. See [LICENSE](https://github.com/nv-tlabs/datasetGAN_release/blob/release_finallll/LICENSE.txt) for additional details.



The dataset of DatasetGAN is released under the [Creative Commons BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) license by NVIDIA Corporation. You can **use, redistribute, and adapt** the material for **non-commercial purposes**, as long as you give appropriate credit by **citing our paper** and **indicating any changes** that you've made.



## Requirements



- Python 3.6  is supported.

- Pytorch 1.4.0.

- This code is tested with CUDA 10.1 toolkit and CuDNN 7.5.

- All results in our paper are based on Nvidia Tesla V100 GPUs with 32GB memory. 

- Please check the python package requirement from [`requirements.txt`](requirements.txt), and install using

```

pip install -r requirements.txt

```



- *Download Dataset from [google drive](https://drive.google.com/drive/folders/1Oa9XpyKnRSN5s9-ab2-5j3wvH374JOu8?usp=sharing)* and put it in the folder of ***./datasetGAN/dataset_release***. The cache npy files are explained in Section **Create your own model**.  Please be aware that the dataset of DatasetGAN is released under the [Creative Commons BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) license by NVIDIA Corporation.



- *Download pretrained checkpoint from [Stylegan](https://github.com/NVlabs/stylegan) and convert the tensorflow checkpoint to pytorch. We also release the [pytorch checkpoint](https://drive.google.com/drive/folders/1Hhu8aGxbnUtK-yHRD9BXZ3gn3bNNmsGi?usp=sharing)  for your convenience. Put checkpoints in the folder of **./checkpoint/stylegan_pretrain***. Please be aware that the any code dependency and checkpoint related to Stylegan, the license is under the [Creative Commons BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) license by NVIDIA Corporation.  



## Training 



To reproduce paper **DatasetGAN: Efficient Labeled Data Factory with Minimal Human Effort**: 



```

cd datasetGAN

```



1. Run **Step1: Interpreter training**.  

3. Run **Step2: Sampling** to generate massive annotation-image dataset.

4. Run **Step3: Train Downstream Task**.



#### 1. Interpreter Training 



```

python train_interpreter.py --exp experiments/.json 

```



Note: Training time for 16 images is around one hour. 160G RAM is required to run 16 images training. One can cache the data returned from **prepare_data** function to disk but it will increase trianing time due to I/O burden. 



*Example of annotation schema for Face class. Please refer to paper for other classes.*



![img](./figs/dataset.png)



Download [Checkpoints](https://drive.google.com/drive/folders/1Hhu8aGxbnUtK-yHRD9BXZ3gn3bNNmsGi?usp=sharing)



#### 2. Run GAN Sampling  



```

python train_interpreter.py \

--generate_data True --exp experiments/.json  \

--resume [path-to-trained-interpreter in step3] \

--num_sample [num-samples]

```

To run sampling processes in parallel

```

sh datasetGAN/script/generate_face_dataset.sh

```



*Example of sampling images and annotation:*



![img](./figs/samplings.png)



#### 3. Train Downstream Task  



```

python train_deeplab.py \

--data_path [path-to-generated-dataset in step4] \

--exp experiments/.json

```



## Inference



![img](./figs/datasetgan_demo.png)



```

python test_deeplab_cross_validation.py --exp experiments/face_34.json\

--resume [path-to-downstream task checkpoint] --cross_validate True

```



**June 21 Update:**



For training interpreter, we change the upsampling method from nearnest upsampling to bilinar upsampling in [line](https://github.com/nv-tlabs/datasetGAN_release/blob/release_finallll/datasetGAN/train_interpreter.py#L163) and update results in Table 1.  The table reports mIOU.



**Sep 12 Update:**



Thanks for [@greatwallet.](https://github.com/greatwallet) According to [issue](https://github.com/nv-tlabs/datasetGAN_release/issues/27), we fixed a uncertainty score calculation bug. The Ours-Fix row shows the results.






## Create your own model



To create your own model, please follow the following steps:



1. Train your own stylegan model using official [Stylegan](https://github.com/NVlabs/stylegan) code and convert the tensorflow checkpoint to pytorch. Specific stylegan path in 



   ```datasetGAN/experiments/customized.json```



2. Run ```python datasetGAN/make_training_data.py --exp datasetGAN/experiments/customized.json --sv_path ./new_data ```. 



   This function will generate sample images and dump two numpy files in sv_path.



   a. ```avg_latent_stylegan1.npy``` (Dim: 18 *512) is used for truncation. It's average of w latent space. We sample 8000 from z space and calculate average of w.



   b. ```latent_stylegan1.npy```  (Dim: number_data *512)  is cache z latent codes to retrive corresponding training images. 



3. Annotate image as you like, follow the file format in  [google drive](https://drive.google.com/drive/folders/1Oa9XpyKnRSN5s9-ab2-5j3wvH374JOu8?usp=sharing) and put annotation in the folder of ***./datasetGAN/dataset_release***. 



## Citations



Please ue the following citation if you use our data or code: 



```

@inproceedings{zhang2021datasetgan,

  title={Datasetgan: Efficient labeled data factory with minimal human effort},

  author={Zhang, Yuxuan and Ling, Huan and Gao, Jun and Yin, Kangxue and Lafleche, Jean-Francois and Barriuso, Adela and Torralba, Antonio and Fidler, Sanja},

  booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},

  pages={10145--10155},

  year={2021}

}

```