extractdata

dlarray オブジェクトからのデータの抽出

構文

Y = extractdata(X)

説明

extractdata 関数は、dlarray オブジェクトからデータを抽出します。

Y = extractdata(X) は、dlarray オブジェクト X のデータを返します。

extractdata は、数値配列などの他のデータ型に対して呼び出すことができます。X が dlarray オブジェクトではない場合、この関数は無効です。 (R2026a 以降)

例

dlarray からのデータの抽出

データ形式 'SS' で logical dlarray を作成します。

rng default % For reproducibility
dlX = dlarray(rand(4,3) > 0.5,'SS')

dlX = 
  4(S) × 3(S) logical dlarray

   1   1   1
   1   0   1
   0   0   0
   1   1   1

dlX からデータを抽出します。

y = extractdata(dlX)

y = 4×3 logical array

   1   1   1
   1   0   1
   0   0   0
   1   1   1

入力引数

X — 入力データ

dlarray オブジェクト

入力データ。dlarray オブジェクトとして指定します。

出力引数

Y — 抽出されたデータ

single 配列 | double 配列 | logical 配列 | gpuArray

抽出されたデータ。single 配列、double 配列、logical 配列、あるいはこれらのいずれかの配列型の gpuArray として返されます。出力 Y のデータ型は、X における基となるデータ型と同じです。

X が dlarray オブジェクトではない場合、Y は X と同一です。

ヒント

• 形式を整えることによる暗黙的な順列が X に含まれている場合、Y は明示的な順列をもちます。

• 出力 Y に微分の計算に関するトレースは含まれません。微分のトレースを参照してください。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

コード生成では gpuArray データ型がサポートされていません。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

gpuArray に関する推奨事項と制限については、GPU 配列のサポート (GPU Coder)を参照してください。

バージョン履歴

R2019b で導入

R2026a: dlarray 以外のデータ型のサポート

extractdata 関数は、数値配列などの dlarray ではないデータ型に対して呼び出すことができます。X が dlarray オブジェクトではない場合、この関数は無効です。この動作により、dlarray オブジェクトと他のデータ型の両方をサポートするコードを再利用しやすくなります。

参考

dlarray | gather (Parallel Computing Toolbox)