2-D Maximum

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

Библиотека

Статистика

visionstatistics

Описание

2D блок Maximum идентифицирует значение и/или положение самого маленького элемента в каждой строке или столбце входа, или в заданном измерении входа. 2D блок Maximum может также отследить максимальные значения в последовательности входных параметров в течение времени.

2D блок Maximum поддерживает действительную и комплексную фиксированную точку с плавающей точкой и булевы входные параметры. Действительные входные параметры фиксированной точки могут быть или подписаны или без знака, в то время как комплексные входные параметры фиксированной точки должны быть подписаны. Тип выходных данных максимальных значений совпадает с типом данных входа. Блок выходные параметры double индексируйте значения, когда входом будет double, и uint32 в противном случае.

Описания порта

ПортВвод/выводПоддерживаемые типы данных

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

Скаляр, вектор или матрица значений интенсивности

  • Плавающая точка двойной точности

  • Плавающая точка с одинарной точностью

  • Фиксированная точка (подписанный и без знака)

  • Булевская переменная

  • 8-, 16-, и 32-битные целые числа со знаком

  • 8-, 16-, и 32-битное беззнаковое целое

Rst

Скалярное значение

  • Плавающая точка двойной точности

  • Плавающая точка с одинарной точностью

  • Булевская переменная

  • 8-, 16-, и 32-битные целые числа со знаком

  • 8-, 16-, и 32-битное беззнаковое целое

Val

Максимальное значение выводится на основе Режима Значения

  • Плавающая точка двойной точности

  • Плавающая точка с одинарной точностью

  • Фиксированная точка (подписанный и без знака)

  • Булевская переменная

  • 8-, 16-, и 32-битные целые числа со знаком

  • 8-, 16-, и 32-битное беззнаковое целое

Idx

Выходное местоположение на основе одно максимального значения на основе Режима индексации

  • Плавающая точка двойной точности

  • 32-битное беззнаковое целое

Режим значения

Когда вы устанавливаете параметр Mode на Value, блок вычисляет максимальное значение в каждой строке или столбце входа, вдоль векторов заданного измерения входа, или целого входа в каждом шаге расчета, и выводит массив y. Каждый элемент в y является максимальным значением в соответствующем столбце, строке, векторе или целом входе. Выход y зависит от установки параметра Find the maximum value over. Например, считайте 3-мерный входной сигнал размера M-by-N-by-P:

  • Each row — Выход в каждом шаге расчета состоит из M-by-1-by-P массив, где каждый элемент содержит максимальное значение каждого вектора по второму измерению входа. Для M-by-N входная матрица, блок выводит M-by-1 вектор-столбец в каждом шаге расчета.

  • Each column — Выход в каждом шаге расчета состоит из 1 N P массивом, где каждый элемент содержит максимальное значение каждого вектора по первой размерности входа. Для M-by-N входная матрица, блок выводит 1 N вектором-строкой в каждом шаге расчета.

    В этом режиме блок обрабатывает длину-M, неориентированную на векторные входные параметры как M-by-1 вектор-столбцы.

  • Entire input — Выход в каждом шаге расчета является скаляром, который содержит максимальное значение в M-by-N-by-P входная матрица.

  • Specified dimension — Выход в каждом шаге расчета зависит от Dimension. Когда вы устанавливаете Dimension на 1, блок выход эквивалентен, когда вы выбираете Each column. Когда вы устанавливаете Dimension на 2, блок выход эквивалентен, когда вы выбираете Each row. Когда вы устанавливаете Dimension на 3, блок выводит M-by-N матрица, содержащая максимальное значение каждого вектора по третьей размерности входа в каждом шаге расчета.

Для комплексных входных параметров блок выбирает значение в каждой строке или столбце входа вдоль векторов заданного измерения входа, или целого входа, который имеет максимальную величину, в квадрате как показано ниже. Для комплексного числа u=a+bi, величина придала квадратную форму, a2+b2.

Режим индексации

Когда вы устанавливаете параметр Mode на Index, блок вычисляет максимальное значение в каждой строке или столбце входа, вдоль векторов заданного измерения входа, или целого входа, и выводит массив индекса I. Каждый элемент в I является целым числом, индексирующим максимальное значение в соответствующем столбце, строке, векторе или целом входе. Выход I зависит от установки параметра Find the maximum value over. Например, считайте 3-мерный входной сигнал размера M-by-N-by-P:

  • Each row — Выход в каждом шаге расчета состоит из M-by-1-by-P массив, где каждый элемент содержит индекс максимального значения каждого вектора по второму измерению входа. Для входа, который является M-by-N матрица, выходом в каждом шаге расчета является M-by-1 вектор-столбец.

  • Each column — Выход в каждом шаге расчета состоит из 1 N P массивом, где каждый элемент содержит индекс максимального значения каждого вектора по первой размерности входа. Для входа, который является M-by-N матрица, выход в каждом шаге расчета является 1 N вектором-строкой.

    В этом режиме блок обрабатывает длину-M, неориентированную на векторные входные параметры как M-by-1 вектор-столбцы.

  • Entire input — Выход в каждом шаге расчета 1 3 вектор, который содержит местоположение максимального значения в M-by-N-by-P входная матрица. Для входа, который является M-by-N матрица, выход будет 1 2 вектор на основе одного [x y] координаты места для максимального значения.

  • Specified dimension — Выход в каждом шаге расчета зависит от Dimension. Если Dimension установлен в 1, выход эквивалентен, когда вы выбираете Each column. Если Dimension установлен в 2, выход эквивалентен, когда вы выбираете Each row. Если Dimension установлен в 3, выходом в каждом шаге расчета является M-by-N матрица, содержащая индексы максимальных значений каждого вектора по третьей размерности входа.

Когда максимальное значение происходит несколько раз, вычисленный индекс соответствует первому вхождению. Например, когда вход является вектор-столбцом [3 2 1 2 3]', вычисленным индексом на основе одним максимального значения является 1 вместо 5 когда Each column выбран.

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

Значение и режим индексации

Когда вы устанавливаете параметр Mode на Value and Index, блок выходные параметры и максимумы и индексы.

Выполнение режима

Когда вы устанавливаете параметр Mode на Running, блок отслеживает максимальное значение каждого канала в последовательности времени M-by-N входные параметры. В этом режиме блок обрабатывает каждый элемент как канал.

Сброс рабочего максимума

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

Вы задаете событие сброса в меню Reset port:

  • None — Отключает порт Rst.

  • Rising edge — Инициировал операцию сброса, когда вход Rst выполняет одно из следующих действий:

    • Повышения от отрицательной величины до положительного значения или нуля

    • Повышения от нуля до положительного значения, где повышение не является продолжением повышения от отрицательной величины, чтобы обнулить (см. следующую фигуру),

  • Falling edge — Инициировал операцию сброса когда Rst введите выполняет одно из следующих действий:

    • Падения от положительного значения до отрицательной величины или нуля

    • Падения от нуля до отрицательной величины, где падение не является продолжением падения от положительного значения, чтобы обнулить (см. следующую фигуру),

  • Either edge — Инициировал операцию сброса когда Rst входом является Rising edge или Falling edge (аналогичный описанному выше)

  • Non-zero sample — Инициировал операцию сброса в каждом шаге расчета что Rst вход не является нулем

    Примечание

    Когда рабочие симуляции в Simulink® MultiTasking режим, сигналы сброса имеют задержку с одной выборкой. Поэтому, когда блок обнаруживает событие сброса, существует задержка с одной выборкой при скорости порта сброса, прежде чем блок применит сброс.

Обработка ROI

Чтобы вычислить статистическое значение в конкретной видимой области (ROI) входа, установите флажок Enable ROI processing. Это применяется к любому режиму кроме рабочего режима и когда вы устанавливаете параметр Find the maximum value over на Entire input и вы устанавливаете флажок Enable ROI processing. Обработка ROI применяется только для 2D входных параметров.

Можно задать RectanglesСтроки, Label matrix, или Binary mask Тип ROI.

Используйте Binary mask задавать который пиксели подсветить или выбрать.

Используйте Label matrix пометить области. Пиксельный набор к 0 представляйте фон. Пиксельный набор к 1 представляйте первый объект, пиксельный набор к 2, представляйте второй объект и так далее. Используйте порт Label Numbers, чтобы задать объекты в матрице метки, для которой блок вычисляет статистику. Вход к этому порту должен быть вектором скалярных значений, которые соответствуют помеченным областям в матрице метки.

Для прямоугольных ROI используйте параметр ROI portion to process, чтобы задать, вычислить ли статистическое значение для целого ROI или только периметра ROI. Для получения дополнительной информации о формате входа к порту ROI, когда вы установите ROI на прямоугольник или линию, смотрите страницу с описанием блока Draw Shapes.

ROI Выходная статистика

Выведите = Отдельная статистика для каждого ROI

Отметьте выход портаОписание
0ROI полностью вне входного изображения.
1ROI полностью или частично во входном изображении.

Выведите = Одна статистическая величина для всех ROI

Отметьте выход портаОписание
0Все ROI полностью вне входного изображения.
1По крайней мере один ROI полностью или частично во входном изображении.

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

Выведите = Отдельная статистика для каждого ROI

Отметьте выход портаОписание
0Номер метки не находится в матрице метки.
1Номер метки находится в матрице метки.

Выведите = Одна статистическая величина для всех ROI

Отметьте выход портаОписание
0Ни один из номеров метки не находится в матрице метки.
1По крайней мере один из номеров метки находится в матрице метки.

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

Параметры на панели Data Types диалогового окна блока только используются в комплексных входных параметрах фиксированной точки. Сумма квадратов действительных и мнимых частей такого входа формируется, прежде чем сравнение сделано, как описано в Режиме Значения. Результаты квадратов действительных и мнимых частей помещаются в тип выходных данных продукта. Результат суммы квадратов помещается в тип данных аккумулятора. Эти параметры проигнорированы для других типов входных параметров.

Параметры

Mode

Задайте режим работы блока:

  • Value and Index — Выведите и значение и местоположение индекса.

  • Value — Выведите максимальное значение каждой входной матрицы. Для получения дополнительной информации смотрите Режим Значения.

  • Index— Выведите местоположение индекса на основе одно максимального значения. Для получения дополнительной информации смотрите Режим индексации.

  • Running — Отследите максимальное значение входной последовательности в зависимости от времени. Для получения дополнительной информации смотрите Рабочий Режим.

Для Value, Index, и Value and Index режимы, 2D блок Maximum приводит к идентичным результатам как к MATLAB® max функционируйте, когда это будет названо как [y I] = max(u,[],D), где u и y ввод и вывод, соответственно, D является размерностью, и I является индексом.

Find the maximum value over

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

Reset port

Задайте событие сброса, которое заставляет блок сбрасывать рабочий максимум. Уровень сигнала сброса должен быть положительным целочисленным кратным уровень входа сигнала данных. Этот параметр появляется только, когда вы устанавливаете параметр Mode на Running. Для получения информации о возможных значениях этого параметра смотрите Сброс Рабочего Максимума.

Dimension

Задайте размерность (значение на основе одно) входного сигнала, по которому вычисляется максимум. Значение этого параметра не может превысить количество размерностей во входном сигнале. Этот параметр применяется только, когда вы устанавливаете параметр Find the maximum value over на Specified dimension.

Enable ROI processing

Установите этот флажок, чтобы вычислить статистическое значение в конкретной области каждого изображения. Этот параметр применяется только, когда вы устанавливаете параметр Find the maximum value over на Entire input, и блок не находится в рабочем режиме.

ROI type

Задайте тип ROI, который вы хотите использовать. Вашим выбором является RectanglesСтроки, Label matrix, или Binary mask.

Когда вы устанавливаете этот параметр на Rectangles или Lines, флажок Output flag indicating if ROI is within image bounds появляется в диалоговом окне. Если вы устанавливаете этот флажок, порт Flag появляется на блоке.

Когда вы устанавливаете этот параметр на Label matrix, порты Label и Label Numbers появляются на блоке, и флажок Output flag indicating if input label numbers are valid появляется в диалоговом окне. Если вы устанавливаете этот флажок, порт Flag появляется на блоке.

Смотрите ROI Выходная Статистика для деталей.

ROI portion to process

Задайте, хотите ли вы вычислить статистическое значение для целого ROI или только периметра ROI. Этот параметр применяется только, когда вы устанавливаете параметр ROI type на Rectangles.

Output

Задайте блок выход. Блок может вывести вектор отдельных статистических значений для каждого ROI или скалярного значения, которое представляет статистическое значение для всех заданных ROI. Этот параметр не применяется, когда вы устанавливаете параметр ROI type к Binary mask.

Output flag indicating if ROI is within image bounds

Когда вы устанавливаете этот флажок, порт Flag появляется на блоке. Этот флажок применяется только, когда вы устанавливаете параметр ROI type на Rectangles или Lines. Для описания выхода порта Flag см. таблицы в Обработке ROI.

Output flag indicating if label numbers are valid

Когда вы устанавливаете этот флажок, порт Flag появляется на блоке. Этот флажок применяется только, когда вы устанавливаете параметр ROI type на Label matrix. Для описания выхода порта Flag см. таблицы в Обработке ROI.

Примечание

Параметры на панели Data Types только используются в комплексных входных параметрах фиксированной точки. Сумма квадратов действительных и мнимых частей такого входа формируется, прежде чем сравнение сделано, как описано в Режиме Значения. Результаты квадратов действительных и мнимых частей помещаются в тип выходных данных продукта. Результат суммы квадратов помещается в тип данных аккумулятора. Эти параметры проигнорированы для других типов входных параметров.

Rounding mode

Выберите Rounding Modes для операций фиксированной точки.

Saturate on integer overflow

Выберите режим переполнения для операций фиксированной точки. Смотрите Точность и Область значений.

Product output data type

Задайте тип выходных данных продукта. Смотрите Типы данных с фиксированной точкой и Типы данных Умножения для рисунков, изображающих использование типа выходных данных продукта в этом блоке. Можно установить его на:

  • Правило, которое наследовало тип данных, например, Inherit: Same as input

  • Выражение, которое оценивает к допустимому типу данных, например, fixdt([],16,0)

Нажмите кнопку Show data type assistant, чтобы отобразить Data Type Assistant, который помогает вам установить параметр Product output data type.

Смотрите Задают Типы данных Используя Ассистент Типа данных (Simulink) для получения дополнительной информации.

Accumulator data type

Задайте тип данных аккумулятора. Смотрите Типы данных с фиксированной точкой для рисунков, изображающих использование типа данных аккумулятора в этом блоке. Можно установить этот параметр на:

  • Правило, которое наследовало тип данных, например, Inherit: Same as product output

  • Выражение, которое оценивает к допустимому типу данных, например, fixdt([],16,0)

Нажмите кнопку Show data type assistant, чтобы отобразить Data Type Assistant, который помогает вам установить параметр Accumulator data type.

Смотрите Задают Типы данных Используя Ассистент Типа данных (Simulink) для получения дополнительной информации.

Lock data type settings against changes by the fixed-point tools

Выберите этот параметр, чтобы препятствовать тому, чтобы Fixed-Point Tool заменили типы данных, которые вы задаете на маске блока.

Примеры

ex_vision_2dmaximum пример находит максимальное значение в двух ROI. Выходные параметры модели максимальные значения и их на основе одно [x y] координируют местоположения.

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

2-D MeanComputer Vision Toolbox
2-D MinimumComputer Vision Toolbox
MinMaxSimulink
maxMATLAB

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

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