dsp.PeakToRMS

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

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

Описание

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

Чтобы вычислить отношение пик-корень-средний-квадрат:

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

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

Создание

Синтаксис

ptr = dsp.PeakToRMS

ptr = dsp.PeakToRMS(Name,Value)

Описание

пример

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

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

Свойства

расширить все

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

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

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

`RunningPeakToRMS` - Вычисление после последовательных вызовов алгоритма объекта
`false` (по умолчанию) | `true`

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

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

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

Зависимости

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

`CustomDimension` - Численная размерность для работы
`1` (по умолчанию) | положительное целое число

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

Зависимости

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

`DecibelScaledOutput` - Вывод отчета в децибелах (дБ)
`true` (по умолчанию) | `false`

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

`ResetInputPort` - Включает сброс в режиме peak-to-RMS
`false` (по умолчанию) | `true`

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

Зависимости

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

`ResetCondition` - Условие сброса для выполнения режима peak-to-RMS
`'Non-zero'` (по умолчанию) | `'Rising edge'` | `'Falling edge'` | `'Either edge'`

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

Зависимости

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

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

Синтаксис

y = ptr(x)

y = ptr(x,r)

Описание

пример

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

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

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

расширить все

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

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

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

`r` - Сигнал сброса
скаляр

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

Зависимости

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

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

расширить все

`y` - Значение Peak-to-RMS
скаляр | вектор | матрица

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

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

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

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

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

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

release(obj)

расширить все

Общий для всех системных объектов

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

Примеры

свернуть все

Отношение пика к RMS Вектора входа

Открыть Live Script

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

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

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

y = 1.6116

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

Открыть Live Script

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

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

y = 1.6547

Подробнее о

расширить все

Пиковая величина - к уровню RMS

Пиковая величина -в-RMS уровень

$\frac{| | X | |_{\infty}}{\sqrt{\frac{1}{N} \sum_{n = 1}^{N} | X_{n} |^{2}}},$

где l-infinity norm и значения RMS вычисляются по заданному измерению.

Ссылки

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

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

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

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

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

Введенный в R2012a

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

dsp.PeakToRMS

Описание

Создание

Синтаксис

Описание

Свойства

`RunningPeakToRMS` - Вычисление после последовательных вызовов алгоритма объекта
`false` (по умолчанию) | `true`

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

Зависимости

`CustomDimension` - Численная размерность для работы
`1` (по умолчанию) | положительное целое число

Зависимости

`DecibelScaledOutput` - Вывод отчета в децибелах (дБ)
`true` (по умолчанию) | `false`

`ResetInputPort` - Включает сброс в режиме peak-to-RMS
`false` (по умолчанию) | `true`

Зависимости

`ResetCondition` - Условие сброса для выполнения режима peak-to-RMS
`'Non-zero'` (по умолчанию) | `'Rising edge'` | `'Falling edge'` | `'Either edge'`

Зависимости

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

Синтаксис

Описание

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

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

`r` - Сигнал сброса
скаляр

Зависимости

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

`y` - Значение Peak-to-RMS
скаляр | вектор | матрица

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

Общий для всех системных объектов

Примеры

Отношение пика к RMS Вектора входа

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

Подробнее о

Пиковая величина - к уровню RMS

Ссылки

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

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

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

Поддержка

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

dsp.PeakToRMS

Описание

Создание

Синтаксис

Описание

Свойства

RunningPeakToRMS - Вычисление после последовательных вызовов алгоритма объекта false (по умолчанию) | true

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

Зависимости

CustomDimension - Численная размерность для работы 1 (по умолчанию) | положительное целое число

Зависимости

DecibelScaledOutput - Вывод отчета в децибелах (дБ) true (по умолчанию) | false

ResetInputPort - Включает сброс в режиме peak-to-RMS false (по умолчанию) | true

Зависимости

ResetCondition - Условие сброса для выполнения режима peak-to-RMS 'Non-zero' (по умолчанию) | 'Rising edge' | 'Falling edge' | 'Either edge'

Зависимости

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

Синтаксис

Описание

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

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

r - Сигнал сброса скаляр

Зависимости

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

y - Значение Peak-to-RMS скаляр | вектор | матрица

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

Общий для всех системных объектов

Примеры

Отношение пика к RMS Вектора входа

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

Подробнее о

Пиковая величина - к уровню RMS

Ссылки

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

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

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

Поддержка

`RunningPeakToRMS` - Вычисление после последовательных вызовов алгоритма объекта
`false` (по умолчанию) | `true`

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

`CustomDimension` - Численная размерность для работы
`1` (по умолчанию) | положительное целое число

`DecibelScaledOutput` - Вывод отчета в децибелах (дБ)
`true` (по умолчанию) | `false`

`ResetInputPort` - Включает сброс в режиме peak-to-RMS
`false` (по умолчанию) | `true`

`ResetCondition` - Условие сброса для выполнения режима peak-to-RMS
`'Non-zero'` (по умолчанию) | `'Rising edge'` | `'Falling edge'` | `'Either edge'`

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

`r` - Сигнал сброса
скаляр

`y` - Значение Peak-to-RMS
скаляр | вектор | матрица

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