dsp.Mean

(Чтобы быть удаленным), Находят среднее значение входа или последовательность входных параметров

Описание

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

Примечание

dsp.Mean Система object™ будет удалена в будущем релизе. Чтобы вычислить среднее значение, используйте mean функция. Чтобы вычислить рабочее среднее значение в 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` — Дополнительный вход, чтобы позволить сбросить рабочего среднего значения
`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.

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

Синтаксис

y = mn(x)

y = mn(x,r)

Описание

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

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

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

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

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

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

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

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

Зависимости

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

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

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

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

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

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

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

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

release(obj)

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

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

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

Примеры

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

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

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

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

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

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

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

Обновите код

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

Нежелательное использование (R2016b или позже)	Нежелательное использование (перед R2016b)	Рекомендуемая замена
Среднее значение Mean1 = dsp.Mean; x = randn(100,1); y = Mean1(x); Выполнение среднего значения Mean2 = dsp.Mean; Mean2.RunningMean = true; x = randn(100,1); y = Mean2(x); % Running mean	Среднее значение Mean1 = dsp.Mean; x = randn(100,1); y = step(Mean1,x); Выполнение среднего значения Mean2 = dsp.Mean; Mean2.RunningMean = true; x = randn(100,1); y = step(Mean2,x);	Среднее значение x = randn(100,1); y = mean(x); Выполнение среднего значения mvgAvg = dsp.MovingAverage; mvgAvg.SpecifyWindowLength = false; x = randn(100,1); y = mvgAvg(x);

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

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

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

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

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

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

Mean2 = dsp.Mean;
Mean2.RunningMean = true;
x = randn(100,1);
y = Mean2(x); % Running mean

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

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

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

Mean2 = dsp.Mean;
Mean2.RunningMean = true;
x = randn(100,1);
y = step(Mean2,x);

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

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

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

mvgAvg = dsp.MovingAverage;
mvgAvg.SpecifyWindowLength = false;
x = randn(100,1);
y = mvgAvg(x);

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

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

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

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

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

dsp.Mean

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

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

ResetInputPort — Дополнительный вход, чтобы позволить сбросить рабочего среднего значения 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 среднее значение скаляр | вектор | матрица

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

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

Примеры

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

Алгоритмы

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

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

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

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

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

Функции

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

Блоки

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

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

Поддержка

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

`ResetInputPort` — Дополнительный вход, чтобы позволить сбросить рабочего среднего значения
`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™.