GPU 環境のチェックおよびアプリの設定

GPU 環境のチェックアプリは、開発用コンピューター上と、NVIDIA^®DRIVE や Jetson などの組み込みハードウェアプラットフォーム上の GPU コード生成環境を検証および設定するための対話型ツールです。

アプリを起動するには、MATLAB^®コマンドウィンドウで次のように入力します。

gpucoderSetup

GPU 環境のチェックアプリを使用して以下ができます。

GPU コード生成に必要な NVIDIA コンパイラおよびライブラリについて、ホスト開発用コンピューターの環境を検証します。
基本的なコードの生成を実行し、ホストコンピューターの GPU デバイスで生成コードの実行をテストします。このテストでは、MATLAB シミュレーションと結果を比較することでコード実行を検証します。
開発用コンピューターで深層学習のコード生成と実行テストを実行します。NVIDIA cuDNN または TensorRT ライブラリをターゲットにすることができます。GPU Coder™ Interface for Deep Learning Librariesサポートパッケージが必要です。
DRIVE や Jetson などの組み込み NVIDIA ボードに接続し、コード生成と実行テストを実行します。GPU Coder Support Package for NVIDIA GPUsが必要です。
ライブラリの場所を指定し、GPU Coder で必要な環境変数を設定する MATLAB スクリプトを生成します。

メモ

gpucoderSetupアプリは現在のフォルダーにレポートファイルを生成します。現在のフォルダーの書き込み権限がない場合は、アプリを実行する前に MATLABcdコマンドを使用してフォルダーを変更します。

Sample screen shot of the GPU environment check app

ハードウェア設定

アプリの[Check/Setup]パネルには、ホスト開発コンピューターまたは NVIDIA DRIVE や Jetson などのハードウェアプラットフォームで GPU デバイスを選択できるドロップダウンリストが提供されます。

オプション	値	説明
ハードウェアの選択	`Host (for MEX)`	ホスト開発コンピューターでコード生成、コード実行、および環境のチェックを実行します。アプリによりテストを実行する CUDA^®MEX が生成されます。開発用コンピューターに複数の GPU デバイスがある場合、[GPU の選択]オプションを使用して該当する GPU デバイスを選択します。
	`Drive`	NVIDIA DRIVE ターゲットプラットフォームでコード生成とコード実行のチェックを実行します。 GPU Coder Support Package for NVIDIA GPUsのインストール後、[Board Settings]パネルを使用してターゲットの接続パラメーターを指定します。
	`Jetson`	英伟达杰森ターゲットプラットフォームでコード生成とコード実行のチェックを実行します。 GPU Coder Support Package for NVIDIA GPUsのインストール後、[Board Settings]パネルを使用してターゲットの接続パラメーターを指定します。
GPU の選択	`GPU`-	テストを実行する GPU デバイスを選択します。複数のデバイスがある場合、最初のデバイスが既定です。このオプションは、[Select Hardware]オプションが`[Host (for MEX)]`に設定されている場合にのみ表示されます。DRIVE または Jetson ハードウェアでは、[ボードの設定]パネルで選択できる[GPU デバイス ID]オプションを使用して特定の GPU デバイスを選択します。

ボード設定

NVIDIA DRIVE や Jetson などのハードウェアプラットフォームの接続パラメーターを指定します。アプリはGPU Coder Support Package for NVIDIA GPUsの関数jetson(MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms)または関数drive(MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms)を使用して、ライブハードウェア接続オブジェクトを作成します。サポートパッケージソフトウェアは、生成された CUDA コードを DRIVE プラットフォームまたは Jetson プラットフォームでビルドして実行している間、TCP/IP 経由の SSH 接続を使用してコマンドを実行します。ターゲットプラットフォームはホストコンピューターと同じネットワーク上になければなりません。または、イーサネットクロスケーブルを使用してボードを直接ホストコンピューターと接続できます。NVIDIA ボードの要件、設定、構成手順の詳細については、Install and Setup Prerequisites for NVIDIA Boards(MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms)を参照してください。

オプション	説明
Device Address	ハードウェアの IP アドレスまたはホスト名。たとえば、`169.254.0.2`や`gpucoder-tegratx2-1`のようにします。ホスト名を使用する場合、Ethernet ケーブルをボードの Ethernet 端子に接続しなければなりません。次に、Linux コマンドを使用してハードウェア IP アドレスを設定し、ホスト名をその IP アドレスに関連付けます。
Username	ボードのオペレーティングシステムに対して有効な Linux^®ユーザー名。
Password	指定した Linux ユーザー名に対して有効なパスワード。
Execution Timeout	ターゲット上の実行テストを検証するまでアプリが待機する時間を秒単位で指定します。既定値は 10 秒です。
GPU Device ID	NVIDIA Drive プラットフォームなどのマルチ GPU 環境で、ターゲットにする CUDA GPU デバイスを指定します。

ワークフローチェック

アプリを使用して実行できるワークフローチェックには次の 2 種類があります。

開発用コンピューターでの基本的なコード生成と実行テスト。これらのテストでは、MATLAB シミュレーションと結果を比較することでコード実行を検証します。

オプション	説明
Generate Code	基本的なコード生成とビルドをテストします。このテストでは、指定したハードウェアで有効な CUDA コード生成環境が必要です。
Generate Code and Execute	[Specified Hardware]のデバイスで基本的なコード生成、ビルドおよび実行をテストします。このテストでは、指定したハードウェアで有効な CUDA コード生成環境および GPU デバイスが必要です。
SIL Profiling	ホストコンピューターで基本的な SIL プロファイリングテストを実行します。

開発用コンピューターでの深層学習のコード生成と実行テスト。cuDNN または TensorRT ライブラリをターゲットにすることができます。

オプション	説明
Generate Code	深層学習のコード生成とビルドをテストします。このテストでは、指定したハードウェアで有効な CUDA コード生成環境が必要です。
Generate Code and Execute	[Specified Hardware]のデバイスで深層学習のコード生成、ビルドおよび実行をテストします。このテストでは、指定したハードウェアで有効な CUDA コード生成環境および GPU デバイスが必要です。
Target	コードを生成する深層学習ライブラリを指定します。有効なオプションは`[cuDNN]`または`[TensorRT]`です。
Data Type Check	ネットワークへのテンソルデータ型入力の精度または層のテンソル出力の精度を指定します。32 ビット浮動小数点の推論を実行するには、`'FP32'`を使用します。半精度には、`'FP16'`を使用します。8 ビット整数には、`'INT8'`を使用します。既定値は`'FP32'`です。 `INT8`の精度には、Compute Capability 6.1 以上の CUDA GPU が必要です。`FP16`の精度には、Compute Capability 7.0 以上の CUDA GPU が必要です。

環境のチェック

ホストコンピューター上で CUDA 開発環境をチェックするライブラリの場所を指定します。GPU Coder で必要な環境変数を設定する MATLAB スクリプトgpuEnvSettings.mを生成します。詳細は、前提条件となる製品の設定を参照してください。

オプション	説明
CUDA Installation Path	CUDA ツールキットインストールへのパス。次に例を示します。 `/usr/local/cuda-10.1/bin`
cuDNN	cuDNN ライブラリインストールのルートフォルダーへのパス。次に例を示します。 `/usr/local/cuDNN/`
TensorRT	TensorRT™ ライブラリインストールのルートフォルダーへのパス。次に例を示します。 `/usr/local/TensorRT/`
NVTX Library Path	プロファイリングに必要な`nvtx`ライブラリへのパス。この項目を有効にするには、[SIL Profiling]を選択します。 CUDA ツールキットの標準インストールの場合、このパスは通常 CUDA ライブラリフォルダーです。次に例を示します。 `/usr/local/cuda-10.1/lib64`

GPU コード生成環境チェックレポート

[Run Checks]を選択すると、gpucoderSetupアプリにより、環境、コード生成、および選択した設定に基づいたその他のチェックが実行されます。その後、テストがパスしたかどうかを示すgpucoderSetupReportレポートが生成され、失敗したテストの追加情報が提供されます。レポートの HTML バージョンが同じ名前で現在のフォルダーに作成されます。

Sample environment check report

参考