SOTA Re-identification Methods and Toolbox
 
 
 
 
 
Go to file
liaoxingyu 4be4cacb73 fix: add a simple way to reset data prefetcher when resume training
use data prefetcher build-in reset function to reload it rather than
redefining a new data prefetcher, otherwise it will introduce other
problems in eval-only mode.
2020-05-09 11:58:27 +08:00
configs chore(configs): update all training config 2020-05-01 09:04:51 +08:00
demo feat(engine/defaults): add DefaultPredictor to get image reid features 2020-05-08 19:24:27 +08:00
fastreid fix: add a simple way to reset data prefetcher when resume training 2020-05-09 11:58:27 +08:00
tests update version0.2 code 2020-03-25 10:58:26 +08:00
tools fix: add a simple way to reset data prefetcher when resume training 2020-05-09 11:58:27 +08:00
.gitignore Change architecture: 2020-02-18 21:01:23 +08:00
MODEL_ZOO.md update model zoo results 2020-05-06 09:58:49 +08:00
README.md style(configs): put all config files together 2020-04-29 16:18:54 +08:00

README.md

FastReID

FastReID is a research platform that implements state-of-the-art re-identification algorithms.

Quick Start

The designed architecture follows this guide PyTorch-Project-Template, you can check each folder's purpose by yourself.

  1. cd to folder where you want to download this repo

  2. Run git clone https://github.com/L1aoXingyu/fast-reid.git

  3. Install dependencies:

  4. Prepare dataset Create a directory to store reid datasets under projects, for example

    cd fast-reid
    mkdir datasets
    
    1. Download dataset to datasets/ from baidu pan or google driver
    2. Extract dataset. The dataset structure would like:
    datasets
        Market-1501-v15.09.15
            bounding_box_test/
            bounding_box_train/
    
  5. Prepare pretrained model. If you use origin ResNet, you do not need to do anything. But if you want to use ResNet_ibn, you need to download pretrain model in here. And then you can put it in ~/.cache/torch/checkpoints or anywhere you like.

    Then you should set the pretrain model path in configs/Base-bagtricks.yml.

  6. compile with cython to accelerate evalution

    cd fastreid/evaluation/rank_cylib; make all
    

Model Zoo and Baselines

We provide a large set of baseline results and trained models available for download in the Fastreid Model Zoo.