Link Search Menu Expand Document

simple_classifier_py_camera

Introduction

This application runs inferences on frames captured through a webcam using GoogLeNet. Although the sample uses GoogLeNet as the default network, other classifier models can also be used (see Options section). The provided Makefile does the following

  1. Downloads the Caffe prototxt file and makes few changes necessary to work with the Intel® Neural Compute Stick (NCS1/NCS2) and the OpenVINO toolkit (tested with version 2020.1).
  2. Downloads and generates the required ilsvrc12 data.
  3. Downloads the caffemodel weights file from the Open Model Zoo.
  4. Compiles the model to an IR (Intermediate Representation) format file using the Model Optimizer. An IR is a static representation of the model that ia compatitible with the OpenVINO Inference Engine API.
  5. There is a run.py provided that does a single inference on a provided image as an example on how to use the network using the OpenVINO Inference Engine Python API.

Running the Example

To run the example code do the following :

  1. Open a terminal and change directory to the sample base directory
  2. Type the following command in the terminal: make run

Prerequisites

All development and testing has been done on Ubuntu 16.04 on an x86-64 machine.

This program requires:

  • 1 Intel NCS device
  • OpenVINO 2020.1 toolkit
  • A webcam (laptop or USB)

Makefile

Provided Makefile has various targets that help with the above mentioned tasks.

make run

Runs the sample application.

make help

Shows available targets.

make all

Builds and/or gathers all the required files needed to run the application.

make data

Gathers all of the required data need to run the sample.

make deps

Builds all of the dependencies needed to run the sample.

make default_model

Compiles an IR file from a default model to be used when running the sample.

make install-reqs

Checks required packages that aren’t installed as part of the OpenVINO installation.

make uninstall-reqs

Uninstalls requirements that were installed by the sample program.

make clean

Removes all the temporary files that are created by the Makefile.

Options for run.py

Option Description
–ir IR_FILE Absolute path to the neural network IR file. The default is: ../../caffe/SqueezeNet/squeezenet_v1.0.xml.
-l LABEL_FILE, –labels LABEL_FILE Absolute path to labels file. The default is: ../../data/ilsvrc12/synset_labels.txt.
-m NUMPY_MEAN_FILE, –mean NUMPY_MEAN_FILE Network Numpy mean file. The default is: None.
-s CAMERA_INDEX, –source CAMERA_INDEX V4L2 camera index. The default is 0.
-c CAMERA_CAPTURE_RESOLUTION, –cap_res CAMERA_CAPTURE_RESOLUTION The resolution of the camera capture stream. The default is (1280, 960).
-w WINDOW_SIZE, –win_size WINDOW_SIZE The size of the results display window. The default is (640, 480).

This repository is distributed under the MIT License. Individual applications and networks may retain individual copyrights. Other copyrights and trademarks may be property of others. All rights reserved.