OpenPose 1.7.0 のインストール,デモの実行(Windows 上)

OpenPose は AI による姿勢,手,足,表情の認識ソフトウェア.Pythonインタフェースもある.

URL: https://github.com/CMU-Perceptual-Computing-Lab/openpose

ライセンス: 「ACADEMIC OR NON-PROFIT ORGANIZATION NONCOMMERCIAL RESEARCH USE ONLY」 https://github.com/CMU-Perceptual-Computing-Lab/openpose/blob/master/LICENSE のように定められているので,利用者側で確認すること.

このページでは,Windows での,OpenPose のインストール手順をスクリーンショット等で説明する.

サイト内の関連ページ

謝辞:このWebページで紹介する OpenPose ソフトウェアの作者に感謝します

前準備

Build Tools for Visual Studio 2022 のインストール(Windows 上)

以下のコマンドを管理者権限コマンドプロンプトで実行する (手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。

REM VC++ ランタイム
winget install --scope machine --accept-source-agreements --accept-package-agreements --silent --id Microsoft.VCRedist.2015+.x64

REM Build Tools + Desktop development with C++(VCTools)+ 追加コンポーネント(一括)
winget install --id Microsoft.VisualStudio.2022.BuildTools ^
  --override "--passive --wait --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.ComponentGroup.ClangCL --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.Windows11SDK.26100"

--add で追加されるコンポーネント

上記のコマンドでは,まず Build Tools 本体と Visual C++ 再頒布可能パッケージをインストールし,次に setup.exe を用いて以下のコンポーネントを追加している。

インストール完了の確認

winget list Microsoft.VisualStudio.2022.BuildTools

上記以外のコンポーネントが必要になった場合は Visual Studio Installer で個別にインストールできる。

Python 3.7 のインストール

以下のいずれかの方法で Python 3.7 をインストールする。

方法1:winget によるインストール

Python がインストール済みの場合、この手順は不要である。管理者権限コマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install -e --id Python.Python.3.7 --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 AssociateFiles=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2:インストーラーによるインストール

  1. Python 公式サイト(https://www.python.org/downloads/)にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
  2. ダウンロードしたインストーラーを実行する。
  3. 初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
  4. 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号(例:Python 3.7.x)が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

Build Tools for Visual Studio 2022 のインストール(Windows 上)

以下のコマンドを管理者権限コマンドプロンプトで実行する (手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。

REM VC++ ランタイム
winget install --scope machine --accept-source-agreements --accept-package-agreements --silent --id Microsoft.VCRedist.2015+.x64

REM Build Tools + Desktop development with C++(VCTools)+ 追加コンポーネント(一括)
winget install --id Microsoft.VisualStudio.2022.BuildTools ^
  --override "--passive --wait --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.ComponentGroup.ClangCL --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.Windows11SDK.26100"

--add で追加されるコンポーネント

上記のコマンドでは,まず Build Tools 本体と Visual C++ 再頒布可能パッケージをインストールし,次に setup.exe を用いて以下のコンポーネントを追加している。

インストール完了の確認

winget list Microsoft.VisualStudio.2022.BuildTools

上記以外のコンポーネントが必要になった場合は Visual Studio Installer で個別にインストールできる。

NVIDIA CUDA 13.1 のインストール(Windows 上)

以下のコマンドを管理者権限コマンドプロンプトで実行する (手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。

REM CUDAをシステム領域にインストール、最新版に更新(NVIDIA GPU搭載機のみ)
winget install --scope machine --id Nvidia.CUDA -e --silent --accept-package-agreements --accept-source-agreements
winget upgrade --scope machine --id Nvidia.CUDA -e --silent --accept-package-agreements --accept-source-agreements

REM CUDA のパス設定
set "CUDA_PATH=C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v13.1"
set "CUDNN_PATH=C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v13.1"
if exist "%CUDA_PATH%" setx CUDA_PATH "%CUDA_PATH%" /M >nul
if exist "%CUDNN_PATH%" setx CUDNN_PATH "%CUDNN_PATH%" /M >nul
for /f "skip=2 tokens=2*" %a in ('reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path') do set "SYSTEM_PATH=%b"
if exist "%CUDA_PATH%\bin" (
    echo "%SYSTEM_PATH%" | find /i "%CUDA_PATH%\bin" >nul
    if errorlevel 1 setx PATH "%CUDA_PATH%\bin;%SYSTEM_PATH%" /M >nul
)

REM 環境変数TEMP, TMPの設定(一時ファイルの保存先を短いパスに変更)
mkdir C:\TEMP
set "TEMP_PATH=C:\TEMP"
setx TEMP "%TEMP_PATH%" /M >nul
setx TMP "%TEMP_PATH%" /M >nul

OpenPose 1.7.0 のインストール

  1. Web ブラウザで、OpenPose のリリース(release)のWebページを開く

    https://github.com/CMU-Perceptual-Computing-Lab/openpose/releases

  2. ファイルを選ぶ

    「Assets」が展開されていないときは展開する.

    Windows 版が公開されているもののうち、最新のものを選ぶことにする. CPU版,GPU版を選ぶことができる

  3. ZIP ファイルのダウンロードが始まる
  4. ダウンロードした .zip ファイルを、 C:\ の直下展開(解凍)するなど,分かりやすいディレクトリに置く.
    Windows での展開(解凍)に便利な 7-Zip: 別ページ »で説明
  5. 展開(解凍)により,ディレクトリができるので確認する

    GPU 版の場合:openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended のような名前

    CPU 版の場合:openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d のような名前

  6. できたディレクトリを,C:\ の直下にコピーする.

    次のようになる(次の図は GPU 版の場合)

  7. Windowsシステム環境変数 Pathに,追加することにより,パスを通す
    • GPU 版の場合C:\openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended\openpose\bin を追加

      Windows で,管理者権限コマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」)。

      次のコマンドを実行

      powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";C:\openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended\openpose\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
      
    • CPU 版の場合C:\openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d\openpose\bin を追加

      Windows で,管理者権限コマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」)。

      次のコマンドを実行

      powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";C:\openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d\openpose\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
      
  8. modelsの下の getBaseModels.bat を実行する

    モデルデータがダウンロードが始まる。しばらく待つ

    • GPU 版の場合

      Windows で,コマンドプロンプトを実行. 次のコマンドを実行.

      cd C:\openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended
      cd openpose
      cd models
      getBaseModels.bat
      
    • CPU 版の場合

      Windows で,コマンドプロンプトを実行. 次のコマンドを実行.

      cd C:\openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d
      cd openpose
      cd models
      getBaseModels.bat
      
  9. 終了の確認

    エラーメッセージが出ていないことを確認(下図は GPU 版の場合)

デモの実行