grpdelay

離散時間フィルター System object の群遅延応答

構文

[gd,w] = grpdelay(sysobj)

[gd,w] = grpdelay(sysobj,n)

[gd,w] = grpdelay(sysobj,Arithmetic=arithType)

grpdelay(sysobj)

説明

[gd,w] = grpdelay(sysobj) は、現在のフィルター係数に基づいて、フィルター System object™、すなわち sysobj の群遅延 gd を返します。ベクトル w には、群遅延を評価する周波数 (ラジアン単位) が含まれます。群遅延は、

$$-\frac{d}{dw}(angle(w))$$

のように定義されます。

群遅延は、単位円の上半分の周囲に等間隔に配置された 8,192 個の点で評価されます。

[gd,w] = grpdelay(sysobj,n) は、フィルター System object の群遅延と単位円の上半分の周囲に等間隔に配置された n 個の点の対応する周波数を返します。

[gd,w] = grpdelay(sysobj,Arithmetic=arithType) は、前の構文のいずれかを使用して、arithType で指定された演算に基づいてフィルター System object の群遅延を計算します。

grpdelay(sysobj) は、フィルター System object の群遅延をプロットします。

その他の入力オプションについては、Signal Processing Toolbox™ の grpdelay を参照してください。

例

離散時間マルチレート フィルターの群遅延

CICComp = dsp.CICCompensationDecimator;

grpdelay は、フィルターの群遅延を計算してプロットします。

grpdelay(CICComp);

入力引数

sysobj — 入力フィルター

フィルター System object

入力フィルター。次のいずれかのフィルター System object として指定します。

• dsp.AllpassFilter

• dsp.AllpoleFilter

• dsp.CICCompensationDecimator

• dsp.CICCompensationInterpolator

• dsp.CICDecimator

• dsp.CICInterpolator

• dsp.CoupledAllpassFilter

• dsp.DCBlocker (R2024b 以降)

• dsp.Delay

• dsp.Differentiator

• dsp.FarrowRateConverter

• dsp.FilterCascade

• dsp.FIRDecimator

• dsp.FIRFilter

• dsp.FIRHalfbandDecimator

• dsp.FIRHalfbandInterpolator

• dsp.FIRInterpolator

• dsp.FIRRateConverter

• dsp.FourthOrderSectionFilter

• dsp.HighpassFilter

• dsp.IIRFilter

• dsp.IIRHalfbandDecimator

• dsp.IIRHalfbandInterpolator

• dsp.LowpassFilter

• dsp.NotchPeakFilter

• dsp.ParallelFilter

• dsp.SOSFilter

• dsp.VariableBandwidthFIRFilter

• dsp.VariableBandwidthIIRFilter

• dsp.VariableFIRDecimator

• dsp.VariableFIRInterpolator

n — サンプル数

8192 (既定値) | 正の整数

サンプル数。正の整数で指定します。n が 2 のべき乗の FIR フィルターの場合、FFT を使用すると計算が高速になります。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

arithType — 演算型

'double' (既定値) | 'single' | 'Fixed'

フィルター解析で使用される演算。'double'、'single'、または 'Fixed' として指定します。演算入力が指定されず、フィルター System object がロック解除状態の場合、解析ツールは倍精度フィルターを使用します。演算入力が指定されず、System object がロックされている場合、関数はロックされた入力のデータ型に基づいて解析を実行します。

'Fixed' 値は、固定小数点プロパティのみをもつフィルター System object に適用されます。

'Arithmetic' 入力引数が 'Fixed' として指定され、フィルター オブジェクトの係数のデータ型が 'Same word length as input' に設定されている場合、演算解析は System object がロック解除されているかロックされているかに応じて異なります。

• ロック解除 –– 解析オブジェクト関数は係数のデータ型を判断できません。関数は、係数のデータ型が符号付き、16 ビット語長、自動スケーリングであると仮定します。関数は、この仮定に基づいて固定小数点解析を実行します。

• ロック –– 入力のデータ型が 'double' または 'single' の場合、解析オブジェクト関数は係数のデータ型を判断できません。関数は、係数のデータ型が符号付き、16 ビット語長、自動スケーリングであると仮定します。関数は、この仮定に基づいて固定小数点解析を実行します。

System object がロックされているかロック解除されているかを確認するには、関数 isLocked を使用します。

演算入力が 'Fixed' として指定され、フィルター オブジェクトの係数のデータ型がカスタム数値型に設定されている場合、オブジェクト関数はカスタム数値データ型に基づいて固定小数点解析を実行します。

出力引数

gd — 群遅延

ベクトル

長さ n の群遅延ベクトル。n が指定されていない場合、この関数は既定値の 8192 を使用します。

データ型: double

w — 周波数

ベクトル

長さ n の周波数ベクトル (ラジアン/サンプル単位)。w は単位円の上半分 (0 から π ラジアン/サンプル) の周囲に等間隔に配置された n 個の点で構成されます。n が指定されていない場合、この関数は既定値の 8192 を使用します。

データ型: double

バージョン履歴

R2011a で導入

R2024b: dsp.VariableFIRDecimator オブジェクトおよび dsp.VariableFIRInterpolator オブジェクトのサポート

R2024b 以降、grpdelay 解析関数は dsp.VariableFIRDecimator オブジェクトおよび dsp.VariableFIRInterpolator オブジェクトをサポートします。

R2024b: dsp.BiquadFilter オブジェクトは警告を出力する

dsp.BiquadFilter オブジェクトは警告を発行します。また、将来のリリースでは削除される予定です。代わりに dsp.SOSFilter オブジェクトを使用してください。既存のコードを置換する方法の詳細については、dsp.BiquadFilter のリファレンス ページにある互換性の考慮事項のセクションを参照してください。

R2024b: dsp.DCBlocker オブジェクトのサポート

R2024b 以降、この関数は dsp.DCBlocker オブジェクトをサポートします。

R2024a: 関数 grpdelay はフィルターの可視化ツールを今後使用しない

出力引数なしで関数 grpdelay を呼び出す場合、関数はフィルターの群遅延応答をプロットするためにフィルターの可視化ツールを使用しません。R2024a 以降、関数は代わりに MATLAB^® プロットを使用します。

コードを変更する必要はありません。

R2023b: dsp.ParallelFilter オブジェクトおよび dsp.Delay オブジェクトのサポート

R2023b 以降、解析関数 grpdelay は dsp.ParallelFilter オブジェクトおよび dsp.Delay オブジェクトをサポートします。

R2023b: dsp.BiquadFilter オブジェクトは削除予定

dsp.BiquadFilter オブジェクトは将来のリリースで削除される予定です。代わりに dsp.SOSFilter オブジェクトを使用してください。

参考

関数

• grpdelay

トピック

• Analysis Functions for Filter System Objects