Windows で OpenPose 最新版をソースコードからビルドして、使ってみる（Visual C++ ビルドツール (Build Tools) を使用）

前準備

Python, 主要パッケージ, git, cmake, 7-Zip のインストール

• Windows での Git, cmake のインストール手順は，別ページで説明している．
• Ubuntu でのインストール手順は、 別の Web ページの 始めから TensorFlow, Keras のインストールで説明している．

以下，Windows でインストール済みであるものとして説明を続ける．

（Windowsの場合のみ）Visual C++ ビルドツール (Build Tools) のインストール

• Windows でのインストール手順は、 「Windows で Visual C++ ビルドツール (Build Tools) for Visual Studio 2017 のインストール（Chocolatey を利用）」で説明している．

（NVIDIA GPU を使うとき）NVIDIA グラフィックスボード・ドライバのインストール

※ GPU とは，グラフィックス・プロセッシング・ユニットの略で、コンピュータグラフィックス関連の機能，乗算や加算の並列処理の機能などがある．

ダウンロードページ

• NVIDIA グラフィックスボード・ドライバのダウンロード用ページ: https://www.nvidia.co.jp/Download/index.aspx?lang=jp

詳しくは，次のように別ページで説明している．インストール手順が分からなくなったり，不具合があったときは，次に書いている別ページの説明を確認すること．

• Windows での NVIDIA グラフィックスボード・ドライバのインストール: 別ページで説明している．
• Ubuntu での NVIDIA グラフィックスボード・ドライバのインストール: 別ページで説明している．

（NVIDIA GPU を使うとき）NVIDIA CUDA ツールキットのインストール

※ CUDA とは，NVIDIA社が提供している GPU 用のプラットフォームである．

ダウンロードページ

• NVIDIA CUDA ツールキットのダウンロード用ページ: https://developer.nvidia.com/cuda-toolkit-archive

詳細説明

• Windows での NVIDIA CUDA ツールキットのインストール: 別ページで説明している．
• Ubuntu での NVIDIA CUDA ツールキットのインストール: 別ページで説明している．

（NVIDIA GPU を使うとき）NVIDIA cuDNN のインストール

ダウンロードページ

• NVIDIA cuDNN のダウンロード用ページ: https://developer.nvidia.com/cudnn から cuDNN を入手

  ダウンロードして展開（解凍）したら，パスを通しておくこと．

詳細説明

• Windows での NVIDIA CUDA ツールキットのインストール: 別ページで説明している．
• Ubuntu での NVIDIA CUDA ツールキットのインストール: 別ページで説明している．

OpenPose のインストール

次のWebページの記述に従う

https://github.com/CMU-Perceptual-Computing-Lab/openpose/blob/master/doc/installation.md

1. VS 2017用 x64 Native Tools コマンドプロンプトを管理者として開く

   ※ Windows のスタートメニューの「Visual Studio 2017」の下にある

   ※ Visual Studio 2017 がないときは、Visual C++ ビルドツール (Build Tools) for Visual Studio 2017 のインストールを行う

2. ディレクトリを削除する

   mkdir C:\tools
   cd C:\tools
   rmdir /s /q openpose
   
3. OpenCV と OpenCV contrib のソースコードをダウンロード

   cd C:\tools
   git clone --recursive https://github.com/CMU-Perceptual-Computing-Lab/openpose
   
4. cmake の実行

   cmake でのオプションについて

   「Visual Studio 16 2019 Win64」のところは， cmake のオプションである． 使用する Visual Studio のバージョンに応じて調整すること

   cmake の実行手順例は次の通り

   ※ cmakeで「build」のような作業用ディレクトリは作らない（トラブルを抑えるため）

   cd c:\tools
   cd openpose
   del CMakeCache.txt
   cmake -G "Visual Studio 16 2019" -T host=x64 ^
   -DDOWNLOAD_BODY_25_MODEL=ON ^
   -DDOWNLOAD_BODY_COCO_MODEL=ON ^
   -DDOWNLOAD_BODY_MPI_MODEL=ON ^
   .
   
5. cmake の実行結果の確認

   ※ 下図のとおりになるとは限らない．設定がうまくいっていない場合は、1つ上の「cmake の実行」のところを、設定を変えてやり直す．
6. ソースコードからビルドし、インストールする

   cmake --build . --config release
   
7. 結果の確認

   エラーメッセージが出ていないことを確認．最後のほうに「0 エラー」のように表示されるのを確認．

   ※ 黄色の警告メッセージは無視しても良い
8. ファイルの配置の調整

   ※ 将来の版では、この操作は不要になる可能性あり

   cd c:\tools
   cd openpose
   copy x64\release\*.* bin
   

9. 新しくWindows のコマンドプロンプトを実行する．
10. デモプログラムを試す
    • 付属のビデオファイルを使用

      cd c:\tools
      cd openpose
      bin\OpenPoseDemo.exe --video examples\media\video.avi
      
    • 付属の画像ファイルを使用

      cd c:\tools
      cd openpose
      bin\OpenPoseDemo.exe --image_dir examples\media
      
    • パソコンにカメラがついている場合

      cd c:\tools
      cd openpose
      bin\OpenPoseDemo.exe
      

    ※ しばらく待つと表示される。 処理時間は、CPU 版だと、｀１フレームあたり、10秒くらい

11. オプションの確認

    cd c:\tools
    cd openpose
    bin\OpenPoseDemo.exe --help
    

    
    （以下省略）
12. --face, --hand オプションを試してみる

    参考 Web ページ: https://github.com/CMU-Perceptual-Computing-Lab/openpose/blob/master/doc/quick_start.md#quick-start

    cd c:\tools
    cd openpose
    bin\OpenPoseDemo.exe --image_dir examples\media -face --hand
    
13. --write_json オプションを試してみる

    ※ 末尾の「.」（半角ピリオド）はディレクトリの指定

    cd c:\tools
    cd openpose
    bin\OpenPoseDemo.exe --image_dir examples\media --write_json .
    

    .json ファイルができていることがわかる