Merge branch 'master' into python_demos_rename_configuration_api

Author: anzhella-pankratova

CONTRIBUTING.md

@@ -46,7 +46,7 @@ File | Destination
 configuration file | `models/public/<model_name>/model.yml`
 documentation file | `models/public/<model_name>/README.md`
 validation configuration file|`models/public/<model_name>/accuracy-check.yml`
-demo|`demos/<demo_name>`<br>or<br>`demos/python_demos/<demo_name>`
+demo|`demos/<demo_name>/<language>/`
 
 ### Tests
 
@@ -185,22 +185,19 @@ Deep Learning Inference Engine (IE) supports models in the Intermediate Represen
 
 ## Demo
 
-A demo shows the main idea of how to infer a model using IE. If your model solves one of the tasks supported by the Open Model Zoo, try to find an appropriate option from [demos](demos/README.md) or [samples](https://docs.openvino.ai/latest/_docs_IE_DG_Samples_Overview.html). Otherwise, you must provide your own demo (C++ or Python).
+A demo shows the main idea of how to infer a model using OpenVINO™. If your model solves one of the tasks supported by the Open Model Zoo, try to find an appropriate option from [demos](demos/README.md) or [samples](https://docs.openvino.ai/latest/_docs_IE_DG_Samples_Overview.html). Otherwise, you must provide your own demo (C++ or Python).
 
 The demo's name should end with `_demo` suffix to follow the convention of the project.
 
-Demos are required to support the following keys:
+Demos are required to support the following args:
 
- -  `-i "<input>"`: Required. An input to process. The input can usually be a single image, a folder of images or anything that OpenCV's `VideoCapture` can process.
- -  `-m "<path>"`: Required. Path to an .xml file with a trained model. If the demo uses several models at the same time, use other keys prefixed with `-m_`.
- -  `-d "<device>"`: Optional. Specifies a target device to infer on. CPU, GPU, HDDL or MYRIAD is acceptable. Default must be CPU. If the demo uses several models at the same time, use keys prefixed with `d_` (just like keys `m_*` above) to specify device for each model.
- -  `-no_show`: Optional. Do not visualize inference results.
+* `-h, --help`        show this help message and exit
+* `-m <MODEL FILE>`   path to an .xml file with a trained model. If the demo uses several models an extended syntax can be used, like `--mdet`
+* `-i <INPUT>`        input to process. For vision tasks the input might be a path to single image or video file, a path to folder of images, or numeric camera id. For vision tasks the default value must be `0`. For speech/audio tasks input is path to WAV file. For NLP tasks input might be a path to text file or just quoted sentence of text.
+* `-d <DEVICE>`       specify a device to infer on (the list of available devices is shown below). Default is CPU
+* `-o <FILE PATTERN>` pattern for output file(s) to save
 
-> **TIP**: For Python, it is preferable to use `--` instead of `-` for long keys.
-
-You can also add any other necessary parameters.
-
-Add `README.md` file, which describes demo usage. Update [demos' README.md](demos/README.md) adding your demo to the list.
+Add `README.md` file, which describes demo usage. Update [demos' README.md](demos/README.md) by adding your demo to the list.
 
 ## Accuracy Validation
 

data/dataset_definitions.yml

@@ -159,7 +159,7 @@ datasets:
     annotation_conversion:
       converter: mscoco_mask_rcnn
       annotation_file: instances_val2017_persons.json
-      has_background: True
+      has_background: False
       sort_annotations: True
     annotation: mscoco_mask_rcnn_person.pickle
     dataset_meta: mscoco_mask_rcnn_person.json

demos/3d_segmentation_demo/python/3d_segmentation_demo.py

@@ -245,7 +245,6 @@ def read_image(test_data_path, data_name, sizes=(128, 128, 128), is_series=True,
 def main():
     args = parse_arguments()
 
-    # --------------------------------- 1. Load Plugin for inference engine ---------------------------------
     log.info('OpenVINO Inference Engine')
     log.info('\tbuild: {}'.format(get_version()))
     core = Core()
@@ -262,7 +261,6 @@ def main():
         raise AttributeError("Device {} do not support of 3D convolution. "
                              "Please use CPU, GPU or HETERO:*CPU*, HETERO:*GPU*")
 
-    # --------------------- 2. Read IR Generated by ModelOptimizer (.xml and .bin files) ---------------------
     log.info('Reading model {}'.format(args.path_to_model))
     model = core.read_model(args.path_to_model)
 
@@ -279,12 +277,10 @@ def main():
 
     n, c, d, h, w = model.inputs[0].shape
 
-    # ------------------------------------ 3. Loading model to the plugin -------------------------------------
     compiled_model = core.compile_model(model, args.target_device)
     infer_request = compiled_model.create_infer_request()
     log.info('The model {} is loaded to {}'.format(args.path_to_model, args.target_device))
 
-    # --------------------------------------- 4. Preparing input data -----------------------------------------
     start_time = perf_counter()
     if not os.path.exists(args.path_to_input_data):
         raise AttributeError("Path to input data: '{}' does not exist".format(args.path_to_input_data))
@@ -312,9 +308,7 @@ def main():
         original_data = data_crop
         original_size = original_data.shape[-3:]
 
-    # ---------------------------------------------- 5. Do inference --------------------------------------------
     result = infer_request.infer({input_tensor_name: data_crop})
-    # ---------------------------- 6. Processing of the received inference results ------------------------------
     result = next(iter(result.values()))
     batch, channels, out_d, out_h, out_w = result.shape
 
@@ -375,7 +369,6 @@ def main():
     total_latency = (perf_counter() - start_time) * 1e3
     log.info("Metrics report:")
     log.info("\tLatency: {:.1f} ms".format(total_latency))
-    # --------------------------------------------- 7. Save output -----------------------------------------------
     tiff_output_name = os.path.join(args.path_to_output, 'output.tiff')
     Image.new('RGB', (original_data.shape[3], original_data.shape[2])).save(tiff_output_name,
         append_images=list_img, save_all=True)

demos/3d_segmentation_demo/python/requirements.txt

@@ -134,7 +134,7 @@ macro(add_demo)
         target_include_directories(${OMZ_DEMO_NAME} PRIVATE ${OMZ_DEMO_INCLUDE_DIRECTORIES})
     endif()
 
-    target_link_libraries(${OMZ_DEMO_NAME} PRIVATE ${OpenCV_LIBRARIES} ${InferenceEngine_LIBRARIES}
+    target_link_libraries(${OMZ_DEMO_NAME} PRIVATE ${OpenCV_LIBRARIES} openvino::runtime ${InferenceEngine_LIBRARIES}
                                                     ${OMZ_DEMO_DEPENDENCIES} ngraph::ngraph utils gflags)
 
     if(UNIX)
@@ -143,6 +143,8 @@ macro(add_demo)
 endmacro()
 
 find_package(OpenCV REQUIRED COMPONENTS core highgui videoio imgproc imgcodecs gapi)
+find_package(OpenVINO REQUIRED COMPONENTS Runtime)
+# TODO: remove InferenceEngine and ngraph after 2022.1
 find_package(InferenceEngine REQUIRED)
 find_package(ngraph REQUIRED)
 

demos/CMakeLists.txt

@@ -88,7 +88,7 @@ def main():
     core = Core()
 
     if 'MYRIAD' in args.device:
-        myriad_config = {'VPU_HW_STAGES_OPTIMIZATION': 'YES'}
+        myriad_config = {'MYRIAD_ENABLE_HW_ACCELERATION': 'YES'}
         core.set_property('MYRIAD', myriad_config)
 
     decoder_target_device = 'CPU'

demos/action_recognition_demo/python/action_recognition_demo.py

@@ -8,7 +8,7 @@ This demo shows how to perform background subtraction using OpenVINO.
 
 ## How It Works
 
-The demo application expects an instance segmentation model in the Intermediate Representation (IR) format with the following constraints:
+The demo application expects an instance segmentation or background matting model in the Intermediate Representation (IR) format with the following constraints:
 1. for instance segmentation models based on `Mask RCNN` approach:
     * One input: `image` for input image.
     * At least three outputs including:
@@ -22,12 +22,29 @@ The demo application expects an instance segmentation model in the Intermediate
         * `conf` with confidence scores for each class for all boxes
         * `mask` with fixed-size mask channels for all boxes.
         * `proto` with fixed-size segmentation heat maps prototypes for all boxes.
+3. for image background matting models:
+    * Two inputs:
+        * `src` for input image
+        * `bgr` for input real background
+    * At least two outputs including:
+        * `fgr` with normalized in [0, 1] range foreground
+        * `pha` with normalized in [0, 1] range alpha
+4. for video background matting models based on RNN architecture:
+    * Five inputs:
+        * `src` for input image
+        * recurrent inputs: `r1`, `r2`, `r3`, `r4`
+    * At least six outputs including:
+        * `fgr` with normalized in [0, 1] range foreground
+        * `pha` with normalized in [0, 1] range alpha
+        * recurrent outputs: `rr1`, `rr2`, `rr3`, `rr4`
 
 The use case for the demo is an online conference where is needed to show only foreground - people and, respectively, to hide or replace background.
 Based on this an instance segmentation model must be trained at least for person class.
 
 As input, the demo application accepts a path to a single image file, a video file or a numeric ID of a web camera specified with a command-line argument `-i`
 
+> **NOTE**: if you use image background matting models, `--background` argument should be specified. This is a background image that equal to a real background behind a person on an input frame and must have the same shape as an input image.
+
 The demo workflow is the following:
 
 1. The demo application reads image/video frames one by one, resizes them to fit into the input image blob of the network (`image`).
@@ -60,6 +77,8 @@ omz_converter --list models.lst
 
 * instance-segmentation-person-????
 * yolact-resnet50-fpn-pytorch
+* background-matting-mobilenetv2
+* robust-video-matting
 
 > **NOTE**: Refer to the tables [Intel's Pre-Trained Models Device Support](../../../models/intel/device_support.md) and [Public Pre-Trained Models Device Support](../../../models/public/device_support.md) for the details on models inference support at different devices.
 
@@ -74,6 +93,7 @@ usage: background_subtraction_demo.py [-h] -m MODEL
                                       [--resize_type {crop,standard,fit_to_window,fit_to_window_letterbox}]
                                       [--labels LABELS]
                                       [--target_bgr TARGET_BGR]
+                                      [--background BACKGROUND]
                                       [--blur_bgr BLUR_BGR]
                                       [-nireq NUM_INFER_REQUESTS]
                                       [-nstreams NUM_STREAMS]
@@ -87,7 +107,8 @@ Options:
   -h, --help            Show this help message and exit.
   -m MODEL, --model MODEL
                         Required. Path to an .xml file with a trained model or
-                        address of model inference service if using OVMS adapter.
+                        address of model inference service if using OVMS
+                        adapter.
   --adapter {openvino,ovms}
                         Optional. Specify the model adapter. Default is
                         openvino.
@@ -110,6 +131,11 @@ Options:
   --target_bgr TARGET_BGR
                         Optional. Background onto which to composite the
                         output (by default to green field).
+  --background BACKGROUND
+                        Optional. Background image for background-matting
+                        model. This is a background image that equal to a real
+                        background behind a person on an input frame and must
+                        have the same shape as an input image.
   --blur_bgr BLUR_BGR   Optional. Background blur strength (by default with
                         value 0 is not applied).
 

demos/background_subtraction_demo/python/README.md

@@ -26,7 +26,8 @@
 
 sys.path.append(str(Path(__file__).resolve().parents[2] / 'common/python'))
 
-from openvino.model_zoo.model_api.models import MaskRCNNModel, OutputTransform, RESIZE_TYPES, YolactModel
+from openvino.model_zoo.model_api.models import MaskRCNNModel, OutputTransform, RESIZE_TYPES, YolactModel, ImageMattingWithBackground, VideoBackgroundMatting
+from openvino.model_zoo.model_api.models.utils import load_labels
 from openvino.model_zoo.model_api.performance_metrics import PerformanceMetrics
 from openvino.model_zoo.model_api.pipelines import get_user_config, AsyncPipeline
 from openvino.model_zoo.model_api.adapters import create_core, OpenvinoAdapter, OVMSAdapter
@@ -44,7 +45,7 @@ def build_argparser():
     args.add_argument('-h', '--help', action='help', default=SUPPRESS, help='Show this help message and exit.')
     args.add_argument('-m', '--model', required=True,
                       help='Required. Path to an .xml file with a trained model '
-                           'or address of model inference service if using ovms adapter.')
+                           'or address of model inference service if using OVMS adapter.')
     args.add_argument('--adapter', help='Optional. Specify the model adapter. Default is openvino.',
                       default='openvino', type=str, choices=('openvino', 'ovms'))
     args.add_argument('-i', '--input', required=True,
@@ -61,6 +62,10 @@ def build_argparser():
     args.add_argument('--labels', help='Optional. Labels mapping file.', default=None, type=str)
     args.add_argument('--target_bgr', default=None, type=str,
                       help='Optional. Background onto which to composite the output (by default to green field).')
+    args.add_argument('--background', default=None, type=str,
+                      help='Optional. Background image for background-matting model. This is a background image '
+                           'that equal to a real background behind a person on an input frame and must have the '
+                           'same shape as an input image.')
     args.add_argument('--blur_bgr', default=0, type=int,
                       help='Optional. Background blur strength (by default with value 0 is not applied).')
 
@@ -99,13 +104,31 @@ def build_argparser():
     return parser
 
 
-def get_model(model_adapter, configuration):
+def get_model(model_adapter, configuration, args):
     inputs = model_adapter.get_input_layers()
     outputs = model_adapter.get_output_layers()
+    need_bgr_input = False
+    is_matting_model = False
     if len(inputs) == 1 and len(outputs) == 4 and 'proto' in outputs.keys():
-        return YolactModel(model_adapter, configuration)
+        model = YolactModel(model_adapter, configuration)
+    elif len(inputs) == 5 and len(outputs) == 6 and 'pha' in outputs.keys():
+        model = VideoBackgroundMatting(model_adapter, configuration)
+        is_matting_model = True
+    elif len(inputs) == 2 and len(outputs) in (2, 3) and 'bgr' in inputs.keys():
+        if args.background is None:
+            raise ValueError('The ImageMattingWithBackground model expects the specified "--background" option.')
+        model = ImageMattingWithBackground(model_adapter, configuration)
+        need_bgr_input = True
+        is_matting_model = True
     else:
-        return MaskRCNNModel(model_adapter, configuration)
+        model = MaskRCNNModel(model_adapter, configuration)
+    if not need_bgr_input and args.background is not None:
+        log.warning('The \"--background\" option works only for ImageMattingWithBackground model. Option will be omitted.')
+
+    if args.raw_output_message and is_matting_model:
+        log.warning('\'--raw_output_message\' argument is set but is used background-matting based model, nothing to show')
+        args.raw_output_message = False
+    return model, need_bgr_input
 
 
 def print_raw_results(outputs, frame_id):
@@ -132,14 +155,13 @@ def fit_to_window(input_img, output_resolution):
     return output
 
 
-def render_results(frame, objects, output_resolution, target_bgr, person_id, blur_kernel=0, show_with_original_frame=False):
-    blur_kernel = tuple([blur_kernel] * 2) if blur_kernel else blur_kernel
-    if target_bgr is None:
-        target_bgr = cv2.blur(frame, blur_kernel) if blur_kernel else np.full(frame.shape, [155, 255, 120], dtype=np.uint8)
-    else:
-        target_bgr = cv2.resize(target_bgr, (frame.shape[1], frame.shape[0]))
-        if blur_kernel:
-            target_bgr = cv2.blur(target_bgr, blur_kernel)
+def process_matting(objects, target_bgr):
+    fgr, pha = objects
+    output = fgr * pha + target_bgr * (1 - pha)
+    return (output * 255).astype(np.uint8)
+
+
+def process_masks(objects, frame, target_bgr, person_id):
     classes, masks = objects[1], objects[3]
     # Choose masks only for person class
     valid_inds = classes == person_id
@@ -154,6 +176,23 @@ def render_results(frame, objects, output_resolution, target_bgr, person_id, blu
         composed_mask = cv2.medianBlur(composed_mask.astype(np.uint8), 11)
         composed_mask = np.repeat(np.expand_dims(composed_mask, axis=-1), 3, axis=2)
         output = np.where(composed_mask == 1, frame, target_bgr)
+    return output
+
+
+def render_results(frame, objects, output_resolution, target_bgr, person_id, blur_kernel=0, show_with_original_frame=False):
+    blur_kernel = tuple([blur_kernel] * 2) if blur_kernel else blur_kernel
+    if target_bgr is None:
+        target_bgr = cv2.blur(frame, blur_kernel) if blur_kernel else np.full(frame.shape, [155, 255, 120], dtype=np.uint8)
+    else:
+        target_bgr = cv2.resize(target_bgr, (frame.shape[1], frame.shape[0]))
+        if blur_kernel:
+            target_bgr = cv2.blur(target_bgr, blur_kernel)
+
+    if len(objects) == 4:
+        output = process_masks(objects, frame, target_bgr, person_id)
+    else:
+        output = process_matting(objects, target_bgr.astype(np.float32) / 255)
+
     if show_with_original_frame:
         output = cv2.hconcat([frame, output])
     h, w = output.shape[:2]
@@ -176,14 +215,17 @@ def main():
     elif args.adapter == 'ovms':
         model_adapter = OVMSAdapter(args.model)
 
-    labels = ['__background__', 'person'] if args.labels is None else args.labels
+    labels = ['__background__', 'person'] if args.labels is None else load_labels(args.labels)
+    assert len(labels), 'The file with class labels is empty'
 
     configuration = {
         'confidence_threshold': args.prob_threshold,
         'resize_type': args.resize_type
     }
 
-    model = get_model(model_adapter, configuration)
+    model, need_bgr_input = get_model(model_adapter, configuration, args)
+
+    input_bgr = open_images_capture(args.background, False).read() if need_bgr_input else None
 
     person_id = -1
     for i, label in enumerate(labels):
@@ -226,7 +268,8 @@ def main():
                                                          cap.fps(), tuple(output_resolution)):
                     raise RuntimeError("Can't open video writer")
             # Submit for inference
-            pipeline.submit_data(frame, next_frame_id, {'frame': frame, 'start_time': start_time})
+            data = {'src': frame, 'bgr': input_bgr} if input_bgr is not None else frame
+            pipeline.submit_data(data, next_frame_id, {'frame': frame, 'start_time': start_time})
             next_frame_id += 1
         else:
             # Wait for empty request

demos/background_subtraction_demo/python/background_subtraction_demo.py

@@ -1,3 +1,5 @@
 # This file can be used with the --list option of the model downloader.
 instance-segmentation-person-????
 yolact-resnet50-fpn-pytorch
+# TODO: background-matting-mobilenetv2
+# TODO: robust-video-matting