warren-ding / text-to-image-reidentification

A pytorch re-implementation of text-to-image Re-ID model Multi-granularity Image-text Alignments.

Language-to-vision Re-Identification: A Re-Implementation of Multi-granularity Image-text Alignments

(Still under testing)

• An Pytorch re-implementation for a Text-to-image Re-ID algorithm
• This is an implementation of ICCV'19 paper Improving Description-based Person Re-identification by Multi-granularity Image-text Alignments. Refer to the original paper and authors for details.

@article{niu2020improving,
  title={Improving description-based person re-identification by multi-granularity image-text alignments},
  author={Niu, Kai and Huang, Yan and Ouyang, Wanli and Wang, Liang},
  journal={IEEE Transactions on Image Processing},
  volume={29},
  pages={5542--5556},
  year={2020},
  publisher={IEEE}
}

• This is a beta version implementation. Bug could exist.
• If you find this is useful in your research work, please cite the original paper (and probably star this repo ;-))

Dataset

Please download the train and val1 setfrom WIDER Person Search by Language dataset and save it in proper folder.

Performance

With bi-GRU as caption encoder and ResNet-50 as image encoder, we got the following results:

Model	R@1	R@5	R@10
MIA (global-global)	47.56	71.34	79.34
MIA (global-global + global-part)	50.78	73.03	82.11
MIA (global-global + global-part + part-part) (reported)	53.10	75.00	82.90

for computational reason, we haven't implemented the global-global + global-part + part-part versiono of MIA, which might be released in next updates.

Train

run sh src/run.sh

Inference

run sh src/run.sh with --mode val and --load_ckpt_fn set as the path to the saved checkpoints.

Visualization

1. Check notebook src/inference.ipynb for interactive retrieval with config set properly

2. run python src/visualizations/heep_generator.py for generate a html page visualize retrieval result. Please set parameter accordingly to enable different visualization. e.g. False only for only display retrieval failures.