isgpuarray

入力が gpuArray であるかどうかの判別

構文

TF = isgpuarray(X)

説明

TF = isgpuarray(X) は、X が gpuArray の場合に logical 1 (true) を返し、それ以外の場合は logical 0 (false) を返します。この関数を if ステートメントと共に使用して、gpuArray 入力を必要とするコードの実行を回避することができます。

例

配列が gpuArray であるかどうかの判別

乱数配列を作成します。

X = rand(3,3);

この配列を GPU にコピーします。

Y = gpuArray(X);

関数 isgpuArray を使用して、Y が gpuArray であることを確認します。

isgpuArray(Y)

ans = 
   1

X が gpuArray でないことを確認します。

isgpuarray(X)

ans = 
   0

入力引数

X — 入力変数

ワークスペース変数

入力変数。ワークスペース変数として指定します。X は、どのデータ型でも構いません。

拡張機能

スレッドベースの環境

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

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

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

isgpuarray 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray として指定します。詳細については、GPU での MATLAB 関数の実行を参照してください。

バージョン履歴

R2020b で導入

参考

gpuArray | gather | existsOnGPU | canUseGPU

トピック

• GPU での配列の確立
• GPU での MATLAB 関数の実行