unshiftdata

shiftdata の逆演算

構文

y = unshiftdata(x,perm,nshifts)

説明

y = unshiftdata(x,perm,nshifts) は、関数 shiftdata と順列 perm を使用してシフトされたデータ x の方向を元に戻します。

メモ

関数 unshiftdata は関数 shiftdata とともに使用します。これらの関数は、filter、goertzel、sgolayfilt、sosfilt のように、特定の次元を操作する関数を作成する場合に役立ちます。

例

魔方陣の次元の並べ替え

以下の例では、3 行 3 列の魔方陣 x をシフトして次元 2 を 1 列目に並べ替えます。unshiftdata は x を元の形状に戻します。

3 行 3 列の魔方陣を作成します。

x = magic(3)

x = 3×3

     8     1     6
     3     5     7
     4     9     2

行列 x をシフトし、2 次元方向に操作します。置換ベクトル perm とシフト数 nshifts がシフトされた行列と共に返されます。

[x,perm,nshifts] = shiftdata(x,2)

x = 3×3

     8     3     4
     1     5     9
     6     7     2

perm = 1×2

     2     1

nshifts =

     []

この行列を元の形状に戻します。

y = unshiftdata(x,perm,nshifts)

y = 3×3

     8     1     6
     3     5     7
     4     9     2

大きさが 1 でない最初の次元を操作するための配列の並べ替え

以下の例では、dim を空に定義した場合の shiftdata と unshiftdata の動作を説明します。

x を行ベクトルとして定義します。

x = 1:5

x = 1×5

     1     2     3     4     5

dim を空に定義し、x の大きさが 1 でない最初の次元を 1 列目にシフトします。shiftdata が x を列ベクトルとして返し、置換ベクトル perm とシフト数 nshifts も返します。

[x,perm,nshifts] = shiftdata(x,[])

x = 5×1

     1
     2
     3
     4
     5

perm =

     []

nshifts = 
1

unshiftdata を使用して、x を元の形状に戻します。

y = unshiftdata(x,perm,nshifts)

y = 1×5

     1     2     3     4     5

入力引数

x — データ

ベクトル | 行列

データ。ベクトルまたは行列として指定します。

データ型: single | double

perm — 順列

ベクトル

順列。ベクトルとして指定します。

データ型: single | double

nshifts — シフト数

スカラー

シフト数。スカラーとして指定します。nshift は関数 shiftdata によって返されます。

データ型: single | double

出力引数

y — 復元されたデータ

ベクトル | 行列

復元されたデータ。ベクトルまたは行列として返されます。

拡張機能

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

GPU 配列

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

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

バージョン履歴

R2012b で導入

R2024b: unshiftdata は C/C++ コード生成をサポートする

関数 unshiftdata は C/C++ コード生成をサポートしています。この機能を使用するには、MATLAB^® Coder™ が必要です。

参考

ipermute | shiftdata | shiftdim