dsp. RMS

Среднеквадратичное значение векторных элементов

Описание

Объект dsp.RMS вычисляет среднеквадратичное (RMS) значение.

Примечание

Режим Running в Системе dsp.RMS object™ будет удален в будущем релизе. Чтобы вычислить рабочую RMS в MATLAB®, используйте Системный объект dsp.MovingRMS вместо этого.

Вычислить значение RMS вашего входа:

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

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

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

Создание

Синтаксис

rms = dsp.RMS
rms = dsp.RMS(Name,Value)

Описание

пример

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

пример

rms = dsp.RMS(Name,Value) возвращает Системный объект RMS, rms, с каждым заданным набором свойств к заданному значению.

Свойства

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

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

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

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

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

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

Зависимости

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

Задайте событие, чтобы сбросить рабочую RMS как один из Rising edge, Falling edge, Either edge или Non-zero. Non-zero сбрасывает рабочую RMS каждый раз, когда ненулевая выборка получена. Смотрите Возрастающие и Падающие Ребра для определений повышения и падающие ребра.

Зависимости

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

Задайте размерность, по которой можно вычислить RMS как один из All, Row, Column или Custom. При определении свойства Dimension, когда All вычисляет значение RMS по целому входу.

Зависимости

Это свойство применяется только, когда вы устанавливаете свойство RunningRMS на false.

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

Зависимости

Это свойство применяется, когда вы устанавливаете Свойство измерения на Custom.

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

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

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

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

Синтаксис

y = rms(x)
y = rms(x,r)

Описание

пример

y = rms(x) вычисляет среднеквадратичное значение (RMS) вывод, y, входного вектора x. Когда свойство RunningRMS верно, y соответствует RMS входных элементов по последовательным вызовам объектного алгоритма.

y = rms(x,r) сбрасывает рабочее состояние RMS на основе значения r, сигнала сброса и свойства ResetCondition. Это вычисление возможно, когда вы устанавливаете и RunningRMS и свойства ResetInputPort к true.

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

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

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

Типы данных: single | double
Поддержка комплексного числа: Да

Сбросьте сигнал, используемый, чтобы сбросить рабочую RMS, заданную как скалярное значение. Объект сбрасывает рабочую RMS, если сигнал сброса удовлетворяет ResetCondition.

Зависимости

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

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

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

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

RMS выходной параметр, возвращенный как скаляр, вектор или матрица. Если RunningRMS установлен в:

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

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

Типы данных: single | double
Поддержка комплексного числа: Да

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

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

release(obj)

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

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

Примеры

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

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

Вычислите значение RMS вектора, состоящего из целых чисел 1 - 10.

x = 1:10;
rms = dsp.RMS('Dimension','row');
rmsval = rms(x)
rmsval = 6.2048

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

Вычислите значение RMS матрицы с набором свойств Dimension к 'All'.

in2 = magic(4);
rms2d = dsp.RMS;
rms2d.Dimension = 'All';
y_rms2 = rms2d(in2)
y_rms2 = 9.6695

Вывод эквивалентен изменению форму матрицы 4 на 4 в 16 1 или 1 16 вектор и вычисление значения RMS для вектора.

Больше о

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

Алгоритмы

Этот объект реализует алгоритм, входные параметры и выходные параметры, описанные на странице с описанием блока RMS. Свойства объектов соответствуют параметрам блоков Simulink®, кроме:

  • Параметры блоков Treat sample-based row input as a column не поддержаны объектом dsp.RMS.

  • Параметры блоков Reset Port соответствуют и ResetCondition и свойствам объектов ResetInputPort.

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

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

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