Avvio rapido: Configurare il rilevamento del corpo di Azure Kinect DK

Questo argomento di avvio rapido illustra la procedura per eseguire il rilevamento del corpo in Azure Kinect DK.

Requisiti di sistema

Body Tracking SDK richiede una GPU NVIDIA installata nel PC host. Il requisito consigliato del PC host di rilevamento del corpo è descritto nella pagina Requisiti di sistema.

Installazione del software

Installare il driver NVIDIA più recente

Scaricare e installare il driver NVIDIA più recente per la scheda grafica. I driver meno recenti potrebbero non essere compatibili con i file binari CUDA ridistribuiti con Body Tracking SDK.

Visual C++ Redistributable per Visual Studio 2015

Scaricare e installare Microsoft Visual C++ Redistributable per Visual Studio 2015.

Configurare l'hardware

Configurare Azure Kinect DK

Avviare il visualizzatore di Azure Kinect per verificare che Azure Kinect DK sia configurato correttamente.

Scaricare Body Tracking SDK

  1. Selezionare il collegamento per scaricare Body Tracking SDK
  2. Installare Body Tracking SDK nel PC.

Verificare il rilevamento del corpo

Avviare il visualizzatore di rilevamento del corpo di Azure Kinect per verificare che Body Tracking SDK sia configurato correttamente. Il visualizzatore viene installato con il programma di installazione MSI dell'SDK. È possibile trovarlo nel menu Start o in <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exe.

Se non si dispone di una GPU sufficientemente potente e si vuole comunque testare il risultato, è possibile avviare il Visualizzatore di rilevamento del corpo di Azure Kinect nella riga di comando con il comando seguente: <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exe CPU

Se tutte le impostazioni sono configurate correttamente, verrà visualizzata una finestra con una nuvola di punti 3D e i corpi rilevati.

Body Tracking 3D Viewer

Specifica dell'ambiente di esecuzione del runtime ONNX

Body Tracking SDK supporta gli ambienti di esecuzione CPU, CUDA, DirectML (solo Windows) e TensorRT per dedurre il modello di stima della posa. K4ABT_TRACKER_PROCESSING_MODE_GPU Impostazione predefinita per l’esecuzione di CUDA in Linux e per l’esecuzione di DirectML in Windows. Sono state aggiunte tre ulteriori modalità per selezionare ambienti di esecuzione specifici: K4ABT_TRACKER_PROCESSING_MODE_GPU_CUDA, K4ABT_TRACKER_PROCESSING_MODE_GPU_DIRECTMLe K4ABT_TRACKER_PROCESSING_MODE_GPU_TENSORRT.

Nota

ONNX Runtime visualizza gli avvisi dei codici operativi non accelerati. Questi si possono ignorare senza problemi.

ONNX Runtime include variabili di ambiente per controllare la memorizzazione nella cache del modello TensorRT. I valori consigliati sono:

  • ORT_TENSORRT_ENGINE_CACHE_ENABLE=1
  • ORT_TENSORRT_CACHE_PATH="pathname"

La cartella deve essere creata prima di avviare il rilevamento del corpo.

Importante

TensorRT pre-elabora il modello prima dell'inferenza, causando tempi di avvio estesi rispetto ad altri ambienti di esecuzione. La memorizzazione nella cache del motore limita questa operazione alla prima esecuzione, ma è sperimentale ed è specifica per il modello, la versione del runtime ONNX, la versione TensorRT e il modello GPU.

L'ambiente di esecuzione TensorRT supporta sia FP32 (impostazione predefinita) che FP16. FP16 aumenta di 2 volte le prestazioni contro una diminuzione minima di accuratezza. Specifica di FP16:

  • ORT_TENSORRT_FP16_ENABLE=1

DLL necessarie per gli ambienti di esecuzione del runtime ONNX

Modalità 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

Esempi

È possibile trovare gli esempi su come usare Body Tracking SDK qui.

Passaggi successivi