deepfashion2-kps-agg-finetune

Aggregation and Finetuning for Clothes Landmark Detection

[WIP] Code release is still in preparation, stay tuned.

1st place solution for CVPR 2020 DeepFashion2 Clothes Landmark Detection Track. This repo contains code for the keypoints detector. The object detection part is not contained.

Prerequisite

Install

• install HRNet dependencies as in HRNet/HRNet-Human-Pose-Estimation, then

  cd HRNet-Human-Pose-Estimation/lib
  make
  

• install cocoapi in switchablenorms/DeepFashion2

  git clone https://github.com/switchablenorms/DeepFashion2
  cd DeepFashion2/deepfashion2_api/PythonAPI/
  make install
  

Data preprocess

• download data to HRNet-Human-Pose-Estimation/lib/data/deepfashion2/

• preprocess data to following structure

  data/deepfashion2/
  	annotations/ # original data, converted from deepfashion2_to_coco.py
  		train_coco.json
  		validation_coco.json
  		test_coco.json
  	annotations_agg81kps/ # for training in aggregation
  		train_coco_agg81kps.json
  	annotations_per_category/ # for validation in finetuning
  		validation_coco_category_1.json
  		...
  		validation_coco_category_13.json
  	annotations_per_category_agg81kps/ # for training in finetuning
  		train_coco_category_1.json
  		...
  		train_coco_category_13.json
  	images/ # images, make some symlinks (or just cp) for this to be done
  		train/
  		validation/
  		test/
  

• COCO pretrained weights is downloaded from here to HRNet-Human-Pose-Estimation/models/pytorch/pose_coco/pose_hrnet_w48_384x288.pth

Usage

Training

• Aggregation

  python tools/train.py --cfg experiments/deepfashion2/w48_512x384_adam_lr1e-3-agg81kps.yaml
  

• Finetune

  # finetuning 1st category
  python tools/train.py --cfg experiments/deepfashion2/w48_512x384_adam_lr1e-3-agg81kps-category1-hflip.yaml
  # finetuning 2nd category
  python tools/train.py --cfg experiments/deepfashion2/w48_512x384_adam_lr1e-3-agg81kps-category2-hflip.yaml
  # finetuning others ...
  

​

Testing

• Testing on validation set (with gt det)

  CUDA_VISIBLE_DEVICES=0,1,2,3 python tools/test.py \
      --cfg experiments/deepfashion2/w48_512x384_adam_lr1e-3-agg81kps-category1-hflip.yaml \
  GPUS '(0,1,2,3)' \
      TEST.MODEL_FILE output/deepfashion2agg81kps/pose_hrnet/w48_512x384_adam_lr1e-3-agg81kps-category1-hflip/final_state.pth \
      TEST.USE_GT_BBOX True \
      TEST.IMAGE_THRE 0.01 \
      DATASET.TEST_SET validation \
      TEST.FLIP_TEST True
  

• Testing on validation set (with object det results /path/to/det.json)

  CUDA_VISIBLE_DEVICES=0,1,2,3 python tools/test.py \
      --cfg experiments/deepfashion2/w48_512x384_adam_lr1e-3-agg81kps-category1-hflip.yaml \
  GPUS '(0,1,2,3)' \
      TEST.MODEL_FILE output/deepfashion2agg81kps/pose_hrnet/w48_512x384_adam_lr1e-3-agg81kps-category1-hflip/final_state.pth \
      TEST.USE_GT_BBOX False \
      TEST.COCO_BBOX_FILE '/path/to/det.json' \
      TEST.IMAGE_THRE 0.01 \
      DATASET.TEST_SET validation \
      TEST.FLIP_TEST True
  
  ...
  

Reference

HRNet/HRNet-Human-Pose-Estimation

Please cite following if you use the code

@misc{lin2020aggregation,
    title={Aggregation and Finetuning for Clothes Landmark Detection},
    author={Tzu-Heng Lin},
    year={2020},
    eprint={2005.00419},
    archivePrefix={arXiv},
    primaryClass={cs.CV}
}

License

MIT