dsp. PeakToRMS

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

Описание

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

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

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

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

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

Создание

Синтаксис

ptr = dsp.PeakToRMS
ptr = dsp.PeakToRMS(Name,Value)

Описание

пример

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

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

Свойства

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

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

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

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в MATLAB Используя Системные объекты (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.

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

Для версий ранее, чем R2016b, используйте функцию step, чтобы запустить алгоритм Системного объекта. Аргументы к step являются объектом, который вы создали, сопровождаемый аргументами, показанными в этом разделе.

Например, y = step(obj,x) и y = obj(x) выполняют эквивалентные операции.

Синтаксис

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

Описание

пример

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 установлен в:

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

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

Когда свойством RunningPeakToRMS является true, y соответствует отношению пика к 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

Для просмотра документации необходимо авторизоваться на сайте