このクイック スタートでは、Azure Kinect DK でボディ トラッキングを実行するプロセスについて説明します。
システム要件
Body Tracking SDK には、ホスト PC に NVIDIA GPU がインストールされている必要があります。 推奨されるボディ トラッキング ホスト 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 をダウンロードする] リンクを選択します
- PC に Body Tracking SDK をインストールします。
ボディトラッキングを確認する
Azure Kinect Body Tracking Viewer を起動して、Body Tracking SDK が正しく設定されていることを確認します。 ビューアーは SDK msi インストーラーと共にインストールされます。 スタート メニューまたは <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exeで見つけることができます。
十分な強力な GPU がなく、結果をテストする場合は、次のコマンドを使用してコマンド ラインで Azure Kinect Body Tracking Viewer を起動できます。 <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exe CPU
すべてが正しく設定されている場合は、3D ポイント クラウドと追跡対象のボディを含むウィンドウが表示されます。
ONNX ランタイム実行環境の指定
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 ランタイムには、高速化されていないオペコードの警告が表示されます。 これらは無視しても問題ありません。
ONNX ランタイムには、TensorRT モデルのキャッシュを制御するための環境変数が含まれています。 推奨される値は次のとおりです。
- ORT_TENSORRT_ENGINE_CACHE_ENABLE=1
- ORT_TENSORRT_CACHE_PATH="pathname"
体の追跡を開始する前に、フォルダーを作成する必要があります。
重要
TensorRT では、推論の前にモデルが事前に処理されるため、他の実行環境と比較して起動時間が長くなります。 エンジン キャッシュでは、これは最初の実行に制限されますが、実験段階であり、モデル、ONNX ランタイム バージョン、TensorRT バージョン、GPU モデルに固有です。
TensorRT 実行環境では、FP32 (既定) と FP16 の両方がサポートされます。 FP16は性能が約2倍向上する代わりに、精度がわずかに低下します。 FP16 を指定するには:
- ORT_TENSORRT_FP16_ENABLE=1
ONNX ランタイム実行環境に必要な 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の使用方法に関する例については、こちらをご覧ください。