inference-engine/samples/hello_shape_infer_ssd/README.md

   1 # Hello Shape Infer C++ Sample
   2
   3 This topic demonstrates how to run the Hello Shape Infer SSD application, which does inference using object detection
   4 networks like SSD-VGG. The sample shows how to use [Shape Inference feature](./docs/IE_DG/ShapeInference.md).
   5
   6 > **NOTE**: By default, Inference Engine samples and demos expect input with BGR channels order. If you trained your model to work with RGB order, you need to manually rearrange the default channels order in the sample or demo application or reconvert your model using the Model Optimizer tool with `--reverse_input_channels` argument specified. For more information about the argument, refer to **When to Specify Input Shapes** section of [Converting a Model Using General Conversion Parameters](./docs/MO_DG/prepare_model/convert_model/Converting_Model_General.md).
   7
   8 ## Running
   9
  10 To run the sample, you can use public or pre-trained models. To download the pre-trained models, use the OpenVINO [Model Downloader](https://github.com/opencv/open_model_zoo/tree/2018/model_downloader) or go to [https://download.01.org/opencv/](https://download.01.org/opencv/).
  11
  12 > **NOTE**: Before running the sample with a trained model, make sure the model is converted to the Inference Engine format (\*.xml + \*.bin) using the [Model Optimizer tool](./docs/MO_DG/Deep_Learning_Model_Optimizer_DevGuide.md).
  13
  14 You can use the following command to do inference on CPU on an image using a trained SSD network:
  15 ```sh
  16 ./hello_shape_infer_ssd <path_to_model>/ssd_300.xml <path_to_image>/500x500.bmp CPU 3
  17 ```
  18
  19 ## Sample Output
  20
  21 The application renders an image with detected objects enclosed in rectangles. It outputs the list of classes
  22 of the detected objects along with the respective confidence values and the coordinates of the
  23 rectangles to the standard output stream.
  24
  25 ## See Also
  26 * [Using Inference Engine Samples](./docs/IE_DG/Samples_Overview.md)
  27 * [Model Downloader](https://github.com/opencv/open_model_zoo/tree/2018/model_downloader)
  28 * [Model Optimizer](./docs/MO_DG/Deep_Learning_Model_Optimizer_DevGuide.md)