gpuDeviceTable

GPU デバイスのプロパティの table

構文

tbl = gpuDeviceTable

tbl = gpuDeviceTable(props)

説明

tbl = gpuDeviceTable は、ローカル マシン内で検出されたすべての GPU デバイスのプロパティの table を返します。この table では、システム内で検出された各 GPU デバイスのプロパティ Index、Name、ComputeCapability、DeviceAvailable および DeviceSelected の値が表示されます。table の各行には、単一の GPU デバイスのプロパティが含まれます。

tbl = gpuDeviceTable(props) は、カスタマイズされたプロパティの table を返します。props の各要素は、gpuDevice によって返されるプロパティのいずれかでなければなりません。システム内の GPU デバイスの特定のプロパティ (AvailableMemory など) をクエリして比較する場合は、この構文を使用します。

例

GPU デバイスのプロパティの比較

gpuDeviceTable を使用して、システム内のすべての GPU のプロパティをクエリし、簡単に比較できます。

tbl = gpuDeviceTable

tbl =

  2×5 table

    Index           Name           ComputeCapability    DeviceAvailable    DeviceSelected
    _____    __________________    _________________    _______________    ______________

      1      "NVIDIA RTX A5000"          "8.6"               true              true      
      2      "NVIDIA RTX A5000"          "8.6"               true              false       

この MATLAB^® セッションでは、両方のデバイスが使用可能です。選択されている GPU デバイス (インデックス 1) は、インデックスが 2 のデバイスより高い Compute Capability をもっています。

あるいは、利用できる GPU デバイスの数を判別し、デバイスのプロパティのいくつかを検査して、MATLAB® デスクトップから使用するデバイスを選択することもできます。[ホーム] タブの [環境] 領域で、[並列] 、 [GPU 環境の選択] を選択します。

GPU デバイスの特定のプロパティの比較

gpuDeviceTable を使用して、システム内のすべての GPU に関して特定のプロパティをクエリして比較します。

システム内の GPU デバイスの Compute Capability、合計メモリ、マルチプロセッサ数、可用性を比較します。

tbl = gpuDeviceTable(["Index","ComputeCapability",...
   "TotalMemory","MultiprocessorCount","DeviceAvailable"])

tbl =

  2×5 table

    Index    ComputeCapability    TotalMemory    MultiprocessorCount    DeviceAvailable
    _____    _________________    ___________    ___________________    _______________

      1            "8.6"          2.5295e+10             64                  true      
      2            "8.6"          2.5295e+10             64                  true      

入力引数

props — GPU デバイスのプロパティ

string 配列 | cell 配列

GPU デバイスのプロパティ。string 配列または文字ベクトルの cell 配列として指定します。props の各要素は、gpuDevice によって返されるプロパティのいずれかでなければなりません。

出力 table の変数は、props で指定された順序の props で指定されたプロパティとなります。

例: ["Name","ComputeCapability","AvailableMemory"]

データ型: char | string | cell

出力引数

tbl — GPU デバイスのプロパティの table

table

GPU デバイスのプロパティの table。table として返されます。

tbl の既定の変数は、Index、Name、ComputeCapability、DeviceAvailable および DeviceSelected です。引数 props を指定すると、出力 table には指定したプロパティのみが含まれます。

ヒント

• リモート GPU のプロパティをクエリするには、クラスターを使用して並列プールを起動し、spmd ブロックの中で gpuDeviceTable を呼び出します。

  cluster = parcluster("myRemoteGPUCluster");
  pool = parpool(cluster);
  
  spmd
    tbl = gpuDeviceTable
  end

  リモート GPU の使用の詳細については、Work with Remote GPUsを参照してください。

拡張機能

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

gpuDeviceTable 関数はスレッドベースの環境を完全にサポートします。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

バージョン履歴

R2021a で導入

参考

gpuDevice | gpuDeviceCount | gpuArray

トピック

• GPU 計算の要件