スマート・クラスルーム C++ G-API デモ

example

このデモでは、教室環境で生徒の行動を検出し (person-detection-action-recognition-0005 モデルでは座る、立つ、手を上げる、person-detection-action-recognition-0006 モデルでは座る、立つ、手を上げる、立つ、向きを変える、机の上に横になる)、人を顔を認識するために、複数のニューラル・ネットワークを共同使用する例が示されています。アクションおよび顔検出ネットワークに Async API を使用します。これにより、顔認識と検出の実行を並列化できます。顔認識が 1 つのアクセラレーターで実行されている間に、顔とアクションの検出を別のアクセラレーターで実行できます。デモでは、次の事前トレーニングされたモデルのセットを使用できます。

  • face-detection-adas-0001、これは顔を検出する主要な検出ネットワークです。

  • landmarks-regression-retail-0009、これは最初のネットワークからの結果に基づいて実行され、検出された顔ごとに顔のランドマークのベクトルを出力します。

  • person-detection-action-recognition-0005、これは人を検出すると同時にその人の現在の行動 (3 つの行動: 座る、立つ、手を上げる) を予測する検出ネットワークです。

  • person-detection-action-recognition-0006、これは人を検出すると同時にその人の現在の行動 (6 つの行動: 座る、書く、手を上げる、立つ、振り向く、机に横たわる) を予測する検出ネットワークです。

  • person-detection-raisinghand-recognition-0001、これは生徒を検出すると同時に、生徒の現在の行動を予測する検出ネットワークです (以前のモデルとは対照的に、生徒が手を挙げているかどうかのみを予測します)。

  • person-detection-action-recognition-teacher-0002、これは人を検出し、同時にその人の現在の行動を予測する検出ネットワークです。

動作の仕組み

起動時に、アプリケーションはコマンドライン・パラメーターを読み取り、-m... オプションファミリーに応じて異なるデバイスで実行する 4 つのネットワークを読み込みます。デモには 2 つの部分が含まれています。最初の部分は、ギャラリーからの顔を処理します。2 番目の部分は、検出および認識機能です。どちらもグラフです。顔ギャラリーグラフはフレームを取得し、顔検出ネットワークの推論を実行します。顔検出器によって取得された ROI は、顔ランドマーク回帰ネットワークに供給されます。次に、ランドマークを使用してアフィン変換によって顔を位置合わせし、顔認識ネットワークにフィードします。出力には、ギャラリーからの各顔のアイデンティティー・メトリックが含まれます。メイングラフは入力ソースからのフレームを処理します。最初のステップはギャラリーの処理と同じです。これらは、顔検出、ランドマーク回帰、顔認識ネットワークと同じ操作です。これに加えて、グラフはアクション検出ネットワークを実行します。認識された顔と検出された動作が照合され、フレームごとに認識された人物の動作が検出されます。次に、結果をフレームに描画します。出力には、処理されたフレームとログが含まれます。

注: デフォルトでは、Open Model Zoo のデモは BGR チャネル順序での入力を期待します。RGB 順序で動作するようにモデルをトレーニングした場合は、サンプルまたはデモ・アプリケーションでデフォルトのチャネル順序を手動で再配置するか、--reverse_input_channels 引数を指定したモデル・オプティマイザー・ツールを使用してモデルを再変換する必要があります。引数の詳細については、[前処理計算の埋め込み](@ref openvino_docs_MO_DG_Additional_Optimization_Use_Cases) の入力チャネルを反転するセクションを参照してください。

実行の準備

デモ入力画像またはビデオファイルについては、Open Model Zoo デモの概要のデモに使用できるメディアファイルのセクションを参照してください。デモでサポートされるモデルリストは、<omz_dir>/demos/smart_classroom_demo/cpp_gapi/models.lst ファイルにあります。このファイルは、モデル・ダウンローダーおよびコンバーターのパラメーターとして使用され、モデルをダウンロードし、必要に応じて OpenVINO IR 形式 (*.xml + *.bin) に変換できます。

モデル・ダウンローダーの使用例:

omz_downloader --list models.lst

モデル・コンバーターの使用例:

omz_converter --list models.lst

サポートされるモデル

  • face-detection-adas-0001

  • face-recognition-resnet100-arcface-onnx

  • face-reidentification-retail-0095

  • facenet-20180408-102900

  • landmarks-regression-retail-0009

  • person-detection-action-recognition-0005

  • person-detection-action-recognition-0006

  • person-detection-action-recognition-teacher-0002

  • person-detection-raisinghand-recognition-0001

注: 各種デバイス向けのモデル推論サポートの詳細については、インテルの事前トレーニング・モデルのデバイスサポートパブリックの事前トレーニング・モデルのデバイスサポートの表を参照してください。

実行

-h オプションを指定してアプリケーションを実行すると、使用方法が表示されます。

smart_classroom_demo_gapi [OPTION]
Options:

-h                                          Print a usage message.
-i                                          Required. An input to process. The input must be a single image, a folder of images, video file or camera id.
-loop                                       Optional. Enable reading the input in a loop.
-read_limit                                 Optional. Read length limit before stopping or restarting reading the input.
-o "<path>"                                 Optional. Name of the output file(s) to save. Frames of odd width or height can be truncated. See https://github.com/opencv/opencv/pull/24086
-limit "<num>"                              Optional. Number of frames to store in output. If 0 is set, all frames are stored.
-m_act '<path>'                             Required. Path to the Person/Action Detection Retail model (.xml) file.
-m_fd '<path>'                              Required. Path to the Face Detection model (.xml) file.
-m_lm '<path>'                              Required. Path to the Facial Landmarks Regression Retail model (.xml) file.
-m_reid '<path>'                            Required. Path to the Face Reidentification Retail model (.xml) file.
Or
-d_act '<device>'                           Optional. Specify the target device for Person/Action Detection Retail (the list of available devices is shown below). Default value is CPU. The application looks for a suitable plugin for the specified device.
-d_fd '<device>'                            Optional. Specify the target device for Face Detection Retail (the list of available devices is shown below). Default value is CPU. The application looks for a suitable plugin for the specified device.
-d_lm '<device>'                            Optional. Specify the target device for Landmarks Regression Retail (the list of available devices is shown below). Default value is CPU. The application looks for a suitable plugin for the specified device.
-d_reid '<device>'                          Optional. Specify the target device for Face Reidentification Retail (the list of available devices is shown below). Default value is CPU. The application looks for a suitable plugin for the specified device.
-greedy_reid_matching                       Optional. Use faster greedy matching algorithm in face reid.
-r                                          Optional. Output Inference results as raw values.
-ad                                         Optional. Output file name to save per-person action statistics in. Requires -teacher_id and -a_top to be unset and -fg to be set
-t_ad                                       Optional. Probability threshold for person/action detection.
-t_ar                                       Optional. Probability threshold for action recognition.
-t_fd                                       Optional. Probability threshold for face detections.
-inh_fd                                     Optional. Input image height for face detector.
-inw_fd                                     Optional. Input image width for face detector.
-exp_r_fd                                   Optional. Expand ratio for bbox before face recognition.
-t_reid                                     Optional. Cosine distance threshold between two vectors for face reidentification.
-fg                                         Optional. Path to a faces gallery in .json format.
-teacher_id                                 Optional. ID of a teacher. You must also set a faces gallery parameter (-fg) to use it.
-no_show                                    Optional. Don't show output.
-min_ad                                     Optional. Minimum action duration in seconds.
-d_ad                                       Optional. Maximum time difference between actions in seconds.
-student_ac                                 Optional. List of student actions separated by a comma.
-top_ac                                     Optional. List of student actions (for top-k mode) separated by a comma.
-teacher_ac                                 Optional. List of teacher actions separated by a comma.
-top_id                                     Optional. Target action name.
-a_top                                      Optional. Number of first K students. If this parameter is positive, the demo detects first K persons with the action, pointed by the parameter 'top_id'
-crop_gallery                               Optional. Crop images during faces gallery creation.
-t_reg_fd                                   Optional. Probability threshold for face detections during database registration.
-min_size_fr                                Optional. Minimum input size for faces during database registration.
-al                                         Optional. Output file name to save per-person action detections in.
-ss_t                                       Optional. Number of frames to smooth actions.
-u                                          Optional. List of monitors to show initially.

オプションのリストを空にしてアプリケーションを実行すると、エラーメッセージが表示されます。

生徒のアクションを認識するために事前トレーニングされたモデルを使用してアプリケーションを実行する有効なコマンドラインの例:

./smart_classroom_demo_gapi \
    -i <path_to_video> \
    -m_act <path_to_model>/person-detection-action-recognition-0005.xml \
    -student_ac "sitting, standing, raising hand" \
    -m_fd <path_to_model>/face-detection-adas-0001.xml \
    -m_reid <path_to_model>/face-reidentification-retail-0095.xml \
    -m_lm <path_to_model>/landmarks-regression-retail-0009.xml \
    -t_reid 0.8 \
    -fg <path_to_faces_gallery.json>

注: 生徒のアクションを認識するには、3 つの基本アクションには person-detection-action-recognition-0005 モデルを、6 つのアクションには person-detection-action-recognition-0006 モデルを使用します。

教師のアクションを認識するアプリケーションを実行する有効なコマンドラインの例:

./smart_classroom_demo_gapi \
    -i <path_to_video> \
    -m_act <path_to_model>/person-detection-action-recognition-teacher-0002.xml \
    -m_fd <path_to_model>/face-detection-adas-0001.xml \
    -m_reid <path_to_model>/face-reidentification-retail-0095.xml \
    -m_lm <path_to_model>/landmarks-regression-retail-0009.xml \
    -fg <path to faces_gallery.json> \
    -top_id \
    -teacher_id <ID of a teacher in the face gallery>

注: 教師のアクションを認識するには、person-detection-action-recognition-teacher-0002 モデルを使用します。認識されるアクションのリストの詳細については、モデルの説明を参照してください。

最初に挙手をした学生を認識するアプリケーションを実行する有効なコマンドラインの例:

./smart_classroom_demo_gapi \
  -i <path_to_video> \
  -m_act <path_to_model>/person-detection-raisinghand-recognition-0001.xml \
  -a_top <number of first raised-hand students> \

注: 生徒の挙手動作を認識するには、person-detection-raisinghand-recognition-0001 モデルを使用します。認識されるアクションのリストの詳細については、モデルの説明を参照してください。

デモの出力

デモでは OpenCV を使用して、ラベル付きのアクションと面を含む結果フレームを表示します。
デモレポート:

  • FPS: ビデオフレーム処理の平均レート (1 秒あたりのフレーム数)。

これらのメトリックを使用して、アプリケーション・レベルのパフォーマンスを測定できます。