Exponenta Banner
exponenta event banner

dsp. PeakToRMS

Пик-корень-среднеквадратичное значение вектора

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

Описание

dsp.PeakToRMS Система object™ вычисляет отношение пик-корень-среднеквадратичное отношение вектора.

Для вычисления отношения пика к корню среднеквадратичного значения:

  1. Создать dsp.PeakToRMS и задайте его свойства.

  2. Вызовите объект с аргументами, как если бы это была функция.

Дополнительные сведения о работе системных объектов см. в разделе Что такое системные объекты?.

Создание

Синтаксис

ptr = dsp. PeakToRMS
ptr = dsp. PeakToRMS (имя, значение)

Описание

пример

ptr = dsp.PeakToRMS создает объект System типа peak-to-root-mean-square, ptr, это возвращает отношение максимальной величины (пик) к среднеквадратичной (RMS) стоимости во входе или последовательности исходных данных.

ptr = dsp.PeakToRMS(Name,Value) возвращает объект System типа peak-to-root-mean-square, ptr, каждое указанное свойство имеет заданное значение. Заключите каждое имя свойства в отдельные кавычки. Неопределенные свойства имеют значения по умолчанию.

Свойства

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

Если не указано иное, свойства не настраиваются, что означает невозможность изменения их значений после вызова объекта. Объекты блокируются при их вызове, и release функция разблокирует их.

Если свойство настраивается, его значение можно изменить в любое время.

Дополнительные сведения об изменении значений свойств см. в разделе Проектирование системы в MATLAB с использованием системных объектов.

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

Укажите размер, вдоль которого вычисляется отношение пика к среднеквадратичному значению 'All', 'Row', 'Column', или 'Custom'. Если для этого свойства задано значение 'Custom', укажите размер с помощью CustomDimension собственность.

Зависимости

Это свойство применяется, когда RunningPeakToRMS свойство - false.

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

Зависимости

Это свойство применяется, когда Dimension свойство - 'Custom'.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

Установить для этого свойства значение true для включения сброса. Если свойство имеет значение true, вход сброса должен быть указан в вызове алгоритма объекта, чтобы сбросить текущее отношение пик/среднеквадратичное отношение.

Зависимости

Это свойство применяется, когда RunningPeakToRMS свойство - true.

Укажите событие для сброса текущего пикового значения для RMS как 'Rising edge', 'Falling edge', 'Either edge', или 'Non-zero'.

Зависимости

Это свойство применяется, когда ResetInputPort свойство - true.

Использование

Синтаксис

y = ptr (x)
y = ptr (x, r)

Описание

пример

y = ptr(x) вычисляет отношение пикового значения к среднеквадратичному значению, y, входного вектора с плавающей запятой x.

y = ptr(x,r) вычисляет отношение пикового значения к среднеквадратичному значению входных элементов по последовательным вызовам алгоритма объекта. Объект дополнительно сбрасывает свое состояние на основе входного сигнала сброса, rи значение ResetCondition собственность. Чтобы включить сброс, установите оба параметра RunningPeakToRMS и ResetInputPort свойства для true.

Входные аргументы

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

Ввод данных, заданный как вектор или матрица. Если x является матрицей, каждый столбец обрабатывается как независимый канал. Значение «пик-среднеквадратичное значение» вычисляется по каждому каналу.

Типы данных: single | double

Сигнал сброса, заданный как скалярное значение. Сигнал сброса сбрасывает состояние объекта на основе входного сигнала сброса и значения ResetCondition собственность.

Зависимости

Чтобы включить этот сигнал, установите оба параметра RunningPeakToRMS и ResetInputPort свойства для true.

Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | logical

Выходные аргументы

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

Пиковое среднеквадратичное значение входного сигнала, возвращаемого в виде скаляра, вектора или матрицы. Если RunningPeakToRMS имеет значение:

  • false - Объект вычисляет пиковое значение RMS для каждого входного канала. Если вход является вектором столбца, то выход является скалярным. Если вход является многоканальным сигналом, то выходной сигнал является вектором 1-by-N, где N - количество входных каналов.

  • true - Объект вычисляет текущее значение пикового-среднеквадратичного значения сигнала. Размер выходного сигнала соответствует размеру входного сигнала.

Когда RunningPeakToRMS свойство - true, y соответствует отношению пикового значения к среднеквадратичному значению входных элементов по последовательным вызовам алгоритма объекта.

Типы данных: single | double

Функции объекта

Чтобы использовать функцию объекта, укажите объект System в качестве первого входного аргумента. Например, для освобождения системных ресурсов объекта System с именем obj, используйте следующий синтаксис:

release(obj)

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

stepЗапустить алгоритм объекта System
releaseДеблокирование ресурсов и разрешение изменений значений свойств объекта системы и входных признаков
resetСброс внутренних состояний объекта System

Примеры

свернуть все

Открыть сценарий в реальном времени

Примечание.Этот пример выполняется только в R2016b или более поздних версиях. При использовании более ранней версии замените каждый вызов функции эквивалентным step синтаксис. Например, myObject (x) становится шагом (myObject, x).

Определите отношение пика к среднеквадратичному значению входного вектора.

in = (1:10)';
ptr = dsp.PeakToRMS;
y = ptr(in)
y = 1.6116
Открыть сценарий в реальном времени

Примечание.Этот пример выполняется только в R2016b или более поздних версиях. При использовании более ранней версии замените каждый вызов функции эквивалентным step синтаксис. Например, myObject (x) становится шагом (myObject, x).

Определите отношение пикового значения к среднеквадратичному значению входного сигнала матрицы.

in = magic(4);
ptr = dsp.PeakToRMS;
ptr.Dimension = 'All';
y = ptr(in)
y = 1.6547

Подробнее

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

Ссылки

[1] Стандарт IEEE ® на переходы, импульсы и связанные формы сигналов, стандарт IEEE 181, 2003.

Расширенные возможности

.
Представлен в R2012a

Документация по системной панели инструментов DSP

Поддержка