現在選択されている GPU デバイスを検証します。GPU デバイスが選択されていない場合、関数は既定のデバイスを検証します。validateGPU 関数は、実行した検証ステップを出力し、各ステップがパスしたか、失敗したか、スキップされたかを示します。検証ステップが失敗した場合、関数は診断メッセージを出力します。

validateGPU

# Beginning GPU validation
# Performing system validation
#    CUDA-supported platform .................................................PASSED
#    CUDA-enabled graphics driver exists .....................................PASSED
#        Version: 537.70
#    CUDA-enabled graphics driver load .......................................PASSED
#    CUDA environment variables ..............................................PASSED
#    CUDA device count .......................................................PASSED
#        Found 2 devices.
#    GPU libraries load ......................................................PASSED
# 
# Performing device validation for device index 1
#    Device exists ...........................................................PASSED
#        NVIDIA RTX A5000
#    Device supported ........................................................PASSED
#    Device available ........................................................PASSED
#        Device is in 'Default' compute mode.
#    Device selectable .......................................................PASSED
#    Device memory allocation ................................................PASSED
#    Device kernel launch ....................................................PASSED
# 
# Finished GPU validation with no failures.

すべてのローカル GPU デバイスの検証

ライブスクリプトを開く

システムにあるすべての GPU デバイスを検証します。validateGPU 関数は、一連のシステム検証チェックを 1 回実行してから、検出されたデバイスごとに一連のデバイス検証ステップを 1 回ずつ実行します。

validateGPU("all")

# Beginning GPU validation
# Performing system validation
#    CUDA-supported platform .................................................PASSED
#    CUDA-enabled graphics driver exists .....................................PASSED
#        Version: 570.133.07
#    CUDA-enabled graphics driver load .......................................PASSED
#    CUDA environment variables ..............................................PASSED
#        CUDA_VISIBLE_DEVICES: "0,1"
#    CUDA device count .......................................................PASSED
#        Found 2 devices.
#    GPU libraries load ......................................................PASSED
# 
# Performing device validation for device index 1
#    Device exists ...........................................................PASSED
#        NVIDIA RTX A5000
#    Device supported ........................................................PASSED
#    Device available ........................................................PASSED
#        Device is in 'Default' compute mode.
#    Device selectable .......................................................PASSED
#    Device memory allocation ................................................PASSED
#    Device kernel launch ....................................................PASSED
# 
# Performing device validation for device index 2
#    Device exists ...........................................................PASSED
#        NVIDIA RTX A5000
#    Device supported ........................................................PASSED
#    Device available ........................................................PASSED
#        Device is in 'Default' compute mode.
#    Device selectable .......................................................PASSED
#    Device memory allocation ................................................PASSED
#    Device kernel launch ....................................................PASSED
# 
# Finished GPU validation with no failures.

検証する GPU デバイスの選択

ライブスクリプトを開く

インデックスが 2 の GPU デバイスを検証します。

validateGPU(2)

# Beginning GPU validation
# Performing system validation
#    CUDA-supported platform .................................................PASSED
#    CUDA-enabled graphics driver exists .....................................PASSED
#        Version: 570.133.07
#    CUDA-enabled graphics driver load .......................................PASSED
#    CUDA environment variables ..............................................PASSED
#        CUDA_VISIBLE_DEVICES: "0,1"
#    CUDA device count .......................................................PASSED
#        Found 2 devices.
#    GPU libraries load ......................................................PASSED
# 
# Performing device validation for device index 2
#    Device exists ...........................................................PASSED
#        NVIDIA RTX A5000
#    Device supported ........................................................PASSED
#    Device available ........................................................PASSED
#        Device is in 'Default' compute mode.
#    Device selectable .......................................................PASSED
#    Device memory allocation ................................................PASSED
#    Device kernel launch ....................................................PASSED
# 
# Finished GPU validation with no failures.

GPU デバイスが複数ある場合、validateGPU にデバイスのインデックスのベクトルを入力として渡すことで、1 回の呼び出しで複数のデバイスを検証できます。たとえば、GPU デバイス 1 と 2 を検証するには、validateGPU([1 2]) を呼び出します。

入力引数

すべて折りたたむ

`ind` — GPU デバイスのインデックス
整数 | 整数のベクトル

検証する GPU デバイスのインデックス。1 から gpuDeviceCount までの範囲の整数または整数のベクトルとして指定します。

例: 2

例: [1 3]

ヒント

リモート GPU を検証するには、クラスターを使用して並列プールを起動し、spmd ブロックの中で validateGPU を呼び出します。ワーカーに GPU が複数ある場合は "all" オプションを使用します。
```
cluster = parcluster("myRemoteGPUCluster");
pool = parpool(cluster);

spmd
  validateGPU("all")
end
```
リモート GPU の使用の詳細については、Work with Remote GPUsを参照してください。

アルゴリズム

すべて折りたたむ

検証ステップのリスト

validateGPU で実行されるシステムレベルの検証ステップは次のとおりです。

検証ステップ	説明
`CUDA-supported platform`	CUDA^® がオペレーティングシステムでサポートされている。
`CUDA-enabled graphics driver exists`	サポートされている CUDA ドライバーが見つかる。
`CUDA-enabled graphics driver load`	MATLAB^® で CUDA ドライバーを読み込むことができる。
`CUDA environment variables`	`CUDA_VISIBLE_DEVICES` などの環境変数で隠されたデバイスがない。
`CUDA device count`	デバイスが少なくとも 1 つある。
`GPU libraries load`	MATLAB で Parallel Computing Toolbox™ GPU ライブラリを読み込むことができる。

validateGPU で実行されるデバイスレベルの検証ステップは次のとおりです。複数のデバイスを検証する場合、これらのステップが各デバイスについて繰り返されます。

検証ステップ	説明
`Device exists`	MATLAB でデバイスを検出できる。
`Device supported`	デバイスの Compute Capability が MATLAB でサポートされている。
`Device available`	デバイスが使用可能な状態である。
`Device selectable`	MATLAB でデバイスを選択できる。
`Device memory allocation`	MATLAB で `gpuArray` を作成できる。
`Device kernel launch`	MATLAB で GPU カーネルを起動できる。

バージョン履歴

R2024b で導入

参考

gpuDeviceTable | gpuDevice | gpuDeviceCount | canUseGPU

validateGPU

構文

説明

例

GPU デバイスの検証