permute

配列の次元の並べ替え

構文

B = permute(A,dimorder)

説明

B = permute(A,dimorder) は配列の次元をベクトル dimorder によって指定された順序で並べ替えます。たとえば、permute(A,[2 1]) は行列 A の行と列の次元を切り替えます。一般に、出力配列の i 番目の次元は入力配列の次元 dimorder(i) になります。

例

3 次元配列

3×4×2 の配列を作成して並べ替え、最初の次元と 3 番目の次元を入れ替えることで、2×4×3 の配列になります。

rng default
A = rand(3,4,2)

A = 
A(:,:,1) =

    0.8147    0.9134    0.2785    0.9649
    0.9058    0.6324    0.5469    0.1576
    0.1270    0.0975    0.9575    0.9706


A(:,:,2) =

    0.9572    0.1419    0.7922    0.0357
    0.4854    0.4218    0.9595    0.8491
    0.8003    0.9157    0.6557    0.9340

B = permute(A,[3 2 1])

B = 
B(:,:,1) =

    0.8147    0.9134    0.2785    0.9649
    0.9572    0.1419    0.7922    0.0357


B(:,:,2) =

    0.9058    0.6324    0.5469    0.1576
    0.4854    0.4218    0.9595    0.8491


B(:,:,3) =

    0.1270    0.0975    0.9575    0.9706
    0.8003    0.9157    0.6557    0.9340

szB = size(B)

szB = 1×3

     2     4     3

入力引数

A — 入力配列

ベクトル | 行列 | 多次元配列

入力配列。ベクトル、行列または多次元配列として指定します。

dimorder — 次元の順序

行ベクトル

次元の順序。入力配列の次元を表す一意の正の整数要素をもつ行ベクトルとして指定します。

拡張機能

tall 配列

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

この関数は tall 配列を制限付きでサポートしています。

tall 次元 (次元 1) の並べ替えはサポートされていません。

詳細については、メモリに収まらないデータの tall 配列を参照してください。

C/C++ コード生成

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

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

• dimorder は固定サイズの行ベクトルでなければなりません。

• B が異種混合 cell 配列の場合、dimorder は定数でなければなりません。異種混合 cell 配列の詳細については、cell 配列のコード生成 (MATLAB Coder)を参照してください。

スレッドベースの環境

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

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

GPU 配列

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

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

分散配列

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

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

バージョン履歴

R2006a より前に導入

R2025a: コード生成のサポート

この関数の C/C++ コードを生成できます。

R2019b: 次元の順序の引数が非整数または複素数の場合におけるエラーの発生

R2019b 以降、構文 permute(A,dimorder) で、dimorder が非整数値または複素数値である場合、エラーが発生します。代わりに、dimorder には実数で正の整数値を指定してください。

参考

ipermute | reshape | shiftdim | transpose