avgpool

Объедините данные к средним значениям по пространственным размерностям

свернуть все на странице

Синтаксис

dlY = avgpool(dlX,poolsize)
dlY = avgpool(dlX,poolsize,'DataFormat',FMT)
dlY = avgpool(___,Name,Value)

Описание

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

Примечание

Эта функция применяет среднюю операцию объединения к dlarray данные. Если вы хотите применить среднее объединение в layerGraph объект или Layer массив, используйте один из следующих слоев:

пример

dlY = avgpool(dlX,poolsize) выполняет субдискретизацию путем деления входа dlX в прямоугольные или кубовидные области, заданные poolsize и вычисление среднего значения данных в каждой области. Вход dlX отформатированный dlarray с метками размерности. Объединение действий на пространственных размерностях пометило 'S'. Выход dlY отформатированный dlarray с той же размерностью помечает как dlX.

dlY = avgpool(dlX,poolsize,'DataFormat',FMT) указывает, что размерность маркирует FMT когда dlX не отформатированный dlarray. Выход dlY бесформатный dlarray с той же размерностью заказывают как dlX.

dlY = avgpool(___,Name,Value) задает опции с помощью одного или нескольких аргументов пары "имя-значение" в дополнение к входным параметрам в предыдущих синтаксисах. Например, 'Stride',3 устанавливает шаг операции объединения.

Примеры

свернуть все

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

Создайте входные данные как dlarray. Данные содержат одно наблюдение за случайными значениями с высотой и шириной шесть и один канал. 

height = 6;
width = 6;
channels = 1;
observations = 1;

X = rand(height,width,channels,observations);
dlX = dlarray(X,'SSCB')
dlX = 
  6(S) × 6(S) × 1(C) × 1(B) dlarray

    0.1781    0.8819    0.1564    0.4820    0.2518    0.7302
    0.1280    0.6692    0.8555    0.1206    0.2904    0.3439
    0.9991    0.1904    0.6448    0.5895    0.6171    0.5841
    0.1711    0.3689    0.3763    0.2262    0.2653    0.1078
    0.0326    0.4607    0.1909    0.3846    0.8244    0.9063
    0.5612    0.9816    0.4283    0.5830    0.9827    0.8797

Объедините данные к средним значениям по объединению областей размера 2 использование шага 2.

dlY = avgpool(dlX,2,'Stride',2)
dlY = 
  3(S) × 3(S) × 1(C) × 1(B) dlarray

    0.4643    0.4036    0.4041
    0.4324    0.4592    0.3936
    0.5090    0.3967    0.8983

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

свернуть все

Входные данные, заданные как dlarray с или без меток размерности. Когда dlX не отформатированный dlarray, необходимо задать формат этикетки размерности с помощью 'DataFormat',FMT.

Объединение действий на размерностях, которые вы задаете как пространственные размерности с помощью 'S' метка размерности. dlX должен иметь по крайней мере один 'S' размерность. Можно задать до трех измерений в dlX как 'S' размерности. avgpool операция делит данные вдоль каждого 'S' размерность в области задана poolsize. Значения в каждой области объединения усреднены.

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

Размер областей объединения, заданных в виде числа или числового вектора. Если вы задаете poolsize как скаляр, области объединения имеют тот же размер по всем пространственным измерениям. Чтобы использовать прямоугольные или кубовидные области объединения, которые имеют различные размеры по каждому пространственному измерению, задайте poolsize как вектор с той же длиной как количество пространственных размерностей в dlX.

Пример 3

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

Порядок размерности бесформатных входных данных, заданных как разделенная запятой пара, состоящая из 'DataFormat' и символьный массив или строка, которая обеспечивает метку для каждой размерности данных. Каждый символ в FMT должно быть одно из следующего:

  • 'S' — Пространственный

  • 'C' — Канал

  • 'B' — Пакет (например, выборки и наблюдения)

  • 'T' — Время (например, последовательности)

  • 'U' — Незаданный

Можно указать, что несколько размерностей пометили 'S' или 'U'. Можно использовать, маркирует 'C'B, или 'T' самое большее однажды.

Необходимо задать 'DataFormat' когда входные данные dlX бесформатный dlarray.

Пример: 'DataFormat','SSCB'

Типы данных: char | string

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Stride',2 задает шаг областей объединения как 2.

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

Значение по умолчанию 'Stride' 1. Если 'Stride' меньше poolsize в любой размерности, затем перекрытие областей объединения.

Пример: 'Stride',3

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

Дополнение примененного ребра данных, заданных как разделенная запятой пара, состоящая из 'Padding' и одно из следующего:

  • 'same' — Дополнение установлено так, чтобы выходной размер совпал с входным размером, когда шагом является 1. В более общем плане выходным размером каждой пространственной размерности является ceil(inputSize/stride), где inputSize размер входа по пространственному измерению.

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

  • Числовой вектор — различное дополнительное значение применяется по каждому пространственному измерению. Используйте вектор размера d, где d количество пространственных размерностей входных данных. iэлемент th вектора указывает, что дополнение применилось к запуску и концу вдоль ith пространственная размерность.

  • Числовая матрица — различное дополнительное значение применяется к запуску и концу каждой пространственной размерности. Используйте матрицу размера 2 d, где d количество пространственных размерностей входных данных. Элемент (1,d) указывает, что дополнение применилось к запуску пространственной размерности d. Элемент (2,d) задает дополнение, примененное в конец пространственной размерности d. Например, в 2D, форматом является [top, left; bottom, right].

Значение по умолчанию 'Padding' 0.

Пример: 'Padding','same'

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

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

свернуть все

Объединенные данные, возвращенные как dlarray. Выход dlY имеет тот же базовый тип данных как вход dlX.

Если входные данные dlX отформатированный dlarray, dlY имеет те же метки размерности как dlX. Если входными данными не является отформатированный dlarray, dlY бесформатный dlarray с той же размерностью заказывают как входные данные.

Больше о

свернуть все

Среднее объединение

avgpool функционируйте объединяет входные данные к средним значениям по пространственным размерностям. Для получения дополнительной информации см. определение Среднего Слоя Объединения на averagePooling2dLayer страница с описанием.

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

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

| | | |

Темы

Введенный в R2019b

Документация Deep Learning Toolbox
Поддержка
Для просмотра документации необходимо авторизоваться на сайте