dsp. Максимум

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

Описание

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

Примечание

Режим Running в Системе dsp.Maximum object™ будет удален в будущем релизе. Чтобы вычислить рабочий максимум в 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` — Additional, чтобы позволить сбросить рабочего максимума
`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.

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

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

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

Синтаксис

[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`	Сбросьте внутренние состояния Системного объекта

Примеры

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

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

Скрипт Open Live Script

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

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

Алгоритмы

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

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

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

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

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

Генерация HDL-кода
Сгенерируйте Verilog и код VHDL для FPGA и проекты ASIC с помощью HDL Coder™.

Эта генерация HDL-кода поддержки объектов, если вам установили HDL Coder™. HDL Coder обеспечивает дополнительные параметры конфигурации, которые влияют на реализацию HDL и синтезируемую логику.

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

dsp. Максимум

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

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

Зависимости

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

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

Зависимости

Вход ResetInputPort — Additional, чтобы позволить сбросить рабочего максимума 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™.

Генерация HDL-кода Сгенерируйте Verilog и код VHDL для FPGA и проекты ASIC с помощью HDL Coder™.

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

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

Блоки

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

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

Поддержка

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

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

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

Вход `ResetInputPort` — Additional, чтобы позволить сбросить рабочего максимума
`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™.

Генерация HDL-кода
Сгенерируйте Verilog и код VHDL для FPGA и проекты ASIC с помощью HDL Coder™.