squeeze

長さ 1 の次元の削除

構文

B = squeeze(A)

説明

B = squeeze(A) は入力配列 A と同じ要素の配列を返しますが、長さ 1 の次元は削除されます。たとえば、A が 3×1×1×2 の配列の場合、squeeze(A) は 3 行 2 列の行列を返します。

A が行ベクトル、列ベクトル、スカラー、または長さ 1 の次元のない配列の場合、squeeze は入力 A を返します。

例

3 次元配列から行列へ

2×1×2 の配列を作成し、長さ 1 の次元を削除します。その結果、2 行 2 列の行列となります。

A = zeros(2,1,2);
A(:,:,1) = [1 2]';
A(:,:,2) = [3 4]'

A = 
A(:,:,1) =

     1
     2


A(:,:,2) =

     3
     4

B = squeeze(A)

B = 2×2

     1     3
     2     4

3 次元配列からベクトルへ

1×1×3 の配列を作成し、長さ 1 の次元を削除します。その結果、3 行 1 列のベクトルとなります。

A = zeros(1,1,3);
A(:,:,1:3) = [1 2 3]

A = 
A(:,:,1) =

     1


A(:,:,2) =

     2


A(:,:,3) =

     3

B = squeeze(A)

B = 3×1

     1
     2
     3

入力引数

A — 入力配列

多次元配列

入力配列。多次元配列として指定します。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

squeeze 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成

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

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

• cell 配列はサポートしません。

GPU コード生成

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

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

• cell 配列はサポートしません。

スレッドベースの環境

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

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

GPU 配列

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

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

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

reshape | shiftdim | permute