クイック スタート:Azure Kinect の体のトラッキングを設定する
このクイックスタートでは、Azure Kinect DK で体のトラッキングを実行するプロセスについて説明します。
システム要件
Body Tracking SDK では、NVIDIA GPU がホスト PC にインストールされている必要があります。 体のトラッキングのホスト PC の推奨要件は、システムの要件に関するページで説明しています。
ソフトウェアをインストールする
最新の NVIDIA ドライバーをインストールする
使用するグラフィックス カード用の最新の NVIDIA ドライバーをダウンロードしてインストールします。 以前のドライバーは、体トラッキング SDK と共に再頒布される CUDA バイナリと互換性がない場合があります。
Visual Studio 2015 の Visual C++ 再頒布可能パッケージ
Visual Studio 2015 の Visual C++ 再頒布可能パッケージをダウンロードしてインストールします。
ハードウェアを設定する
Azure Kinect DK を設定する
Azure Kinect ビューアーを起動して、Azure Kinect DK が正しく設定されていることを確認します。
Body Tracking SDK をダウンロードする
- Body Tracking SDK をダウンロードするためのリンクを選択します。
- Body Tracking SDK を PC にインストールします。
体のトラッキングを検証する
Azure Kinect Body Tracking Viewer を起動して、Body Tracking SDK が正しく設定されていることを確認します。 ビューアーは SDK の msi インストーラーによってインストールされます。 [スタート] メニューまたは <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exe にあります。
十分な性能の GPU がなくても結果をテストする必要がある場合は、コマンド ラインでコマンド <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exe CPU を使用して、Azure Kinect Body Tracking Viewer を起動できます。
すべてが正しく設定されている場合、3D 点群とトラッキングされた体を含むウィンドウが表示されます。
ONNX Runtime 実行環境の指定
Body Tracking SDK では、CPU、CUDA、DirectML (Windows のみ)、および TensorRT の実行環境がサポートされており、姿勢推定モデルを推論できます。 K4ABT_TRACKER_PROCESSING_MODE_GPU は、Linux では CUDA、Windows では DirectML が既定になります。 特定の実行環境を選択するために、K4ABT_TRACKER_PROCESSING_MODE_GPU_CUDA、K4ABT_TRACKER_PROCESSING_MODE_GPU_DIRECTML、K4ABT_TRACKER_PROCESSING_MODE_GPU_TENSORRT の 3 つの追加のモードが追加されました。
注意
ONNX Runtime は、アクセラレートされないオペコードの警告を表示します。 これらは無視しても問題ありません。
ONNX Runtime には、TensorRT モデルのキャッシュを制御するための環境変数が含まれています。 推奨値は次のとおりです。
- ORT_TENSORRT_ENGINE_CACHE_ENABLE=1
- ORT_TENSORRT_CACHE_PATH="pathname"
本文の追跡を開始する前に、フォルダーを作成する必要があります。
重要
TensorRT では、推論の前にモデルが事前に処理されるため、他の実行環境と比較すると、開始時間が長くかかります。 エンジン キャッシュはこれを最初の実行に限定しますが、これは実験的なものであり、モデル、ONNX Runtime バージョン、TensorRT バージョン、および GPU モデルに固有です。
TensorRT 実行環境では、FP32 (既定) と FP16 の両方がサポートされます。 FP16 は、精度の低下を最小限に抑えるために、最大 2 倍のパフォーマンスを引き換えにします。 FP16 を指定するには、次のようにします。
- ORT_TENSORRT_FP16_ENABLE=1
ONNX Runtime 実行環境に必要な DLL
| モード | ORT 1.10 | CUDA 11.4.3 | CUDNN 8.2.2.26 | TensorRT 8.0.3.4 |
|---|---|---|---|---|
| CPU | msvcp140 | - | - | - |
| onnxruntime | ||||
| CUDA | msvcp140 | cudart64_110 | cudnn64_8 | - |
| onnxruntime | cufft64_10 | cudnn_ops_infer64_8 | ||
| onnxruntime_providers_cuda | cublas64_11 | cudnn_cnn_infer64_8 | ||
| onnxruntime_providers_shared | cublasLt64_11 | |||
| DirectML | msvcp140 | - | - | - |
| onnxruntime | ||||
| directml | ||||
| TensorRT | msvcp140 | cudart64_110 | - | nvinfer |
| onnxruntime | cufft64_10 | nvinfer_plugin | ||
| onnxruntime_providers_cuda | cublas64_11 | |||
| onnxruntime_providers_shared | cublasLt64_11 | |||
| onnxruntime_providers_tensorrt | nvrtc64_112_0 | |||
| nvrtc-builtins64_114 |
例
体トラッキング SDK の使用方法の例については、こちらをご覧ください。