2-D Mean

Найдите среднее значение каждой входной матрицы

Библиотека

Статистика

visionstatistics

Описание

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

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

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

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

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

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

  • Фиксированная точка

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

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

Сброс

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

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

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

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

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

ROI

Прямоугольники и линии:

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

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

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

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

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

Бинарная маска:

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

Метка

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

Номера метки

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

Вывод

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

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

  • Фиксированная точка

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

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

Флаг

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

Основная операция

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

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

    y = mean(u(:))					% Equivalent MATLAB code 
  • Each row — Выход в каждом шаге расчета состоит из M-by-1-by-P массив, где каждый элемент содержит среднее значение каждого вектора по второму измерению входа. Для входа, который является M-by-N матрица, выходом в каждом шаге расчета является M-by-1 вектор-столбец.

    y = mean(u,2)					% Equivalent MATLAB code 
  • Each column — Выход в каждом шаге расчета состоит из 1 N P массивом, где каждый элемент содержит среднее значение каждого вектора по первой размерности входа. Для входа, который является M-by-N матрица, выход в каждом шаге расчета является 1 N вектором-строкой.

    y = mean(u)					% Equivalent MATLAB code 

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

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

    y = mean(u,Dimension)					% Equivalent MATLAB code 

Среднее значение комплексного входа вычисляется независимо для действительных и мнимых компонентов как показано в следующем рисунке.

Выполнение операции

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

Сброс рабочего среднего значения

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

Обработка ROI

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

  • Бинарная маска является двухуровневым изображением, которое позволяет вам задать, какие пиксели подсветить, или выбирают.

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Можно установить аккумулятор и типы выходных данных в диалоговом окне блока, как обсуждено в Параметрах.

Параметры

Running mean

Включает рабочую операцию, когда выбрано.

Reset port

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

Find the mean value over

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

Dimension

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

Enable ROI Processing

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

ROI type

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

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.

Output flag indicating if label numbers are valid

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

Rounding mode

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

Saturate on integer overflow

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

Accumulator data type

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

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

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

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

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

Output data type

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

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

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

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

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

Minimum

Задайте минимальное значение, которое должен вывести блок. Значение по умолчанию, [], эквивалентно -Inf. Программное обеспечение Simulink использует это значение, чтобы выполнить:

Maximum

Задайте максимальное значение, которое должен вывести блок. Значение по умолчанию, [], эквивалентно Inf. Программное обеспечение Simulink использует это значение, чтобы выполнить:

Пример

ex_vision_2dmean вычисляет среднее значение в двух ROI.

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

2-D MaximumComputer Vision Toolbox™

2D-Median

Computer Vision Toolbox
2-D MinimumComputer Vision Toolbox
2-D Standard DeviationComputer Vision Toolbox
meanMATLAB

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

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