isallpass

フィルターがオールパスであるかを判別

構文

flag = isallpass(b,a)

flag = isallpass(sos)

flag = isallpass(d)

flag = isallpass(___,tol)

説明

flag = isallpass(b,a) は、指定されたフィルターがオールパスの場合、1 に等しい logical 出力を返します。分子係数 b と分母係数 a をもつフィルターを指定します。

flag = isallpass(sos) は、2 次セクション行列 sos で指定されるフィルターがオールパスの場合、1 を返します。

flag = isallpass(d) は、デジタル フィルター d がオールパスの場合、1 を返します。

flag = isallpass(___,tol) は、許容誤差 tol を指定して、2 つの数が等しいと見なせる程度に近づく時点を判別します。

例

オールパス フィルター

オールパス フィルターを作成し、周波数応答がオールパスであることを検証します。

b = [1/3 1/4 1/5 1];
a = fliplr(b); 
flag = isallpass(b,a)

flag = logical
   1

freqz(b,a)

ラティス オールパス フィルターを作成し、フィルターがオールパスであることを検証します。

k = [1/2 1/3 1/4 1/5];
[b,a] = latc2tf(k,"allpass");
flag_isallpass = isallpass(b,a)

flag_isallpass = logical
   1

freqz(b,a)

入力引数

b,a — フィルター係数

ベクトル

フィルター係数。ベクトルとして指定します。b と a の値は、それぞれ分子多項式と分母多項式の係数を表します。

例: [b,a] = cheby2(5,30,0.7) は、係数 b と a をもつ 5 次のデジタル バタワース ローパス フィルターを作成します。このフィルターは、正規化された 3 dB 周波数が 0.7π ラジアン/サンプルで、阻止帯域の減衰量が 30 dB です。

データ型: single | double
複素数のサポート: あり

sos — 2 次セクション表現

L 行 6 列の行列

2 次セクション表現。L 行 6 列の行列として指定します。ここで、L は 2 次セクションの数です。行列

$$\text{sos}=\left[\begin{array}{cccccc}{b}_{01}& b_{11}& b_{21}& 1& a_{11}& a_{21}\\ b_{02}& b_{12}& b_{22}& 1& a_{12}& a_{22}\\ ⋮& ⋮& ⋮& ⋮& ⋮& ⋮\\ b_{0L}& b_{1L}& b_{2L}& 1& a_{1L}& a_{2L}\end{array}\right]$$

は、次に示す H(z) の 2 次セクションを表します。

$$H(z)={\displaystyle \prod _{k=1}^L{H}_k(z)={\displaystyle \prod _{k=1}^L\frac{b_{0k}+b_{1k}{z}^{-1}+b_{2k}{z}^{-2}}{1+a_{1k}{z}^{-1}+a_{2k}{z}^{-2}}.}}$$

例: [z,p,k] = butter(3,1/32); sos = zp2sos(z,p,k) は、正規化された 3 dB の周波数 π/32 ラジアン/サンプルをもつ 3 次のバタワース フィルターを指定します。

データ型: single | double
複素数のサポート: あり

d — デジタル フィルター

digitalFilter オブジェクト

デジタル フィルター。digitalFilter オブジェクトとして指定します。d を周波数応答仕様に基づいて生成するには、関数 designfilt を使用します。

例: designfilt("lowpassfir",FilterOrder=10,CutoffFrequency=0.55) は、正規化された 3 dB 周波数が 0.55π rad/サンプルの 10 次 FIR ローパス フィルターの digitalFilter オブジェクトを生成します。

データ型: digitalFilter

tol — 許容誤差

eps^(2/3) (既定値) | 正のスカラー

近い値を区別するための許容誤差。正のスカラーとして指定します。許容誤差の値は、2 つの数が等しいと見なせる程度に近づく時点を判別します。

データ型: single | double

出力引数

flag — オールパス フィルター フラグ

logical

オールパス フィルター フラグ。logical スカラーとして返されます。この関数は、入力がオールパス フィルターである場合、1 を返します。

バージョン履歴

R2013a で導入

参考

designfilt | digitalFilter | islinphase | ismaxphase | isminphase | isstable