Awesome Open Source
Awesome Open Source




Pedestron is a MMdetection based repository that focuses on the advancement of research on pedestrian detection. We provide a list of detectors, both general purpose and pedestrian specific to train and test. Moreover, we provide pre-trained models and benchmarking of several detectors on different pedestrian detection datasets. Additionally, we provide processed annotations and scripts to process the annotation of different pedestrian detection benchmarks. If you use Pedestron, please cite us (see at the end) and other respective sources.

🔥 Updates 🔥

  • 🔥 We haved added a slightly better implementation of CSP - CVPR 2019 to Pedestron along with a pre-trained model. 🔥

YouTube demo



We refer to the installation and list of dependencies to installation file. Clone this repo and follow installation. Alternatively, Google Colab step-by-step instruction can be followed for installation. Addiitonally, you can also refer to the google doc file for step-by-step installation.

List of detectors

Currently we provide configurations for the following detectors, with different backbones

  • Cascade Mask-R-CNN
  • Faster R-CNN
  • RetinaNet
  • RetinaNet with Guided Anchoring
  • Hybrid Task Cascade (HTC)
  • MGAN
  • CSP

Following datasets are currently supported

Datasets Preparation


Benchmarking of pre-trained models on pedestrian detection datasets (autonomous driving)

Detector Dataset Backbone Reasonable Heavy
Cascade Mask R-CNN CityPersons HRNet 7.5 28.0
Cascade Mask R-CNN CityPersons MobileNet 10.2 37.3
Faster R-CNN CityPersons HRNet 10.2 36.2
RetinaNet CityPersons ResNeXt 14.6 39.5
RetinaNet with Guided Anchoring CityPersons ResNeXt 11.7 41.5
Hybrid Task Cascade (HTC) CityPersons ResNeXt 9.5 35.8
MGAN CityPersons VGG 11.2 52.5
CSP CityPersons ResNet-50 10.9 41.3
Cascade Mask R-CNN Caltech HRNet 1.7 25.7
Cascade Mask R-CNN EuroCity Persons HRNet 4.4 21.3
Faster R-CNN EuroCity Persons HRNet 6.1 27.0

Benchmarking of pre-trained models on general human/person detection datasets

Detector Dataset Backbone AP
Cascade Mask R-CNN CrowdHuman HRNet 84.1

Pre-Trained models

Cascade Mask R-CNN

  1. CityPersons
  2. Caltech
  3. EuroCity Persons
  4. CrowdHuman 1
  5. CrowdHuman 2 (higher AP)
  6. WIDER Pedestrian

Faster R-CNN

  1. CityPersons
  2. EuroCity Persons


  1. CityPersons

RetinaNet with Guided Anchoring

  1. CityPerson

Hybrid Task Cascade (HTC)

  1. CityPersons


  1. CityPersons


  1. CityPersons

Getting Started

Running a demo using pre-trained model on few images

  1. Pre-trained model can be evaluated on sample images in the following way
python tools/ config checkpoint input_dir output_dir

Download one of our provided pre-trained model and place it in models_pretrained folder. Demo can be run using the following command

python tools/ configs/elephant/cityperson/ ./models_pretrained/epoch_5.pth.stu demo/ result_demo/ 

See Google Colab demo.


  • [x] single GPU training
  • [x] multiple GPU training

Train with single GPU

python tools/ ${CONFIG_FILE}

Train with multiple GPUs

./tools/ ${CONFIG_FILE} ${GPU_NUM} [optional arguments]

For instance training on CityPersons using single GPU

python tools/ configs/elephant/cityperson/

Training on CityPersons using multiple(7 in this case) GPUs

./tools/ configs/elephant/cityperson/ 7  


  • [x] single GPU testing
  • [x] multiple GPU testing

Test can be run using the following command.

python ./tools/ PATH_TO_CONFIG_FILE ./models_pretrained/epoch_ start end\
 --out Output_filename --mean_teacher 

For example for CityPersons inference can be done the following way

  1. Download the pretrained CityPersons model and place it in the folder "models_pretrained/".
  2. Run the following command:
python ./tools/ configs/elephant/cityperson/ ./models_pretrained/epoch_ 5 6\
 --out result_citypersons.json --mean_teacher 

Alternatively, for EuroCity Persons

python ./tools/ configs/elephant/eurocity/ ./models_pretrained/epoch_ 147 148 --mean_teacher

or without mean_teacher flag for MGAN

python ./tools/ configs/elephant/cityperson/ ./models_pretrained/epoch_ 1 2\
 --out result_citypersons.json  

Testing with multiple GPUs on CrowdHuman

./tools/ configs/elephant/crowdhuman/ ./models_pretrained/epoch_19.pth.stu 8 --out CrowdHuman12.pkl --eval bbox

Please cite the following work

ArXiv version

      title={Generalizable Pedestrian Detection: The Elephant In The Room}, 
      author={Irtiza Hasan and Shengcai Liao and Jinpeng Li and Saad Ullah Akram and Ling Shao},

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (53,367
benchmarking (85
autonomous-driving (80
faster-rcnn (55
retinanet (21
mmdetection (16