getSpectrumData

スペクトル アナライザーに表示されたスペクトル データの保存

構文

spectrumTable = getSpectrumData(scope)

説明

spectrumTable = getSpectrumData(scope) は、スペクトル アナライザーに表示されるスペクトルとスペクトログラムを、スペクトルに関する追加の統計と共に返します。

例

スペクトル データの保存

スペクトル アナライザー オブジェクトを作成し、データを生成します。

scope = spectrumAnalyzer;
scope(randn(6000,3))

スペクトル アナライザーに表示された最後のスペクトルのデータを table に保存します。

specTable = getSpectrumData(scope)

specTable =

  1×3 table

    SimulationTime       Spectrum        FrequencyVector
    ______________    _______________    _______________

      {[0.5999]}      {1024×3 double}    {1024×1 double}

入力引数

scope — スペクトル アナライザー

オブジェクト名 | ブロック構成

クエリするスペクトル アナライザー。次のいずれかとして指定します。

• spectrumAnalyzer オブジェクト

• Spectrum Analyzer ブロックの SpectrumAnalyzerBlockConfiguration オブジェクト

出力引数

spectrumTable — 現在のスペクトル推定に関するデータ

table

次のフィールドを含むスペクトル テーブルが返されます。

フィールド	説明
SimulationTime	シミュレーション時間
Spectrum	パワー、パワー密度、または RMS のスペクトル データ
Spectrogram	スペクトログラムのデータ
MinHoldTrace	最小ホールド トレースのデータ
MaxHoldTrace	最大ホールド トレースのデータ
FrequencyVector	周波数ベクトル

バージョン履歴

R2017b で導入

R2024a: dsp.SpectrumAnalyzer System object の警告

dsp.SpectrumAnalyzer System object™ は R2024a で警告を出力します。代わりに、spectrumAnalyzer オブジェクトを使用してください。

コードの更新

dsp.SpectrumAnalyzer のインスタンスを spectrumAnalyzer に置き換える以外は、コードを更新する必要はありません。

次の表では、getSpectrumData 関数が dsp.SpectrumAnalyzer System object を使用する代表的な方法を示し、spectrumAnalyzer オブジェクトを使用するように既存のコードを更新する方法について説明します。

非推奨の使用方法	推奨される代替案
scope = dsp.SpectrumAnalyzer; scope(randn(100000,1)) specTable = getSpectrumData(scope)	scope = spectrumAnalyzer; scope(randn(100000,1)) specTable = getSpectrumData(scope)

R2022a: dsp.SpectrumAnalyzer オブジェクトのサポートは削除予定

getSpectrumData 関数による dsp.SpectrumAnalyzer オブジェクトのサポートは将来のリリースで終了する予定です。代わりに spectrumAnalyzer オブジェクトを使用してください。

参考

関数

• isNewDataReady | getSpectralMaskStatus | getMeasurementsData

オブジェクト

• spectrumAnalyzer | SpectrumAnalyzerBlockConfiguration

ブロック

• Spectrum Analyzer