appcoef2

2 次元 Approximation 係数

構文

A = appcoef2(C,S,wname)

A = appcoef2(C,S,LoR,HiR)

A = appcoef2(___,N)

説明

A = appcoef2(C,S,wname) は、2 次元信号のウェーブレット分解構造 [C,S] と wname で指定されたウェーブレットを使用して、最も粗いスケールで Approximation 係数を返します。(詳細については、wavedec2 を参照してください。)

A = appcoef2(C,S,LoR,HiR) は、ローパス再構成フィルター LoR とハイパス再構成フィルター HiR を使用します。(詳細については、wfilters を参照してください。)

A = appcoef2(___,N) は、レベル N の Approximation 係数を返します。[C,S] が 2 次元信号の M レベルのウェーブレット分解構造である場合、0 ≤ N ≤ M となります。

例

イメージの Approximation 係数の再構成

この例では、イメージの多重レベル ウェーブレット分解から Approximation 係数を再構成する方法を示します。

DWT 拡張モードをゼロパディングに設定します。イメージを読み込んで表示します。

origmode = dwtmode('status','nodisplay');
dwtmode('zpd','nodisp')
load woman
image(X)
colormap(map)
title('Original')

size(X)

ans = 1×2

   256   256

db1 ウェーブレットを使用して、イメージの 3 レベルのウェーブレット分解を実行します。係数配列 cfs の要素数とブックキーピング行列 inds の内容を表示します。cfs には X と同じ数の要素があることに注意してください。

wv = 'db1';
[cfs,inds] = wavedec2(X,3,wv);
numel(X)

ans = 
65536

numel(cfs)

ans = 
65536

inds

inds = 5×2

    32    32
    32    32
    64    64
   128   128
   256   256

レベル 2 の Approximation 係数を抽出して表示します。

cfs2 = appcoef2(cfs,inds,wv,2);
figure
imagesc(cfs2)
colormap('gray')
title('Level 2 Approximation Coefficients')

size(cfs2)

ans = 1×2

    64    64

レベル 3 の Approximation 係数を抽出して表示します。

cfs3 = appcoef2(cfs,inds,wv,3);
figure
imagesc(cfs3)
colormap('gray')
title('Level 3 Approximation Coefficients')

size(cfs3)

ans = 1×2

    32    32

拡張モードを元に戻します。

dwtmode(origmode,'nodisplay')

入力引数

C — ウェーブレット分解ベクトル

実数値のベクトル

2 次元信号のウェーブレット分解ベクトル。実数値のベクトルとして指定します。C は wavedec2 の出力です。各レベルの係数の次元がブックキーピング行列 S に格納されます。

例: [C,S] = wavedec2(randn(256,256),4,'db4') は、行列の 4 レベルのウェーブレット分解を返します。

データ型: double

S — ブックキーピング行列

正の整数の行列

2 次元信号のウェーブレット分解のブックキーピング行列。正の整数の行列として指定します。ブックキーピング行列は、ウェーブレット分解ベクトル C の係数をレベルごとに解析するのに使用されます。

例: [C,S] = wavedec2(randn(256,256),4,'db4') は、行列の 4 レベルのウェーブレット分解を返します。

データ型: double

wname — ウェーブレット

文字ベクトル | string スカラー

2 次元信号のウェーブレット分解の生成に使用するウェーブレット。文字ベクトルまたは string スカラーとして指定します。ウェーブレットは、次のいずれかのウェーブレット ファミリから指定します。最適局在化 Daubechies、Beylkin、Coiflet、Daubechies、Fejér-Korovkin、Haar、Han 線形位相モーメント、Morris 最小帯域幅、Symlet、Vaidyanathan、Discrete Meyer、双直交、および逆双直交。各ファミリの利用可能なウェーブレットについては、wavemngr を参照してください。

例: 'db4'

LoR — ウェーブレット ローパス再構成フィルター

偶数長の実数値のベクトル

ウェーブレット ローパス再構成フィルター。偶数長の実数値のベクトルとして指定します。LoR は HiR と同じ長さでなければなりません。LoR は、ウェーブレット分解構造 [C,S] の作成に使用されるウェーブレットに関連付けられたローパス再構成フィルターでなければなりません。(詳細については、wfilters を参照してください。)

データ型: double

HiR — ウェーブレット ハイパス再構成フィルター

偶数長の実数値のベクトル

ウェーブレット ハイパス再構成フィルター。偶数長の実数値のベクトルとして指定します。HiR は LoR と同じ長さでなければなりません。HiR は、ウェーブレット分解構造 [C,S] の作成に使用されるウェーブレットに関連付けられたハイパス再構成フィルターでなければなりません。(詳細については、wfilters を参照してください。)

データ型: double

N — Approximation 係数レベル

正の整数

Approximation 係数レベル。正の整数として指定します。[C,S] が 2 次元信号の M レベルのウェーブレット分解構造である場合、0 ≤ N ≤ M となります。

データ型: double

出力引数

A — Approximation 係数

実数値の行列 | 実数値の 3 次元配列

レベル N の Approximation 係数。実数値の行列、または実数値の 3 次元配列として返されます。C と S がインデックス付きイメージの解析またはトゥルーカラー イメージの解析から取得される場合、A はそれぞれ m 行 n 列の行列または m×n×3 の配列です。

イメージ形式の詳細については、image と imfinfo を参照してください。

データ型: double

アルゴリズム

入力ベクトル C とブックキーピング行列 S には、2 次元信号分解に関するすべての情報が含まれます。

NMAX = size(S,1)-2 とすると、C = [A(NMAX) H(NMAX) V(NMAX) D(NMAX) … H(1) V(1) D(1)] となります。ここで、A、H、V、および D はベクトルです。N = NMAX の場合、単純な抽出が行われます。それ以外の場合、appcoef2 は、逆ウェーブレット変換を使用して Approximation 係数を反復的に計算します。

拡張機能

C/C++ コード生成

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

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

• 可変サイズのデータのサポートが有効になっていなければなりません。

• 入力 wname は定数でなければなりません。

GPU 配列

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

appcoef2 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• appcoef2 は、'sym' および 'per' 拡張モードのみをサポートします。dwtmode を参照してください。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

detcoef2 | wavedec2