Files
Machine-Learning-Collection/ML/Pytorch/object_detection/YOLOv3/README.md
Aladdin Persson 4a6627a3bf add yolov3
2021-02-22 16:49:22 +01:00

2.3 KiB
Raw Blame History

YOLOv3 in PyTorch

A quite minimal implementation of YOLOv3 in PyTorch spanning only around 600 lines of code with support for training and evaluation and complete with helper functions for inference. There is currently pretrained weights for Pascal-VOC with MS COCO coming up. With minimal changes in the model with regards to the output format the original weights can also be loaded seamlessly.

Installation

Clone and install requirements

$ git clone 
$ cd YOLOv3-PyTorch
$ pip install requirements.txt

Download pretrained weights on Pascal-VOC

Available on Kaggle: https://www.kaggle.com

Dowload original weights

Download YOLOv3 weights from https://pjreddie.com/media/files/yolov3.weights. Save the weights to PyTorch format by running the model_with_weights.py file. Change line in train.py to import model_with_weights.py instead of model.py since the original output format is slightly different. This works well for

Download Pascal-VOC dataset

Download the processed dataset from the following link: coming soon

Training

Edit the config file to match the setup you want to use. Then run train.py

Results

Model mAP @ 50 IoU
YOLOv3 (Pascal VOC) 78.2
YOLOv3 (MS-COCO) Not done yet

The model was evaluated with confidence 0.2 and IOU threshold 0.45 using NMS.

YOLOv3 paper

The implementation is based on the following paper:

An Incremental Improvement

by Joseph Redmon, Ali Farhadi

Abstract

We present some updates to YOLO! We made a bunch of little design changes to make it better. We also trained this new network thats pretty swell. Its a little bigger than last time but more accurate. Its still fast though, dont worry. At 320 × 320 YOLOv3 runs in 22 ms at 28.2 mAP, as accurate as SSD but three times faster. When we look at the old .5 IOU mAP detection metric YOLOv3 is quite good. It achieves 57.9 AP50 in 51 ms on a Titan X, compared to 57.5 AP50 in 198 ms by RetinaNet, similar performance but 3.8× faster. As always, all the code is online at https://pjreddie.com/yolo/.

@article{yolov3,
  title={YOLOv3: An Incremental Improvement},
  author={Redmon, Joseph and Farhadi, Ali},
  journal = {arXiv},
  year={2018}
}