validateGPU

GPU デバイスを検証

R2024b 以降

構文

validateGPU

validateGPU("all")

validateGPU(ind)

説明

validateGPU は、現在選択されている GPU デバイスを検証します。GPU デバイスが選択されていない場合、関数は既定のデバイスを検証します。

validateGPU("all") は、システム内で検出されたすべての GPU デバイスを検証します。

validateGPU(ind) は、インデックス ind で指定された GPU デバイスを検証します。

ヒント

GPU デバイスの検証は必須ではありません。GPU の設定に関する問題を診断するには validateGPU 関数を使用します。

例

GPU デバイスの検証

現在選択されている 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: 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
# 
# Performing device validation for device index 2
#    Device exists ...........................................................PASSED
#        Quadro P620
#    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: 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 2
#    Device exists ...........................................................PASSED
#        Quadro P620
#    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]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

ヒント

• リモート GPU を検証するには、GPU と同じ数のワーカーをもつクラスターを使用して並列プールを起動し、spmd ブロックの中で validateGPU を呼び出します。

  cluster = parcluster("myRemoteGPUCluster"); 
  pool = parpool(cluster,numGPUs);
  
  spmd
    validateGPU
  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

トピック

• GPU デバイスの識別と選択
• GPU 計算の要件