Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Object detection based on the YOLOv2 architecture

YOLOv2 (You only look once) is a widely used in computer vision tasks such as face detection, object recognition, etc. This is a Tensorflow 2.1.0 implementation of the same architecture (with slight modifications) for traffic assesment.

Classification CI status Classification open issues badge Classification closed issues badge License badge

Getting started

Run in Google Collab

Open In Colab

The Jupyter notebook could be viewed in Google Collab via the link here.

Run locally

First, we need to setup the working enviourment for the project. A simple way of doing so is Another relateivly easy way to get started is to install Docker and the official Tensorflow image.

Setup with Docker

Installing a Docker Tensorflow

Which image you should install primairly depends on whether you have NVIDIA Cuda drivers installed. If so, you will need to install nvidia-docker and you will be able to run the GPU supported tensorflow/tensorflow:nightly-gpu-py3-jupyter image. Otherwise you can still run the CPU-only image - tensorflow/tensorflow:nightly-py3-jupyter.

For CPU-only supporting image run the following:

$ docker run -it -v $(pwd):/tf -p 8888:8888 tensorflow/tensorflow:nightly-py3-jupyter

For GPU supporting image run the following:

$ docker run -it --runtime=nvidia -v $(pwd):/tf -p 8888:8888 tensorflow/tensorflow:nightly-gpu-py3-jupyter

Opening the notebook

The notebook should be accessible on localhost:8888 with the access token printed in the command-prompt.

How does it work?

You can a much more detailed explanation on YOLOv1 in the research paper - here and on YOLOv2 - here.

Built With

Python 3.7 with the following libraries:

  • Tensorflow (2.1.0) - Neural network model
  • Numpy (1.18.2) - Data formating
  • Pillow - Loading images
  • Jupyter Notebook (1.0.0) - IDE
  • MatPlotLib (3.2.1) - Data visualization

License

Distributed under the MIT license. See LICENSE for more information.