Focal Inverse Distance Transform Map

[Project page] [paper]
An officical implementation of "Focal Inverse Distance Transform Map for Crowd Localization" (Accepted by IEEE TMM).
We propose a novel label named Focal Inverse Distance Transform (FIDT) map, which can represent each head location information.

News

We now provide the predicted coordinates txt files, and other researchers can use them to fairly evaluate the localization performance.

Overview

Visualizations

Compared with density map

Visualizations for bounding boxes

Progress

• Testing Code (2021.3.16)
• Training baseline code (2021.4.29)
• Pretrained model
  • ShanghaiA (2021.3.16)
  • ShanghaiB (2021.3.16)
  • UCF_QNRF (2021.4.29)
  • JHU-Crowd++ (2021.4.29)
  • NWPU-Crowd++ (2021.4.29)
• Bounding boxes visualizations(2021.3.24)
• Video demo(2021.3.29)
• Predicted coordinates txt file(2021.8.20)

Environment

python >=3.6 
pytorch >=1.4
opencv-python >=4.0
scipy >=1.4.0
h5py >=2.10
pillow >=7.0.0
imageio >=1.18
nni >=2.0 (python3 -m pip install --upgrade nni)

Datasets

• Download ShanghaiTech dataset from Baidu-Disk, passward:cjnx; or Google-Drive
• Download UCF-QNRF dataset from here
• Download JHU-CROWD ++ dataset from here
• Download NWPU-CROWD dataset from Baidu-Disk, passward:3awa; or Google-Drive

Generate FIDT Ground-Truth

cd data
run  python fidt_generate_xx.py

“xx” means the dataset name, including sh, jhu, qnrf, and nwpu. You should change the dataset path.

Model

Download the pretrained model from Baidu-Disk, passward:gqqm, or OneDrive

Quickly test

git clone https://github.com/dk-liang/FIDTM.git

Download Dataset and Model
Generate FIDT map ground-truth

Generate image file list: python make_npydata.py

Test example:

python test.py --dataset ShanghaiA --pre ./model/ShanghaiA/model_best.pth --gpu_id 0
python test.py --dataset ShanghaiB --pre ./model/ShanghaiB/model_best.pth --gpu_id 1  
python test.py --dataset UCF_QNRF --pre ./model/UCF_QNRF/model_best.pth --gpu_id 2  
python test.py --dataset JHU --pre ./model/JHU/model_best.pth --gpu_id 3  

If you want to generate bounding boxes,

python test.py --test_dataset ShanghaiA --pre model_best.pth  --visual True
(remember to change the dataset path in test.py)  

If you want to test a video,

python video_demo.py --pre model_best.pth  --video_path demo.mp4
(the output video will in ./demo.avi; By default, the video size is reduced by two times for inference. You can change the input size in the video_demo.py)

Visiting bilibili or Youtube to watch the video demonstration. The original demo video can be downloaded from Baidu-Disk, passed: cebh

More config information is provided in config.py

Evaluation localization performance

Evaluation example:

For Shanghai tech, JHU-Crowd (test set), and NWPU-Crowd (val set):

cd ./local_eval
python eval.py ShanghaiA  
python eval.py ShanghaiB
python eval.py JHU  
python eval.py NWPU

For UCF-QNRF dataset:

python eval_qnrf.py --data_path path/to/UCF-QNRF_ECCV18 

For NWPU-Crowd (test set), please submit the nwpu_pred_fidt.txt to the website.

We also provide the predicted coordinates txt file in './local_eval/point_files/', and you can use them to fairly evaluate the other localization metric.

(We hope the community can provide the predicted coordinates file to help other researchers fairly evaluate the localization performance.)

Tips:
The GT format is:

1 total_count x1 y1 4 8 x2 y2 4 8 ..... 
2 total_count x1 y1 4 8 x2 y2 4 8 .....

The predicted format is:

1 total_count x1 y1 x2 y2.....
2 total_count x1 y1 x2 y2.....

The evaluation code is modifed from NWPU.

Training

The training strategy is very simple. You can replace the density map with the FIDT map in any regressors for training.

If you want to train based on the HRNET (borrow from the IIM-code link), please first download the ImageNet pre-trained models from the official link, and replace the pre-trained model path in HRNET/congfig.py (__C.PRE_HR_WEIGHTS).

Here, we provide the training baseline code:

Training baseline example:

python train_baseline.py --dataset ShanghaiA --crop_size 256 --save_path ./save_file/ShanghaiA 
python train_baseline.py --dataset ShanghaiB --crop_size 256 --save_path ./save_file/ShanghaiB  
python train_baseline.py --dataset UCF_QNRF --crop_size 512 --save_path ./save_file/QNRF
python train_baseline.py --dataset JHU --crop_size 512 --save_path ./save_file/JHU

For ShanghaiTech, you can train by a GPU with 8G memory. For other datasets, please utilize a single GPU with 24G memory or multiple GPU for training.

Improvements We have not studied the effect of some hyper-parameter. Thus, the results can be further improved by using some tricks, such as adjust the learning rate, batch size, crop size, and data augmentation.

Reference

If you find this project is useful for your research, please cite:

@article{liang2022focal,
  title={Focal inverse distance transform maps for crowd localization},
  author={Liang, Dingkang and Xu, Wei and Zhu, Yingying and Zhou, Yu},
  journal={IEEE Transactions on Multimedia},
  year={2022},
  publisher={IEEE}
}