dsp.Maximum

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

Описание

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

Примечание

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

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

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

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

Создание

Синтаксис

max = dsp.Maximum

max = dsp.Maximum(Name,Value)

Описание

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

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

Свойства

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

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

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

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

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

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

Зависимости

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

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

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

`IndexBase` — Нумерация основы для индекса максимального значения
`One` (значение по умолчанию) | `Zero`

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

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

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

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

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

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

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

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

Зависимости

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

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

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

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

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

Зависимости

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

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

Синтаксис

[val,ind] = max(x)

val = max(x)

ind = max(x)

val = max(x,r)

Описание

[val,ind] = max(x) возвращает максимальное значение, val, и индекс или положение максимального значения, ind, вдоль заданного Dimension из x.

val = max(x) возвращает максимальное значение, val, из входа x. Когда RunningMaximum свойством является true, val соответствует максимальному значению по последовательным вызовам объектного алгоритма.

ind = max(x) возвращает нуль - или индекс на основе один ind из максимального значения. Чтобы включить этот тип обработки, установите IndexOutputPort свойство к true и ValueOutputPort и RunningMaximum свойства к false.

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

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

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

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

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

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

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

Зависимости

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

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

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

`val` — Максимальное значение входа
скаляр | вектор

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

`ind` — Индекс максимума
скаляр | вектор

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

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

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

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

release(obj)

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

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

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

Примеры

Вычислите максимум и рабочий максимум сигнала

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

Найдите максимальное значение и его индекс.

max1 = dsp.Maximum;
x = randn(100,1);
[y,I] = max1(x)

y = 3.5784

I = 9

Вычислите рабочий максимум.

 max2 = dsp.Maximum;
 max2.RunningMaximum = true;
 x = randn(100,1);
 z = max2(x);
 plot(z)

z (i) является максимумом всех значений в векторе x (1:i).

Алгоритмы

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

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

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

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

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

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

Обновите код

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

Нежелательное использование (R2016b или позже)	Нежелательное использование (перед R2016b)	Рекомендуемая замена
Максимум Max1 = dsp.Maximum; x = randn(100,1); y = Max1(x); Рабочий максимум Max2 = dsp.Maximum; Max2.RunningMaximum = true; x = randn(100,1); y = Max2(x); % Running maximum	Максимум Max1 = dsp.Maximum; x = randn(100,1); y = step(Max1,x); Рабочий максимум Max2 = dsp.Maximum; Max2.RunningMaximum = true; x = randn(100,1); y = step(Max2,x);	Максимум x = randn(100,1); y = max(x); Рабочий максимум mvgMax = dsp.MovingMaximum; mvgMax.SpecifyWindowLength = false; x = randn(100,1); y = mvgMax(x);

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

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

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

Максимум

Max1 = dsp.Maximum;
x = randn(100,1);
y = Max1(x);

Рабочий максимум

Max2 = dsp.Maximum;
Max2.RunningMaximum = true;
x = randn(100,1);
y = Max2(x); % Running maximum

Максимум

Max1 = dsp.Maximum;
x = randn(100,1);
y = step(Max1,x);

Рабочий максимум

Max2 = dsp.Maximum;
Max2.RunningMaximum = true;
x = randn(100,1);
y = step(Max2,x);

Максимум

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

Рабочий максимум

mvgMax = dsp.MovingMaximum;
mvgMax.SpecifyWindowLength = false;
x = randn(100,1);
y = mvgMax(x);

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

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

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

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

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

dsp.Maximum

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

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

Зависимости

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

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

Зависимости

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

Зависимости

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

Зависимости

IndexBase — Нумерация основы для индекса максимального значения One (значение по умолчанию) | Zero

Зависимости

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

Зависимости

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

Зависимости

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

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

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

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

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

Зависимости

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

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

Зависимости

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

Синтаксис

Описание

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

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

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

Зависимости

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

val — Максимальное значение входа скаляр | вектор

ind — Индекс максимума скаляр | вектор

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

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

Примеры

Вычислите максимум и рабочий максимум сигнала

Алгоритмы

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

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

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

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

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

Функции

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

Блоки

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

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

Поддержка

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

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

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

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

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

`IndexBase` — Нумерация основы для индекса максимального значения
`One` (значение по умолчанию) | `Zero`

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

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

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

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

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

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

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

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

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

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

`val` — Максимальное значение входа
скаляр | вектор

`ind` — Индекс максимума
скаляр | вектор

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