FaceAging-by-cycleGAN - GitLite

KO | EN

gitlite — search

#javascript #typescript #llm #go #rust #linux #windows #kubernetes #vue #awesome-list #pytorch #security #ios #openai

FaceAging-by-cycleGAN

(★ 167)

No description available.

파일 탐색기

최종 버전 다운로드 (.zip)

파일 수가 많아 일부만 표시됩니다. 전체 파일은 위 다운로드 버튼으로 확인해 주세요.

- __init__.py
- aligned_dataset.py
- base_data_loader.py
- base_dataset.py
- image_folder.py
- single_dataset.py
- unaligned_dataset.py
- get_test_images.py
- imdb_mat_to_pickle.py
- log_dataset.py
- process_cacd.py
- process_loss_log.py
- process_wiki.py
- remove_grayscale_and_small_images.py
- validate_image.py
- wiki_mat_to_pickle.py
- - cityscapes.tex
  - facades.tex
  - handbags.tex
  - shoes.tex
  - transattr.tex
- - old_women.tar.gz
  - super_old_men.tar.gz
  - super_old_women.tar.gz
  - young_women.tar.gz
- combine_A_and_B.py
- download_cyclegan_dataset.sh
- make_dataset_aligned.py
.gitignore
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FaceAging-by-cycleGAN
This project was graded **101/100** by cs230(fall semester 2018) of Stanford University.

## Contribution

This repo is heavily based on [**Original CycleGAN implementation**](https://github.com/junyanz/pytorch-CycleGAN-and-pix2pix). Most of our work involves adding code to better handle the dataset we are working with, and adding a couple of small features that enables transfer learning.

### Data Process Related

The code related to data processing is located in folder [**data_processing**](https://github.com/jiechen2358/FaceAging-by-cycleGAN/tree/master/data_processing), the folder contains utilities perform following tasks

* get_test_images.py: Small utility to gather specific test cases images from result folders of all models.

* imdb_mat_to_pickle.py: Read metadata of IMDB data of IMDB-WIKI dataset (.mat format) and convert it to .pkl format.

* wiki_mat_to_pickle.py: Read metadata of WIKI data of IMDB-WIKI dataset (.mat format) and convert it to .pkl format.

* process_cacd.py: Read CACD dataset and retrieve two groups of images, one group is old people and another group is young people.

* process_wiki.py: Read IMDB-WIKI dataset and retrieve two groups of images, one group is old people and another group is young people.

* log_dataset.py: Create a log directory with 4 log files (trainA.log, trainB.log, testA.log and testB.log) that captures the filename of all the files within trainA, trainB, testA, and testB directories. This is especially useful when we are doing data processing and want to keep track of what files got moved at what time.

* remove_grayscale_and_small_images.py: process a directory of images and remvoe all grayscale images as well as small images. These images are not suitable for training.

* validate_image.py: Validate all images in a directory are of .jpg format instead of other format. This is done through reading the metadata of the file, instead of relying on filename extensions.

* process_loss_log.py: Reads a loss_log.txt file generated by CycleGAN training process and plot the loss curve.

Beyond the data_processing directory, we also added a print_structure.py script under project directory to print the network architecture based on the user selections.

Also, we added scripts/unzip_dataset_all.sh, scripts/unzip_dataset_male.sh, scripts/unzip_dataset_female.sh scripts to help processing the unpacking of our dataset.

### Support Transfer Learning

Modified original model implementation to added Transfer Learning functionality ([**models**](https://github.com/jiechen2358/FaceAging-by-cycleGAN/tree/master/models)). 4 files(models/base_model.py, models/networks.py, models/cycle_gan_model.py and models/test_model.py) were modified in order to support this.

We also modified options/base_option.py and options/train_options.py. These files are located in folder: [**options**](https://github.com/jiechen2358/FaceAging-by-cycleGAN/tree/master/options). We added following flags for transfer learning:

* --use_pretrained_model: whether we should use pretrained model
* --pretrained_model_name: name of the pretrained model we want to use for transfer learning, e.g. orange2apple 
* --pretrained_model_subname: name of the sub models (comma delimited) we want to use for transfer learning, e.g. GA,GB
* --pretrained_model_epoch: epoch of the pretrained model we want to use for transfer learning
* --G_A_freeze_layer: freeze these many initial layers (inclusive) of G_A network during training
* --G_B_freeze_layer: freeze these many initial layers (inclusive) of G_B network during training
* --D_A_freeze_layer: freeze these many initial layers (inclusive) of D_A network during training
* --D_B_freeze_layer: freeze these many initial layers (inclusive) of D_B network during training

### Pre-trained Model

The trained models are located in folder [**trained_model**](https://github.com/jiechen2358/FaceAging-by-cycleGAN/tree/master/trained_model), including:

* 0_cacd_regular - checkpoints trained on CACD all gender datasets
* 1_wiki_base_mix - checkpoints trained on IMDB-WIKI all gender datasets
* 2_wiki_base_female - checkpoints trained on IMDB-WIKI female-only datasets
* 3_wiki_base_male - checkpoints trained on IMDB-WIKI male-only datasets
* 4_wiki_smaller_model - checkpoints trained on IMDB-WIKI datasets, with 6 ResNet blocks for generator network
* 5_wiki_transfer_horse2zebra - checkpoints trained on IMDB-WIKI datasets, transfer learning with horse2zebra and locking * ResNet blocks #1 to #7
* 6_wiki_transfer_summer2winter- checkpoints trained on IMDB-WIKI datasets, transfer learning with summer2winter and locking ResNet blocks #1 to #7
* 7_wiki_transfer_monet2photo - checkpoints trained on IMDB-WIKI datasets, transfer learning with monet2photo and locking ResNet blocks #1 to #7
* 8_wiki_fine_tune_horse2zebra - checkpoints trained on IMDB-WIKI datasets, fine tuning with horse2zebra further trained 100 epochs
* 9_wiki_fine_tune_male - checkpoints trained on IMDB-WIKI datasets, fine tuning with 3_wiki_base_male further trained 100 epochs

### Supplementary Classifier

Implemented a [**Gender & Age Classifier**](https://github.com/jiechen2358/FaceAging-by-cycleGAN/tree/master/gender_age_classification) intent to perform multiple tasks.
* From application perspective, we plan to develope a model selector in the future since our experiments show that the results of our model are influenced by the gender of the input images. For example, model trained on female has better performance on female image inputs.

### Quantitative Assessment

[**Age Estimation Tool**](https://github.com/jiechen2358/FaceAging-by-cycleGAN/tree/master/quantitative_assessment) Created some small utility code that can quantitatively estimate CycleGAN's performance by estimating the age of all the people in the test set, before and after the age progression. This allow us to quantitatively see how much our model has made people become.

## Introduction
In this project, we proposed a simple, yet intuitive deep learning model based on **CycleGAN** that can generate predictive images of people's look after certain years based on their current images, without the need of paired dataset.

## Dataset
1. [**IMDB-WIKI-500k+ face images with age and gender labels**](https://data.vision.ee.ethz.ch/cvl/rrothe/imdb-wiki/) - contains 500k+ images of celebrities from IMDb and Wikipedia. The metadata of this dataset contains the date of birth of the person portrayed in the image and the date of which the image was taken.
2. [**Cross-Age Celebrity Dataset (CACD)**](http://bcsiriuschen.github.io/CARC/) - contains 163k+ images of 2,000 celebrities. "The images are collected from search engines using celebrity name and year (2004-2013) as keywords. We can therefore estimate the ages of the celebrities on the images by simply subtract the birth year from the year of which the photo was taken."

## Modeling and Implementation
We picked the [**CycleGAN**](https://junyanz.github.io/CycleGAN/) model because we think it can solve two major problems we face:

1. Making sure the original image and the translated image represent the same person. Adversarial losses alone cannot guarantee that the learned function can map an individual input to a desired output. CycleGan regularizes the space of possible mapping by adding the cycle-consistency losses. Combining this loss with the adversarial losses on the domains “young” and “old”, it made sure that the transformed images still represent the same person in the original images.

2. Obtain photos of one person that were taken at different ages is challenging and expensive. Therefore, we need an algorithm that can pass around domain knowledges between groups without paired input-output examples. CycleGAN can capture characteristics of faces of young people portraited in one image collection and figure out how these characteristics can be applied to those facial images in a collection of old people.

![Model Architecture](https://raw.githubusercontent.com/jiechen2358/FaceAging-by-cycleGAN/master/imgs/CycelGANAgingModelArchitecture.png)

# Getting Started

## Installation
1. Clone this repo

git clone https://github.com/jiechen2358/FaceAging-by-cycleGAN.git
       cd FaceAging-by-cycleGAN
   
2. Install PyTorch 0.4+ and torchvision from http://pytorch.org and other dependencies (e.g., visdom and dominate). You can install all the dependencies by
   
       pip install -r requirements.txt
   
3. For Conda users, we include a script ./scripts/conda_deps.sh to install PyTorch and other libraries.

## Train/Test
1. Unpack datasets:

./scripts/unzip_datasets.sh
   
2. Train a model:

python train.py --dataroot ./datasets/young2old --name aging_cyclegan --model cycle_gan
   
   To view training results and loss plots, run python -m visdom.server and click the URL http://localhost:8097. To see more intermediate results, check out ./checkpoints/aging_cyclegan/web/index.html.

3. Test the model:

python test.py --dataroot ./datasets/young2old --name aging_cyclegan --model cycle_gan

The test results will be saved to a html file here: ./results/aging_cyclegan/latest_test/index.html.

## Results
The following table lists all models we have explored in our study and their quantitative result. The columns are (from left to right): model number, data source, data composition, number of epochs trained, pre-trained network to initialize with, freeze until what layer of generator net, the size of the generator net, maximum age progression (years), average age progression, last 3 columns are the % of test cases where age progression is over 10 years, 15 years and 20 years. Results in model #4 is N/A due to model collapsing.

![Model Comparison: Transfer Learning, Fine Tuning](https://raw.githubusercontent.com/jiechen2358/FaceAging-by-cycleGAN/master/imgs/table-of-experiment-results.PNG)

Young to Old                   Old to Young                  Old to Young
![male young to old 1](https://raw.githubusercontent.com/jiechen2358/FaceAging-by-cycleGAN/master/imgs/m-result1.gif)
![male old to young 1](https://raw.githubusercontent.com/jiechen2358/FaceAging-by-cycleGAN/master/imgs/m-result2.gif)
![female old to young 1](https://raw.githubusercontent.com/jiechen2358/FaceAging-by-cycleGAN/master/imgs/f-result.gif)

Input                         Output                     reconstruction 
![Input output reconstruction](https://github.com/jiechen2358/FaceAging-by-cycleGAN/blob/master/imgs/Picture1.png)

## Report
[**AgingGAN: Age Progression with CycleGAN**](https://github.com/jiechen2358/FaceAging-by-cycleGAN)

## References
* CycleGAN paper [link](https://arxiv.org/abs/1703.10593)
* Official source code pyTorch implementation [link](https://github.com/junyanz/pytorch-CycleGAN-and-pix2pix)