dsp. Среднее значение

Найдите среднее значение входа или последовательность входных параметров

Описание

Объект dsp.Mean находит среднее значение входа или последовательность входных параметров.

Примечание

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

Вычислить среднее значение входа или последовательность входных параметров:

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

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

Создание

Синтаксис

mn = dsp.Mean

mn = dsp.Mean(Name,Value)

Описание

пример

mn = dsp.Mean возвращает объект, mn, который вычисляет среднее значение входа или последовательность входных параметров.

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

Свойства

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

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

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

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

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

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

Вход `ResetInputPort` — Additional, чтобы позволить сбросить рабочего среднего значения
`false` (значение по умолчанию) | `true`

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

Зависимости

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

`ResetCondition` — Условие, которое инициировало сброс рабочего среднего значения
`Non-zero` (значение по умолчанию) | `Rising edge` | `Falling edge` | `Either edge`

Задайте событие, которое сбрасывает рабочий максимум.

Зависимости

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

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

Задайте, как среднее вычисление выполняется по данным.

Зависимости

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

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

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

Зависимости

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

Свойства фиксированной точки

`RoundingMethod` — Округление метода для операций фиксированной точки
`Floor` (значение по умолчанию) | `Ceiling` | `Convergent` | `Nearest` | `Round` | `Simplest` | `Zero`

Задайте метод округления.

`OverflowAction` — Действие, чтобы взять, когда целочисленный вход вне области значений
`Wrap` (значение по умолчанию) | `Saturate`

Задайте действие переполнения.

`AccumulatorDataType` — Тип данных аккумулятора
`Same as input` (значение по умолчанию) | `Custom`

Задайте тип данных с фиксированной точкой аккумулятора.

`CustomAccumulatorDataType` — Слово аккумулятора и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

Задайте фиксированную точку аккумулятора как масштабированный объект numerictype с Signedness Auto.

Зависимости

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

`OutputDataType` — Тип данных вывода
`Same as accumulator` (значение по умолчанию) | `Same as input` | `Custom`

Задайте выходной тип данных с фиксированной точкой.

`CustomOutputDataType` — Выведите слово и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

Задайте выходную фиксированную точку как масштабированный объект numerictype с Signedness Auto.

Зависимости

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

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

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

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

Синтаксис

y = mn(x)

y = mn(x,r)

Описание

пример

y = mn(x) вычисляет среднее значение x. Когда вы устанавливаете свойство RunningMean на true, y является средним значением, вычисленным по последовательным вызовам алгоритма.

y = mn(x,r) сбрасывает вычисление рабочего среднего значения на основе значения сигнала сброса, r и свойства ResetCondition. Чтобы включить этот тип обработки, установите свойство RunningMean на true и свойство ResetInputPort к true.

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

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

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

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

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

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

Зависимости

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

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

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

`y` Среднее значение
скаляр | вектор | матрица

Следует иметь в виду вывод входного сигнала, возвращенного как скаляр, вектор или матрица. Если RunningMean установлен в:

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

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

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

release(obj)

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

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

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

Примеры

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

Вычислите среднее значение и рабочее среднее значение сигнала

Скрипт Open Live Script

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

Среднее значение

mean1 = dsp.Mean;
x = randn(100,1);
y = mean1(x);

Выполнение среднего значения

mean2 = dsp.Mean;
mean2.RunningMean = true;
x = randn(100,1);
yrmean = mean2(x);

Алгоритмы

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

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

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

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

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

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

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

dsp.Minimum | dsp.MovingAverage

Блоки

Среднее значение | Скользящее среднее значение

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

dsp. Среднее значение

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

RunningMean — Вычислите по одному входу или нескольким входным параметрам false (значение по умолчанию) | true

Вход ResetInputPort — Additional, чтобы позволить сбросить рабочего среднего значения false (значение по умолчанию) | true

Зависимости

ResetCondition — Условие, которое инициировало сброс рабочего среднего значения Non-zero (значение по умолчанию) | Rising edge | Falling edge | Either edge

Зависимости

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

Зависимости

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

Зависимости

Свойства фиксированной точки

RoundingMethod — Округление метода для операций фиксированной точки Floor (значение по умолчанию) | Ceiling | Convergent | Nearest | Round | Simplest | Zero

OverflowAction — Действие, чтобы взять, когда целочисленный вход вне области значений Wrap (значение по умолчанию) | Saturate

AccumulatorDataType — Тип данных аккумулятора Same as input (значение по умолчанию) | Custom

CustomAccumulatorDataType — Слово аккумулятора и дробные длины numerictype([],32,30) (значение по умолчанию) | numerictype

Зависимости

OutputDataType — Тип данных вывода Same as accumulator (значение по умолчанию) | Same as input | Custom

CustomOutputDataType — Выведите слово и дробные длины numerictype([],32,30) (значение по умолчанию) | numerictype

Зависимости

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

Синтаксис

Описание

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

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

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

Зависимости

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

y Среднее значение скаляр | вектор | матрица

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

Примеры

Вычислите среднее значение и рабочее среднее значение сигнала

Алгоритмы

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

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

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

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

Блоки

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

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

Поддержка

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

Вход `ResetInputPort` — Additional, чтобы позволить сбросить рабочего среднего значения
`false` (значение по умолчанию) | `true`

`ResetCondition` — Условие, которое инициировало сброс рабочего среднего значения
`Non-zero` (значение по умолчанию) | `Rising edge` | `Falling edge` | `Either edge`

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

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

`RoundingMethod` — Округление метода для операций фиксированной точки
`Floor` (значение по умолчанию) | `Ceiling` | `Convergent` | `Nearest` | `Round` | `Simplest` | `Zero`

`OverflowAction` — Действие, чтобы взять, когда целочисленный вход вне области значений
`Wrap` (значение по умолчанию) | `Saturate`

`AccumulatorDataType` — Тип данных аккумулятора
`Same as input` (значение по умолчанию) | `Custom`

`CustomAccumulatorDataType` — Слово аккумулятора и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

`OutputDataType` — Тип данных вывода
`Same as accumulator` (значение по умолчанию) | `Same as input` | `Custom`

`CustomOutputDataType` — Выведите слово и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

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

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

`y` Среднее значение
скаляр | вектор | матрица

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