pagetranspose

ページ単位の転置

構文

Y = pagetranspose(X)

説明

Y = pagetranspose(X) は N 次元配列 X の各ページに対して非共役転置を適用します。出力 Y(:,:,i) の各ページは、X(:,:,i).' のように、X 内の対応するページを転置することで検出されます。

例

N 次元配列のページの転置

3 次元配列 A を作成し、pagetranspose を使用して配列の各ページを転置します。

r = repelem(1:3,3,1);
A = cat(3,r,2*r,3*r)

A = 
A(:,:,1) =

     1     2     3
     1     2     3
     1     2     3


A(:,:,2) =

     2     4     6
     2     4     6
     2     4     6


A(:,:,3) =

     3     6     9
     3     6     9
     3     6     9

B = pagetranspose(A)

B = 
B(:,:,1) =

     1     1     1
     2     2     2
     3     3     3


B(:,:,2) =

     2     2     2
     4     4     4
     6     6     6


B(:,:,3) =

     3     3     3
     6     6     6
     9     9     9

入力引数

X — 入力配列

多次元配列

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

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | cell | categorical | datetime | duration | calendarDuration
複素数のサポート: あり

詳細

配列ページ

pagetranspose のようなページ単位関数は、多次元配列に配置された 2 次元行列を処理します。たとえば、3 次元配列の 3 番目の次元にある要素は、本のページのように互いの上に積み重なるため、一般に "ページ" と呼ばれています。各ページは関数が演算を行う行列です。

2 次元行列の集合から、4 次元配列または 5 次元配列のような、より高い次元の配列も作成できます。この場合でも、pagetranspose は配列の基本単位を X(:,:,i,j,k,l) のような関数が演算を行う 2 次元行列として扱います。

関数 cat は、行列の集合から多次元配列を作成するのに便利です。関数 zeros は、多次元配列を事前に割り当てるのに便利です。

ヒント

• ページ単位の転置は、配列の最初の 2 次元を permute(X,[2 1 3:ndims(X)]) を使用して並べ替えるのと同じです。

拡張機能

C/C++ コード生成

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

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

• コード生成は、この関数での cell 配列をサポートしていません。

スレッドベースの環境

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

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

GPU 配列

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

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

分散配列

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

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

バージョン履歴

R2020b で導入

参考

transpose | permute | pagectranspose

トピック

• 多次元配列