averagePooling3dLayer

3-D средний слой объединения

Описание

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

Создание

Синтаксис

layer = averagePooling3dLayer(poolSize)
layer = averagePooling3dLayer(poolSize,Name,Value)

Описание

layer = averagePooling3dLayer(poolSize) создает средний слой объединения и устанавливает свойство PoolSize.

пример

layer = averagePooling3dLayer(poolSize,Name,Value) устанавливает дополнительные свойства Stride и Name с помощью пар "имя-значение". Чтобы задать входное дополнение, используйте аргумент пары "имя-значение" 'Padding'. Например, averagePooling3dLayer(2,'Stride',2) создает 3-D средний слой объединения с размером пула [2 2 2] и шаг [2 2 2]. Можно задать несколько пар "имя-значение". Заключите каждое имя свойства в одинарные кавычки.

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

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

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

Используйте разделенные от запятой аргументы пары "имя-значение", чтобы задать размер нулевого дополнения, чтобы добавить вдоль ребер входа слоя или установить свойства Stride и Name. Заключите имена в одинарные кавычки.

Пример: averagePooling3dLayer(2,'Stride',2) создает 3-D средний слой объединения с размером пула [2 2 2] и шаг [2 2 2].

Введите дополнение ребра, заданное как пара, разделенная запятой, состоящая из 'Padding' и одно из этих значений:

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

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

  • Трехэлементный векторный [a b c] неотрицательных целых чисел — Добавляет дополнение размера a к верху и низу, дополнению размера b налево и право и дополнение размера c к передней и задней части входа.

  • 2 3 матричный [t l f;b r k] неотрицательных целых чисел — Добавляет дополнение размера t к верхней части, b к нижней части, l налево, r направо, f к передней стороне и k к задней части входа. Другими словами, верхняя строка задает предварительное дополнение, и вторая строка задает постдополнение в трех измерениях.

Пример: 'Padding',1 добавляет одну строку дополнения к верху и низу, одному столбцу дополнения налево и права и одной плоскости дополнения к передней и задней части входа.

Пример: 'Padding','same' добавляет дополнение так, чтобы вывод имел тот же размер как вход (если шаг равняется 1).

Свойства

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

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

Размерности областей объединения, заданных как вектор трех положительных целых чисел, [h w d], где h является высотой, w, является шириной и d, являются глубиной. При создании слоя можно задать PoolSize как скаляр, чтобы использовать то же значение для всех трех измерений.

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

Дополнительные размерности PaddingSize должны быть меньше, чем размерности области объединения PoolSize.

Пример: [2 1 1] задает области объединения высоты 2, ширина 1, и глубина 1.

Размер шага для того, чтобы пересечь вход в трех измерениях, заданных как векторный [a b c] трех положительных целых чисел, где a является вертикальным размером шага, b, является горизонтальным размером шага, и c является размером шага вдоль направления глубины. При создании слоя можно задать Stride как скаляр, чтобы использовать то же значение для размеров шага во всех трех направлениях.

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

Дополнительные размерности PaddingSize должны быть меньше, чем размерности области объединения PoolSize.

Пример: [2 3 1] задает вертикальный размер шага 2, горизонтальный размер шага 3 и размер шага вдоль глубины 1.

Размер дополнения, чтобы применяться к входным границам, заданным, когда 2 3, матричный [t l f;b r k] неотрицательных целых чисел, где t и b являются дополнением, применился к верху и низу в вертикальном направлении, l и r являются дополнением, применился к левому и правому в горизонтальном направлении, и f и k являются дополнением, применился к передней и задней части вдоль глубины. Другими словами, верхняя строка задает предварительное дополнение, и вторая строка задает постдополнение в трех измерениях.

Когда вы создадите слой, используйте аргумент пары "имя-значение" 'Padding', чтобы задать дополнительный размер.

Пример: [1 2 4;1 2 4] добавляет одну строку дополнения к верху и низу, двум столбцам дополнения налево и права и четырех плоскостей дополнения к передней и задней части входа.

Метод, чтобы определить дополнительный размер, заданный как 'manual' или 'same'.

Программное обеспечение автоматически устанавливает значение PaddingMode на основе 'Дополнительного' значения, которое вы задаете при создании слоя.

  • Если вы устанавливаете опцию 'Padding' на скаляр или вектор неотрицательных целых чисел, то программное обеспечение автоматически устанавливает PaddingMode на 'manual'.

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

Слой

Имя слоя, заданное как вектор символов или скаляр строки. Чтобы включать слой в график слоя, необходимо задать непустое уникальное имя слоя. Если вы обучаете серийную сеть со слоем, и Name установлен в '', то программное обеспечение автоматически присваивает имя к слою в учебное время.

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

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

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

Введите имена слоя. Этот слой принимает один вход только.

Типы данных: cell

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

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

Выведите имена слоя. Этот слой имеет один вывод только.

Типы данных: cell

Примеры

свернуть все

Создайте 3-D средний слой объединения с неналожением областей объединения, который субдискретизирует фактором 2.

layer = averagePooling3dLayer(2,'Stride',2)
layer = 
  AveragePooling3DLayer with properties:

           Name: ''

   Hyperparameters
       PoolSize: [2 2 2]
         Stride: [2 2 2]
    PaddingMode: 'manual'
    PaddingSize: [2x3 double]

Включайте 3-D средний слой объединения в массив Layer.

layers = [ ...
    image3dInputLayer([28 28 28 3])
    convolution3dLayer(5,20)
    reluLayer
    averagePooling3dLayer(2,'Stride',2)
    fullyConnectedLayer(10)
    softmaxLayer
    classificationLayer]
layers = 
  7x1 Layer array with layers:

     1   ''   3-D Image Input         28x28x28x3 images with 'zerocenter' normalization
     2   ''   Convolution             20 5x5x5 convolutions with stride [1  1  1] and padding [0  0  0; 0  0  0]
     3   ''   ReLU                    ReLU
     4   ''   Average 3D Pooling      2x2x2 average pooling with stride [2  2  2] and padding [0  0  0; 0  0  0]
     5   ''   Fully Connected         10 fully connected layer
     6   ''   Softmax                 softmax
     7   ''   Classification Output   crossentropyex

Создайте 3-D средний слой объединения с наложением областей объединения и дополнением для верха и низа входа.

layer = averagePooling3dLayer([3 2 2],'Stride',2,'Padding',[1 0 0])
layer = 
  AveragePooling3DLayer with properties:

           Name: ''

   Hyperparameters
       PoolSize: [3 2 2]
         Stride: [2 2 2]
    PaddingMode: 'manual'
    PaddingSize: [2x3 double]

Этот слой создает области объединения размера 3 2 на 2 и берет среднее значение этих двенадцати элементов в каждой области. Шаг 2 во всех размерностях. Области объединения накладываются, потому что существуют размерности шага Stride, которые являются меньше, чем соответствующие размерности объединения PoolSize.

Больше о

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

Введенный в R2019a

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