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

Maximum

Максимальные значения входных данных или последовательности входных данных.

Тип: Maximum

Путь в библиотеке:

/Signal Operations/Statistics/Maximum

Описание

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

Параметр Mode определяет режим работы блока и может быть установлен в одно из следующих значений:

  • Value — блок выводит максимальные значения в указанном измерении;

  • Index — блок выводит массив индексов с максимальными значениями в указанном измерении;

  • Value and Index — блок выводит максимальные значения и соответствующий массив индексов в указанном измерении.

Вы можете указать измерение, по которому блок вычисляет максимальное значение, используя параметр Find the maximum value over.

Порты

Вход

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

Details

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

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128

Поддержка комплексных чисел

Да

Выход

# Val — максимальные значения по указанному размеру
скаляр | вектор | матрица

Details

Тип данных максимального значения соответствует типу входных данных.

Если для параметра Mode установлено значение либо Value and Index, либо Value, применяется следующее:

  • Размер измерения, для которого блок вычисляет максимальное значение, равен 1. Размеры всех остальных измерений совпадают с размерами входного массива. Например, когда входным сигналом является массив на на с размером, установленным в 1, блок выводит массив на на . Когда размерность установлена в 3, блок выводит двумерную матрицу на .

  • Когда входным сигналом является матрица на с размером, установленным в 1, блок выводит матрицу на .

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

Зависимости

Чтобы использовать этот порт, установите для параметра Mode значение Value and Index или Value.

Типы данных

Float64

Поддержка комплексных чисел

Нет

# Idx — индекс максимальных значений вдоль указанного измерения
скаляр | вектор | матрица

Details

Когда входные данные двойные, значения индекса также удваиваются.

Зависимости

Чтобы использовать этот порт, установите для параметра Mode значение Value and Index или Index.

Типы данных

Float64

Поддержка комплексных чисел

Нет

Параметры

Основные

# Mode — режим работы блока
Value | Index | Value and Index

Details

Когда для параметра Mode установлено значение:

  • Value — блок вычисляет максимальное значение в каждой строке или каждом столбце входных данных или вдоль векторов заданного размера входных данных. Он также может вычислить максимальное значение всех входных данных в каждый момент выборки и вывести массив . Каждый элемент в выходных данных является максимальным значением в соответствующем столбце, строке, векторе или во всех входных данных. Вывод зависит от настройки параметра Find the maximum value over. Рассмотрим трехмерный входной сигнал размером на на . Если для параметра Find the maximum value over установлено значение:

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

    • Each column — выходные данные в каждый момент выборки состоят из массива размером на на , где каждый элемент содержит максимальное значение каждого вектора по первому измерению входных данных. Для ввода матрицы размером на выходным сигналом в каждый момент выборки является вектор-строка размером на .

      В этом режиме блок обрабатывает входные данные неориентированных векторов длиной как векторы-столбцы размером на .

    • Entire input — вывод в каждый момент выборки является скаляром, который содержит максимальное значение во входной матрице на на .

    • Specified dimension — выходной сигнал в каждый момент выборки зависит от размера. Если для измерения задано значение 1, выходные данные будут такими же, как при выборе каждого столбца. Если размерность установлена в 2, выходные данные будут такими же, как при выборе каждой строки. Если размерность установлена в 3, то выходные данные в каждый момент выборки представляют собой матрицу на , содержащую максимальное значение каждого вектора по третьему измерению входных данных.

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

maximum im
  • Index — блок вычисляет максимальное значение в каждой строке или каждом столбце входных данных вдоль векторов заданного размера входных данных или всего входного сигнала и выводит массив индексов . Каждый элемент в является целым числом, индексирующим максимальное значение в соответствующем столбце, строке, векторе или всем входном сигнале. Результат зависит от настройки параметра Find the maximum value over. Рассмотрим трехмерный входной сигнал размером на на :

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

    • Each column — вывод в каждый момент выборки состоит из массива размером на на , где каждый элемент содержит индекс максимального значения каждого вектора по первому измерению входных данных. Для входных данных, которые представляют собой матрицу на , выходные данные в каждый момент выборки представляют собой вектор-строку на .

      В этом режиме блок обрабатывает входные данные неориентированных векторов длиной как векторы-столбцы размером на .

    • Entire input — вывод в каждый момент выборки представляет собой вектор размером 1 на 3, который содержит местоположение максимального значения во входной матрице на на . Для входных данных, которые представляют собой матрицу на , выходные данные представляют собой вектор 1 на 2.

    • Specified dimension — вывод в каждый момент выборки зависит от размера. Если для измерения задано значение 1, выходные данные будут такими же, как при выборе каждого столбца. Если размерность установлена в 2, выходные данные будут такими же, как при выборе каждой строки. Если размерность установлена на 3, то выходные данные в каждый момент выборки представляют собой матрицу на , содержащую индексы максимальных значений каждого вектора по третьему измерению входных данных.

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

  • Value and Index — блок выводит максимальное значение в каждой строке или каждом столбце входных данных вдоль векторов заданного измерения входных данных или всего входного сигнала и соответствующего массива индексов .

Значения

Value | Index | Value and Index

Значение по умолчанию

Value and Index

Имя для программного использования

Mode

Настраиваемый

Нет

Вычисляемый

Нет

# Find the maximum value over — измерение, по которому блок вычисляет максимальное значение
Entire input | Each row | Each column | Specified dimension

Details
  • Each column — блок выводит максимальное значение по каждому столбцу.

  • Each row — блок выводит максимальное значение по каждой строке.

  • Entire input — блок выводит максимальное значение по всему входному сигналу.

  • Specified dimension — блок выводит максимальное значение по сравнению с размером, указанным в параметре Dimension.

Значения

Entire input | Each row | Each column | Specified dimension

Значение по умолчанию

Each column

Имя для программного использования

FindTheMaximumValueOver

Настраиваемый

Нет

Вычисляемый

Нет

# Dimension — пользовательская размерность
Int64 integer

Details

Укажите размерность (значение, основанное на единице) входного сигнала, по которому блок вычисляет максимум. Значение этого параметра должно быть больше нуля и меньше количества измерений во входном сигнале.

Зависимости

Чтобы использовать этот параметр, установите для параметра Find the maximum value over значение Specified dimension.

Значение по умолчанию

1

Имя для программного использования

Dimension

Настраиваемый

Нет

Вычисляемый

Да