averagePooling3dLayer

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

Описание

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

Создание

Описание

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', заданного при создании слоя.

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

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

Значение, используемое для заполнения входа, задается как 0 или 'mean'.

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

  • 0 - Вход заполнен нулями в положениях, заданных 'Padding' опция. Заполненные области включаются в расчет среднего значения областей объединения по краям.

  • 'mean' - Вход заполняется средним значением области объединения в положениях, заданных 'Padding' опция. Заполненные области эффективно исключаются из вычисления среднего значения каждой области объединения.

Пример: 'PaddingValue','mean'

Слой

Имя слоя, заданное как вектор символов или строковый скаляр. Чтобы включить слой в график слоев, необходимо задать непустое уникальное имя слоя. Если вы обучаете последовательную сеть с слоем и 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]
    PaddingValue: 0

Включите 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]
    PaddingValue: 0

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

Подробнее о

расширить все

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