Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lucasvandroux/pytorch-rocket-yolov3-retinanet50-retinanet101

PyTorch Rocket Yolov3 RetinaNet SSD - Tutorial 2: A Tale of 3 Rockets
https://github.com/lucasvandroux/pytorch-rocket-yolov3-retinanet50-retinanet101

beginner beginner-friendly computer-vision darknet53 deep-learning diy-tool easy-to-use object-detection pytorch pytorch-tutorial retinanet yolov3

Last synced: about 1 month ago
JSON representation

PyTorch Rocket Yolov3 RetinaNet SSD - Tutorial 2: A Tale of 3 Rockets

Awesome Lists containing this project

README

        

# PyTorch Rocket Yolov3 RetinaNet50, RetinaNet101 - Tutorial 2: A Tale of 3 Rockets
Have you ever wanted to test multiple Deep Learning models and compare their results very easily?

Are you tired of picking a Deep Learning model just because it is the only one you are able to run?

We want to solve this problem and we packaged 3 state-of-the-art Deep Learning models for Object detection for you to easily test them.

We are calling those new way of packaging Deep Learning models: __Rockets__.

__Welcome to the Rockets Scientists Community!!!__

## Install the repositories
We recommend you to use an isolated Python environement such as [virtualenv](https://virtualenv.pypa.io/en/latest/) or [conda](https://docs.conda.io/en/latest/) with at least __Python 3.6__. Then you can use the following lines of code:
```
git clone https://github.com/LucasVandroux/PyTorch-Rocket-YOLOv3-RetinaNet50-RetinaNet101
cd PyTorch-Rocket-YOLOv3-RetinaNet50-RetinaNet101
pip install rocketbase
```
### Install PyTorch
As the installation for PyTorch is different for each platform, you need to look at the [PyTorch installation guide](https://pytorch.org/get-started/locally/). Don't worry it is very simple, maximum 2 lines of codes :stuck_out_tongue_closed_eyes:

## A Tale of 3 Rockets
For this first tutorial, we selected three state-of-the-art models in Object Detection for you to play with:

1. RetinaNet with a resnet50 backbone and smaller dimension resized to 608px ___[[paper]](https://arxiv.org/pdf/1708.02002.pdf)___
2. RetinaNet with a resnet101 backbone and smaller dimension resized to 800px ___[[paper]](https://arxiv.org/pdf/1708.02002.pdf)___
3. YOLOv3 ___[[paper]](https://pjreddie.com/media/files/papers/YOLOv3.pdf)___

> Note that the RetinaNet Rocket with the resnet50 backbone can be landed using `igor/resnet`. This Rocket is the default RetinaNet Rocket. To land another version we suggest to use a specific slug such as `igor/retinanet-resnet101-800px`.

## Run the Object Detection model
Everything is happening in the `detect.py` file. There you can choose which image and model to use with just one line of code.

Once you are ready you just need to run `python detect.py` and everything will happen magically.

Don't hesitate to play around by swapping the different Rockets and comparing their output.

## Outputs of the different Rockets
| Filename | Original | RetinaNet | RetinaNet101 | YOLOv3 | Google Vision AI |
|----------|----------|-----------|-----|--------|------------------|
| `office.jpg` | ![image-original-office](images/office.jpg)|![image-retinanet-office](images/detections/retinanet/office.jpg)|![image-retinanet101-office](images/detections/retinanet-resnet101-800px/office.jpg)|![image-yolov3-office](images/detections/yolov3/office.jpg)|![image-googleAPI-office](images/detections/googleAPI/office.jpg)|
|`shop.jpg`|![image-original-shop](images/shop.jpg)|![image-retinanet-shop](images/detections/retinanet/shop.jpg)|![image-retinanet101-shop](images/detections/retinanet-resnet101-800px/shop.jpg)|![image-yolov3-shop](images/detections/yolov3/shop.jpg)|![image-googleAPI-shop](images/detections/googleAPI/shop.jpg)|
|`street.jpg`|![image-original-street](images/street.jpg)|![image-retinanet-street](images/detections/retinanet/street.jpg)|![image-retinanet101-street](images/detections/retinanet-resnet101-800px/street.jpg)|![image-yolov3-street](images/detections/yolov3/street.jpg)|![image-googleAPI-street](images/detections/googleAPI/street.jpg)|

We added the outputs from the [Google Vision AI](https://cloud.google.com/vision/) to compare with the results of our Rockets.

The Rockets are also outputting a Json formatted answer that you can use to integrate the Rockets in one of your Kickass project.

## Contact
Any feedback or complaint from your neighbors about the noise your Rockets are making, please contact us at [[email protected]](mailto:[email protected]).