exponenta event banner

SpectrumAnalyzerConfiguration

Настройка Spectrum Analyzer для программного доступа

Описание

spbscopes.SpectrumAnalyzerConfiguration содержит информацию о конфигурации области для блока Spectrum Analyzer.

Создание

MyScopeConfiguration = get_param(gcbh,'ScopeConfiguration') создает новый объект конфигурации Spectrum Analyzer. Сначала необходимо выбрать блок в модели или задать полный путь к блоку.

Свойства

развернуть все

Часто используется

Число входных портов в блоке области, определяемое вектором символов или скаляром строки. Максимальное количество входных портов - 96.

Использование пользовательского интерфейса

Выберите «Файл» > «Количество входных портов».

Типы данных: char | string

Укажите тип отображаемого спектра.

"Power" - Спектр мощности

"Power density" - Спектральная плотность мощности. Спектральная плотность мощности представляет собой величину в квадрате спектра, нормализованного до ширины полосы 1 герц.

"RMS" - Среднее значение корня квадрат. Среднеквадратичный показывает квадратный корень среднего квадрата. Эта опция полезна при просмотре частоты сигналов напряжения или тока.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе «Основные параметры» задайте Тип.

Типы данных: char | string

Укажите источник входной частоты дискретизации как:

  • "Inherited" - Spectrum Analyzer наследует входную частоту выборки из модели.

  • "Property" - Укажите частоту выборки, введенную непосредственно с помощью SampleRate собственность.

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе «Основные параметры» в поле со списком Частота дискретизации (Гц) введите пользовательскую частоту дискретизации или выберите Inherited.

Типы данных: char | string

Укажите частоту дискретизации входных сигналов в герцах в виде символьного вектора или строкового скаляра.

Зависимость

Чтобы включить это свойство, установите SampleRateSource кому "Property".

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе «Основные параметры» введите частоту дискретизации (Гц) в поле со списком.

Типы данных: char | string

  • true - Вычислить и построить график двухсторонних спектральных оценок. Если входной сигнал имеет комплексное значение, необходимо установить для этого свойства значение true.

  • false - Вычислить и построить односторонние спектральные оценки. Если для этого свойства задано значение false, тогда входной сигнал должен быть вещественным.

    Когда это свойство false, Spectrum Analyzer использует силовое сворачивание. Значения по оси Y вдвое больше амплитуды, которой они были бы, если бы для этого свойства было установлено значение true, за исключением 0 и частота Найквиста. Односторонняя спектральная плотность мощности (PSD) содержит полную мощность сигнала в интервале частот от постоянного тока до половины скорости Найквиста. Дополнительные сведения см. в разделе pwelch(Панель инструментов обработки сигналов).

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Опции трассировки выберите Двусторонний спектр.

Типы данных: logical

  • "Log" - отображает частоты по оси X в логарифмическом масштабе. Для использования "Log" , необходимо также установить PlotAsTwoSidedSpectrum свойство для false.

  • "Linear" - отображает частоты по оси X в линейном масштабе. Для использования "Linear" , необходимо также установить PlotAsTwoSidedSpectrum свойство для true.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Опции трассировки (Trace options) задайте Масштаб (Scale).

Типы данных: char | string

Расширенный

Укажите источник полосы пропускания разрешения (RBW) как "Auto", "Property", или "InputPort".

  • "Auto" - Анализатор спектра корректирует разрешение спектральной оценки, чтобы гарантировать наличие 1024 интервалов RBW на определенном частотном диапазоне.

  • "Property" - Укажите полосу пропускания разрешения непосредственно с помощью свойства RBW.

  • "InputPort" - Входной порт добавляется в блок анализатора спектра для считывания RBW. Эта опция применима только к частотному входу.

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Параметры частотного ввода установите значение RBW (Гц).

Типы данных: char | string

RBW управляет спектральным разрешением анализатора спектра. Укажите пропускную способность разрешения в герцах как вектор символа или скаляр строки. Необходимо указать значение, чтобы обеспечить наличие по крайней мере двух интервалов RBW на указанном частотном диапазоне. Таким образом, отношение общего диапазона к RBW должно быть больше двух:

span RBW > 2

Зависимость

Чтобы включить, установите:

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе «Основные параметры» установите значение RBW (Гц).

Типы данных: char | string

Процентное перекрытие между предыдущим и текущим буферизованными сегментами данных, задаваемое как вектор символов или строковый скаляр вещественного скаляра. Перекрытие создает сегмент окна, который используется для вычисления спектральной оценки. Значение должно быть больше или равно нулю и меньше 100.

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Параметры окна задайте Перекрытие (%).

Типы данных: char | string

Укажите оконную функцию для спектральной оценки. В следующей таблице показаны предустановленные окна. Для получения дополнительной информации перейдите по ссылке на соответствующую ссылку на функцию в документации по Toolbox™ обработки сигналов.

Опция окнаСоответствующая функция панели инструментов обработки сигналов
"Rectangular"rectwin(Панель инструментов обработки сигналов)
"Hann"hann(Панель инструментов обработки сигналов)

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе «Параметры окна» задайте «Окно».

Типы данных: char | string

Это свойство доступно только для чтения.

Укажите единицы измерения, в которых анализатор спектра отображает значения мощности. Для изменения единиц спектра необходимо иметь системный Toolbox™ DSP.

Укажите метод сглаживания как:

  • Running - Среднее значение последних n выборок. Используйте SpectralAverages для указания n.

  • Exponential - средневзвешенное количество проб. Используйте ForgettingFactor для указания взвешенного коэффициента забывания.

Дополнительные сведения о методах усреднения см. в разделе Метод усреднения (панель системных инструментов DSP).

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Параметры трассировки задайте метод усреднения.

Типы данных: char | string

Укажите число спектральных средних в виде вектора символа или скаляра строки. Анализатор спектра вычисляет текущую оценку спектра мощности, вычисляя среднее значение последних N оценок спектра мощности. Это свойство определяет N.

Зависимость

Чтобы включить это свойство, установите AveragingMethod кому "Running".

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Опции трассировки (Trace options) задайте значение Средние значения (Averages).

Типы данных: char | string

Укажите экспоненциальное взвешивание как скалярное значение больше 0 и меньше или равно 1, указанное как строковый скалярный или символьный вектор.

Зависимость

Чтобы включить это свойство, установите AveragingMethod кому "Exponential".

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Опции трассировки (Trace options) задайте Коэффициент забывания (Forgetting factor).

Типы данных: char | string

Нагрузка, используемая областью в качестве ссылки для вычисления уровней мощности.

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Опции трассировки (Trace options) задайте Ссылочную нагрузку (Reference load).

Типы данных: char | string

  • Числовой скаляр (указан как символьный вектор или строковый скаляр) - применяет ко всем каналам одинаковое смещение частоты, указанное в герцах в качестве символьного вектора.

  • Числовой вектор (указывается как символьный вектор или строковый скаляр) - применение определенного частотного смещения для каждого канала, указание вектора частот. Длина вектора должна быть равна количеству входных каналов.

    Значения частотной оси смещаются на значения, указанные в этом свойстве. Общий диапазон должен находиться в пределах частотного интервала Найквиста.

Использование пользовательского интерфейса

Откройте окно Настройки спектра (Spectrum Settings). В разделе Опции трассировки (Trace options) установите значение Смещение (Гц).

Типы данных: char | string

Установить для этого свойства значение true для обработки M-by-1 и неориентированных входных данных на основе выборки в виде вектора столбца или одного канала. Установить для этого свойства значение false для обработки M-by-1 и неориентированных входных данных на основе выборки в качестве вектора строки 1-by-M.

Типы данных: logical

Измерения

Канал, по которому получены измерения, заданный как символьный вектор или строковый скаляр, который вычисляется как положительное целое число, большее 0 и меньшее или равное 100. Максимальное число, которое можно указать, - это количество каналов (столбцов) во входном сигнале.

Настраиваемый: Да

Использование пользовательского интерфейса

Щелкните Инструменты (Tools) > Измерения (Measurements) и откройте настройки выбора трассировки.

Типы данных: char | string

Включите функцию поиска пиков для вычисления и отображения наибольших вычисленных пиковых значений. PeakFinder свойство использует PeakFinderSpecification свойства.

PeakFinderSpecification свойства:

  • MinHeight - Уровень, выше которого обнаруживаются пики, заданный как скалярное значение.

    По умолчанию: -Inf

  • NumPeaks - Максимальное количество отображаемых пиков, указанное в виде положительного целого скаляра меньше 100.

    По умолчанию: 3

  • MinDistance - Минимальное количество выборок между соседними пиками, указанное как положительный действительный скаляр.

    По умолчанию: 1

  • Threshold - Минимальная разность высот между пиком и соседними выборками, заданная как неотрицательный действительный скаляр.

    По умолчанию: 0

  • LabelFormat - Координаты для отображения рядом с вычисленным пиковым значением, указанным как вектор символов или строковый скаляр. Допустимые значения: "X", "Y", или "X + Y".

    По умолчанию: "X + Y"

  • Enable -- Задайте для этого свойства значение true для обеспечения возможности измерения пиковых значений. Допустимые значения: true или false.

    По умолчанию: false

Все PeakFinderSpecification настраиваемые свойства.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте панель Поиск пиков (Peak Finder) () и измените параметры Настройки (Settings).

Включить измерения курсора для отображения курсоров экрана или формы сигнала. CursorMeasurements свойство использует CursorMeasurementsSpecification свойства.

CursorMeasurementsSpecification свойства:

  • Type - Тип отображаемых курсоров, указанный как "Screen cursors" или "Waveform cursors".

    По умолчанию: "Waveform cursors"

  • ShowHorizontal -- Задайте для этого свойства значение true для отображения горизонтальных экранных курсоров. Это свойство применяется при установке Type свойство для "Screen cursors".

    По умолчанию: true

  • ShowVertical -- Задайте для этого свойства значение true для отображения вертикальных курсоров экрана. Это свойство применяется при установке Type свойство для "Screen cursors".

    По умолчанию: true

  • Cursor1TraceSource - Укажите источник курсора формы волны 1 как положительный действительный скаляр. Это свойство применяется при установке Type свойство для "Waveform cursors".

    По умолчанию: 1

  • Cursor2TraceSource - Укажите источник курсора 2 в виде положительного вещественного скаляра. Это свойство применяется при установке Type свойство для "Waveform cursors".

    По умолчанию: 1

  • LockSpacing -- Интервал блокировки между курсорами, заданный как логический скаляр.

    По умолчанию: false

  • SnapToData -- Привязка курсоров к данным, указанным как логический скаляр.

    По умолчанию: true

  • XLocation - x-координаты курсоров, заданные как действительный вектор длины, равный 2.

    По умолчанию: [-2500 2500]

  • YLocation - координаты y курсоров, заданные как действительный вектор длины, равный 2. Это свойство применяется при установке Type свойство для "Screen cursors".

    По умолчанию: [-55 5]

  • Enable -- Задайте для этого свойства значение true для включения измерений курсора. Допустимые значения: true или false.

    По умолчанию: false

Все CursorMeasurementsSpecification настраиваемые свойства.

Использование пользовательского интерфейса

Откройте панель Измерения курсора (Cursor Measurements) () и измените параметры Настройки (Settings).

Разрешить измерения искажений для вычисления и отображения гармонических искажений и интермодуляционных искажений. DistortionMeasurements свойство использует DistortionMeasurementsSpecification свойства.

DistortionMeasurementsSpecification свойства:

  • Algorithm - Тип отображаемых данных измерений, указанный как "Harmonic" или "Intermodulation".

    По умолчанию: "Harmonic"

  • NumHarmonics - Количество измеряемых гармоник, указанных как действительное положительное целое число. Это свойство применяется при установке Algorithm кому "Harmonic".

    По умолчанию: 6

  • Enable -- Задайте для этого свойства значение true обеспечение возможности измерения искажений.

    По умолчанию: false

Все DistortionMeasurementsSpecification настраиваемые свойства.

Использование пользовательского интерфейса

Откройте панель «Измерения искажений» () и измените опции «Искажение» и «Гармоники».

Визуализация

Название окна области.

Настраиваемый: Да

Типы данных: char | string

Положение окна Spectrum Analyzer в пикселях, определяемое размером и расположением окна области как четырехэлементный двойной вектор вида [left bottom width height]. Можно поместить окно области в определенное положение на экране, изменив значения этого свойства.

По умолчанию окно отображается в центре экрана шириной 800 пикселы и высота 450 пикселы. Точные координаты центра зависят от разрешения экрана.

Настраиваемый: Да

Укажите тип графика, который будет использоваться для отображения обычных трасс: "Line" или "Stem". Нормальные трассы - это трассы, отображающие свободно выполняющиеся спектральные оценки.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте свойства «Стиль» и задайте тип печати.

Типы данных: char | string

Скорость моделирования выше, если для этого свойства установлено значение true.

  • true - область регистрирует данные для последующего использования и обновляет отображение через фиксированные интервалы времени. Данные, происходящие между этими фиксированными интервалами, могут не выводиться на график.

  • false - область обновляется при каждом вычислении спектра мощности. Используйте false установка, когда вы не хотите пропускать какие-либо спектральные обновления за счет более низкой скорости моделирования.

Использование пользовательского интерфейса

Выберите меню «Моделирование» > «Уменьшить скорость печати» для повышения производительности.

Типы данных: logical

Укажите заголовок отображения в виде символьного вектора или строки.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте окно «Свойства конфигурации». Задать заголовок.

Типы данных: char | string

Укажите текст области для отображения слева от оси Y.

Независимо от этого свойства Spectrum Analyzer всегда отображает блоки питания как один из SpectrumUnits значения.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте окно «Свойства конфигурации». Задайте Y-метку.

Типы данных: char | string

Чтобы отобразить легенду с входными именами, задайте для этого свойства значение true.

Из легенды можно управлять видимыми сигналами. Этот элемент управления эквивалентен изменению видимости в диалоговом окне «Стиль». В легенде области щелкните имя сигнала, чтобы скрыть сигнал в области. Чтобы отобразить сигнал, щелкните имя сигнала еще раз. Чтобы отобразить только один сигнал, щелкните правой кнопкой мыши имя сигнала. Для отображения всех сигналов нажмите клавишу Esc.

Примечание

Легенда показывает только первые 20 сигналов. Любые дополнительные сигналы нельзя просматривать или контролировать из легенды.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте окно «Свойства конфигурации». На вкладке «Отображение» выберите «Показать легенду».

Типы данных: logical

Укажите имена входных каналов в виде массива ячеек символьных векторов. Имена отображаются в легенде, диалоговом окне «Стиль» и на панелях «Измерения». Если имена не указаны, каналы помечаются как Channel 1, Channel 2и т.д.

Настраиваемый: Да

Зависимость

Для просмотра имен каналов установите ShowLegend кому true.

Использование пользовательского интерфейса

В легенде дважды щелкните имя канала.

Типы данных: char

Установить для этого свойства значение true отображение линий сетки на графике.

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте окно «Свойства конфигурации». На вкладке Отображение (Display) задайте Показать сетку (Show grid).

Типы данных: logical

Задайте пределы оси Y в виде двухэлементного числового вектора. [ymin ymax].

Пример: scope.YLimits = [-10,20]

Настраиваемый: Да

Использование пользовательского интерфейса

Откройте окно «Свойства конфигурации». Установите пределы Y (максимум) и Y (минимум).

Укажите, когда область автоматически масштабирует оси. Допустимые значения:

  • "Auto" - Область действия масштабирует оси по мере необходимости для соответствия данным как во время, так и после моделирования.

  • "Manual" - Область не масштабирует оси автоматически.

  • "OnceAtStop" - Область масштабирования осей при остановке моделирования.

  • "Updates" - Область масштабирует оси один раз после 10 обновлений.

Использование пользовательского интерфейса

Выберите «Сервис» > «Масштабирование осей».

Типы данных: char | string

Установите это свойство для задержки автоматического масштабирования оси Y.

Зависимость

Чтобы включить это свойство, установите AxesScaling кому "Updates".

Использование пользовательского интерфейса

Откройте диалоговое окно Масштабирование осей (Axes Scaling) и задайте Число обновлений (Number of updates).

Типы данных: char | string

Установить для этого свойства значение true для открытия области при запуске моделирования. Установить для этого свойства значение false для предотвращения открытия области в начале моделирования.

Использование пользовательского интерфейса

Выберите «Файл» > «Открыть в начале моделирования».

Типы данных: logical

Установить для этого свойства значение true для отображения окна анализатора спектра или false скрытие окна анализатора спектра.

Типы данных: logical

Примеры

свернуть все

Создайте объект конфигурации для блока Spectrum Analyzer.

Создайте новую модель Simulink ® со случайным именем .

sysname=char(randi(26,1,7)+96);
new_system(sysname);

Добавьте в модель новый блок Spectrum Analyzer.

add_block('built-in/SpectrumAnalyzer',[sysname,'/SpectrumAnalyzer'])

Позвоните в get_param для получения свойств конфигурации блока Spectrum Analyzer по умолчанию.

config = get_param([sysname,'/SpectrumAnalyzer'],'ScopeConfiguration')
config = 

  SpectrumAnalyzerConfiguration with properties:

                   NumInputPorts: '1'
                    SpectrumType: 'Power'
                SampleRateSource: 'Inherited'
          PlotAsTwoSidedSpectrum: 1
                  FrequencyScale: 'Linear'

   Advanced
                       RBWSource: 'Auto'
                  OverlapPercent: '0'
                          Window: 'Hann'
                   SpectrumUnits: 'dBm'
                 AveragingMethod: 'Running'
                SpectralAverages: '1'
                   ReferenceLoad: '1'
                 FrequencyOffset: '0'
    TreatMby1SignalsAsOneChannel: 1

   Measurements
              MeasurementChannel: '1'
                      PeakFinder: [1×1 PeakFinderSpecification]
              CursorMeasurements: [1×1 CursorMeasurementsSpecification]
          DistortionMeasurements: [1×1 DistortionMeasurementsSpecification]

   Visualization
                            Name: 'SpectrumAnalyzer'
                        Position: [560 375 800 450]
                        PlotType: 'Line'
                  ReducePlotRate: 1
                           Title: ''
                          YLabel: ''
                      ShowLegend: 0
                    ChannelNames: {''}
                        ShowGrid: 1
                         YLimits: [-80 20]
                     AxesScaling: 'Auto'
           OpenAtSimulationStart: 1
                         Visible: 0
Представлен в R2016b