Modify README

Author: Shunta Saito

README.md

@@ -4,47 +4,48 @@ NOTE: This is not official implementation. Original paper is [DeepPose: Human Po
 
 # Requirements
 
-- Python 2.7.11+
-
-  - [Chainer 1.5+](https://github.com/pfnet/chainer) (Neural network framework)
+- Python 3.5.1+
+  - [Chainer 1.13.0+](https://github.com/pfnet/chainer)
   - numpy 1.9+
-  - scipy 0.16+
-  - scikit-learn 0.15+
-  - OpenCV 2.4+
+  - scikit-image 0.11.3+
+  - OpenCV 3.1.0+
+
+I strongly recommend to use Anaconda environment. This repo may be able to be used in Python 2.7 environment, but I haven't tested.
 
 ## Installation of dependencies
 
 ```
 pip install chainer
 pip install numpy
-pip install scipy
-pip install scikit-learn
+pip install scikit-image
 # for python3
 conda install -c https://conda.binstar.org/menpo opencv3
 # for python2
 conda install opencv
 ```
 
-# Data preparation
+# Dataset preparation
 
 ```
-bash shells/download.sh
-python scripts/flic_dataset.py
-python scripts/lsp_dataset.py
-python scripts/mpii_dataset.py
+bash datasets/download.sh
+python datasets/flic_dataset.py
+python datasets/lsp_dataset.py
+python datasets/mpii_dataset.py
 ```
 
-This script downloads FLIC-full dataset (<http://vision.grasp.upenn.edu/cgi-bin/index.php?n=VideoLearning.FLIC>) and perform cropping regions of human and save poses as numpy files into FLIC-full directory. Same processes are performed for LSP, MPII datasets.
+- [FLIC-full dataset](http://vision.grasp.upenn.edu/cgi-bin/index.php?n=VideoLearning.FLIC)
+- [LSP Extended dataset](http://www.comp.leeds.ac.uk/mat4saj/lspet_dataset.zip)
+- **MPII dataset**
+    - [Annotation](http://datasets.d2.mpi-inf.mpg.de/leonid14cvpr/mpii_human_pose_v1_u12_1.tar.gz)
+    - [Images](http://datasets.d2.mpi-inf.mpg.de/andriluka14cvpr/mpii_human_pose_v1.tar.gz)
 
 ## MPII Dataset
 
 - [MPII Human Pose Dataset](http://human-pose.mpi-inf.mpg.de/#download)
 - training images: 18079, test images: 6908
-
   - test images don't have any annotations
   - so we split trining imges into training/test joint set
   - each joint set has
-
 - training joint set: 17928, test joint set: 1991
 
 # Start training
@@ -72,49 +73,12 @@ bash shells/train_mpii.sh
 ### GPU memory requirement
 
 - AlexNet
-
   - batchsize: 128 -> about 2870 MiB
   - batchsize: 64 -> about 1890 MiB
   - batchsize: 32 (default) -> 1374 MiB
-
 - ResNet50
-
   - batchsize: 32 -> 6877 MiB
 
-# Visualize Filters of 1st conv layer
-
-- Go to result dir of a model
-- `python ../../scripts/draw_filters.py`
-
-# Visualize Prediction
-
-## Example
-
-### Prediction and visualize them and calc mean errors
+# Prediction
 
-```
-python scripts/evaluate_flic.py \
---model results/AlexNet_2015/AlexNet.py \
---param results/AlexNet_2015/AlexNet_epoch_400.chainermodel \
---datadir data/FLIC-full
---gpu 0 \
---batchsize 128 \
---mode test
-```
-
-### Tile some randomly selected result images
-
-```
-python scripts/evaluate_flic.py \
---model results/AlexNet_2015/AlexNet_flic.py \
---param results/AlexNet_2015/AlexNet_epoch_450.chainermodel \
---mode tile \
---n_imgs 25
-```
-
-### Create animated GIF to intuitively compare predictions and labels
-
-```
-cd results/AlexNet_2015
-bash ../../scripts/create_anime.sh test_450_tiled_pred.jpg test_450_tiled_label.jpg test_450.gif
-```
+Will add some tools soon

datasets/download.sh

@@ -1,4 +1,6 @@
 #! /bin/bash
+# Copyright (c) 2016 Shunta Saito
+
 if [ ! -d data ]; then
     mkdir data
 fi

datasets/flic_dataset.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import

datasets/lsp_dataset.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import

datasets/mpii_dataset.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import

models/AlexNet.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import

models/ResNet50.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import

models/VGG_flic.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import

scripts/cmd_options.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import

scripts/dataset.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
-
 # Copyright (c) 2016 Shunta Saito
 
 from __future__ import absolute_import