dsp.PeakToRMS

Пик к среднеквадратичному значению вектора

Описание

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

Вычислить пик к среднеквадратичному отношению:

  1. Создайте dsp.PeakToRMS объект и набор его свойства.

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

Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты?

Создание

Описание

пример

ptr = dsp.PeakToRMS создает пик к среднеквадратичному Системному объекту, ptr, это возвращает отношение максимальной величины (пик) к среднеквадратичному (RMS) значению во входе или последовательности входных параметров.

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

Свойства

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

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

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

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в MATLAB Используя Системные объекты.

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

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

Зависимости

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

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

Зависимости

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

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

Установите это свойство на true включить выход в дБ. Установите это свойство на false сообщить о выходе как об отношении.

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

Зависимости

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

Задайте событие, чтобы сбросить рабочий пик к RMS как 'Rising edge', 'Falling edge', 'Either edge', или 'Non-zero'.

Зависимости

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

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

Синтаксис

Описание

пример

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

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

Входные параметры

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

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

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

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

Зависимости

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

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

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

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

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

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

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

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

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

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

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

release(obj)

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

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

Примеры

свернуть все

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

Определите отношение пика к RMS векторного входа.

in = (1:10)';
ptr = dsp.PeakToRMS;
y = ptr(in)
y = 1.6116

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

Определите отношение пика к RMS матричного входа.

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

Больше о

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

Ссылки

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

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

Представленный в R2012a