エッジの場合 - 3.5 日本語

Vitis AI ライブラリユーザーガイド (UG1354)

Document ID

UG1354

Release Date

2023-06-29

Version

3.5 日本語

Vitis AI ランタイムパッケージと、Vitis AI ライブラリのサンプルおよびモデルは、ビルド済み Vitis AI ボードイメージにコンパイルされています。サンプルは直接実行できます。新しいプログラムを使用する場合は、そのプログラムをホスト側でコンパイルし、実行可能プログラムをターゲットにコピーします。

次に示すように、scp コマンドを使用して vitis_ai_library_r3.5.0_images.tar.gz と vitis_ai_library_r3.5.0_video.tar.gz をホストからターゲットにコピーします。
```
[Host]$scp vitis_ai_library_r3.5.0_images.tar.gz root@IP_OF_BOARD:~/
[Host]$scp vitis_ai_library_r3.5.0_video.tar.gz root@IP_OF_BOARD:~/
```

ターゲット側でイメージおよびビデオパッケージを解凍します。

cd ~
tar -xzvf vitis_ai_library_r3.5*_images.tar.gz -C Vitis-AI/examples/vai_library
tar -xzvf vitis_ai_library_r3.5*_video.tar.gz -C Vitis-AI/examples/vai_library

ターゲットボードでサンプルの抽出ディレクトリに移動し、サンプルをコンパイルします。ここでは、classification の例を示します。
```
cd ~/Vitis-AI/examples/vai_library/samples/classification
```
サンプルを実行します。
```
./test_jpeg_classification resnet50_pt sample_classification.jpg
```
注記: バッチモードがサポートされます。DPU のバッチ数が 1 より大きい場合、次のコマンドも実行できます。
```
./test_jpeg_classification resnet50_pt <img1_url> [<img2_url> ...]
```
実行結果を確認します。
結果を表示する方法は 2 つあります。1 つは、情報を出力して結果を表示する方法です。もう 1 つは、0_sample_classification_result.jpg 画像をダウンロードして表示する方法です。
ビデオサンプルを実行する場合は、次のコマンドを実行します。
```
./test_video_classification resnet50_pt video_input.webm -t 8
```
ここで、video_input.webm は入力ビデオファイル名、-t はスレッド数です。ビデオファイルは各自で用意する必要があります。
注記:
- ビルド済み Vitis AI ボードイメージは、webm または raw 形式のビデオファイル入力のみをサポートします。ネイティブサポートされていない形式のビデオファイルを入力として使用する場合は、ffmpeg パッケージなどの関連するパッケージをターゲットにインストールする必要があります。
- ディスプレイが後処理されたビデオのシンクとして使用されている場合、性能はターゲットのディスプレイインターフェイスでサポートされている最大フレームレートに制限されます。つまり、最大性能を反映していない可能性があり、このことは、最大フレームレートをベンチマークするためにマルチスレッドを有効にした場合に特に重要です。ただし、次のコマンドを実行することで、Vitis AI ライブラリの最大推論性能をテストできます。
```
env DISPLAY=:0.0 DEBUG_DEMO=1 ./test_video_classification \
resnet50_pt 'multifilesrc location=~/video_input.webm \
! decodebin  !  videoconvert ! appsink sync=false' -t 2
```
入力として USB カメラを使用してプログラムをテストする場合は、次のコマンドを実行します。
```
./test_video_classification resnet50_pt 0 -t 4
```
ここで、0 は最初の USB カメラのデバイスノードです。複数の USB カメラがある場合、この値を 1、2、3、のように指定します。-t はスレッド数です。
重要: test_video サンプルに対して Linux Windows サブシステムターゲットが正常に動作することが求められるため、SSH ターミナルを使用してボードにログインする際に、次のコマンドを実行して「X11 forwarding」を有効にする必要があります (この例では、ホストマシンの IP アドレスを 192.168.0.10 とします)。
```
export DISPLAY=192.168.0.10:0.0
```
モデルの性能をテストする場合、次のコマンドを実行します。
```
./test_performance_classification resnet50_pt test_performance_classification.list -t 8 -s 60 
```
ここで、-t はスレッド数、-s は秒数です。

実行ファイルのコマンドラインオプションの一覧をすべて表示するには、コマンドに '-h' スイッチを付けて実行します。
デモの実行については、アプリケーションデモを参照してください。