dsp.RMS

(Чтобы быть удаленным) Среднеквадратичное значение векторных элементов

Описание

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

Примечание

dsp.RMS Система object™ будет удалена в будущем релизе. Чтобы вычислить RMS, используйте rms функция. Чтобы вычислить рабочую RMS в MATLAB^®, используйте dsp.MovingRMS объект. Для получения дополнительной информации см. Вопросы совместимости.

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

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

Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты? 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).

`RunningRMS` — Позвольте вычислить RMS в зависимости от времени
`false` (значение по умолчанию) | `true`

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

`ResetInputPort` — Позвольте сбросить в рабочем режиме RMS
`false` (значение по умолчанию) | `true`

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

Зависимости

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

`ResetCondition` — Сбросьте условие для выполнения режима RMS
`Non-zero` (значение по умолчанию) | `Rising edge` | `Falling edge` | `Either edge`

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

Зависимости

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

`Dimension` — Размерность, чтобы вычислить значение RMS вперед
`Column` (значение по умолчанию) | `All` | `Row` | `Custom`

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

Зависимости

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

`CustomDimension` — Числовая размерность, которая задает направление расчета
1 (значение по умолчанию) | положительное целое число

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

Зависимости

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

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

Синтаксис

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` — Ввод данных
вектор | матрица

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

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

`r` — Сбросьте сигнал
скаляр

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

Зависимости

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

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

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

`y` — RMS выход
скаляр | вектор | матрица

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

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

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

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

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

release(obj)

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

Характерный для всех системных объектов

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

Примеры

Значение RMS матричного входа

Примечание: Если вы используете R2016a или более ранний релиз, заменяете каждый вызов объекта с эквивалентным step синтаксис. Например, obj(x) становится step(obj,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 для вектора.

Больше о

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

Среднеквадратичный уровень

Среднеквадратичный уровень вектора, X,

с суммированием, выполняемым в заданном измерении.

Повышение и падение ребер

Возрастающее ребро:

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

Падающее ребро:

Падения от положительного значения до отрицательной величины или нуля.
Падения от нуля до отрицательной величины, где падение не является продолжением падения от положительного значения, чтобы обнулить.

Алгоритмы

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

Параметры блоков Treat sample-based row input as a column не поддержаны dsp.RMS объект.
Параметры блоков Reset Port соответствуют обоим ResetCondition и ResetInputPort свойства объектов.

Вопросы совместимости

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

dsp. Системный объект RMS будет удален

Предупреждает запуск в R2019b

dsp.RMS Системный объект будет удален в будущем релизе. Чтобы вычислить RMS, используйте rms функция. Чтобы вычислить рабочую RMS, используйте dsp.MovingRMS объект.

Обновите код

Эта таблица показывает типичное использование Системного объекта и объясняет, как обновить существующий код, чтобы использовать эквивалентную функцию.

Нежелательное использование (R2016b или позже)	Нежелательное использование (перед R2016b)	Рекомендуемая замена
RMS rm = dsp.RMS; x = randn(100,1); y = rm(x); Рабочая RMS rm = dsp.RMS; rm.RunningRMS = true; x = randn(100,1); y = rm(x); % Running RMS	RMS rm = dsp.RMS; x = randn(100,1); y = step(rm,x); Рабочая RMS rm = dsp.RMS; rm.RunningRMS = true; x = randn(100,1); y = step(rm,x); % Running RMS	RMS x = randn(100,1); y = rms(x); Рабочая RMS mvgRMS = dsp.MovingRMS; mvgRMS.SpecifyWindowLength = false; x = randn(100,1); y = mvgRMS(x);

Нежелательное использование (R2016b или позже)

Нежелательное использование (перед R2016b)

Рекомендуемая замена

RMS

rm = dsp.RMS;
x = randn(100,1);
y = rm(x);

Рабочая RMS

rm = dsp.RMS;
rm.RunningRMS = true;
x = randn(100,1);
y = rm(x); % Running RMS

RMS

rm = dsp.RMS;
x = randn(100,1);
y = step(rm,x);

Рабочая RMS

rm = dsp.RMS;
rm.RunningRMS = true;
x = randn(100,1);
y = step(rm,x); % Running RMS

RMS

x = randn(100,1);
y = rms(x);

Рабочая RMS

mvgRMS = dsp.MovingRMS;
mvgRMS.SpecifyWindowLength = false;
x = randn(100,1);
y = mvgRMS(x);

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

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Указания и ограничения по применению:

Смотрите системные объекты в Генерации кода MATLAB (MATLAB Coder).

Смотрите также

Документация

dsp.RMS

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

RunningRMS — Позвольте вычислить RMS в зависимости от времени false (значение по умолчанию) | true

ResetInputPort — Позвольте сбросить в рабочем режиме RMS false (значение по умолчанию) | true

Зависимости

ResetCondition — Сбросьте условие для выполнения режима RMS Non-zero (значение по умолчанию) | Rising edge | Falling edge | Either edge

Зависимости

Dimension — Размерность, чтобы вычислить значение RMS вперед Column (значение по умолчанию) | All | Row | Custom

Зависимости

CustomDimension — Числовая размерность, которая задает направление расчета1 (значение по умолчанию) | положительное целое число

Зависимости

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

Синтаксис

Описание

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

x — Ввод данных вектор | матрица

r — Сбросьте сигнал скаляр

Зависимости

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

y — RMS выход скаляр | вектор | матрица

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

Характерный для всех системных объектов

Примеры

Значение RMS матричного входа

Больше о

Среднеквадратичный уровень

Повышение и падение ребер

Алгоритмы

Вопросы совместимости

dsp. Системный объект RMS будет удален

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

Генерация кода C/C++ Генерация кода C и C++ с помощью MATLAB® Coder™.

Смотрите также

Функции

Системные объекты

Блоки

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

Документация DSP System Toolbox

Поддержка

`RunningRMS` — Позвольте вычислить RMS в зависимости от времени
`false` (значение по умолчанию) | `true`

`ResetInputPort` — Позвольте сбросить в рабочем режиме RMS
`false` (значение по умолчанию) | `true`

`ResetCondition` — Сбросьте условие для выполнения режима RMS
`Non-zero` (значение по умолчанию) | `Rising edge` | `Falling edge` | `Either edge`

`Dimension` — Размерность, чтобы вычислить значение RMS вперед
`Column` (значение по умолчанию) | `All` | `Row` | `Custom`

`CustomDimension` — Числовая размерность, которая задает направление расчета
1 (значение по умолчанию) | положительное целое число

`x` — Ввод данных
вектор | матрица

`r` — Сбросьте сигнал
скаляр

`y` — RMS выход
скаляр | вектор | матрица

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.