openvino/docs/ops/pooling/AvgPool_1.md

AvgPool

Versioned name: AvgPool-1

Category: Pooling

Short description: Reference

Detailed description: Reference

Attributes: Pooling attributes are specified in the data node, which is a child of the layer node.

• strides

  • Description: strides is a distance (in pixels) to slide the window on the feature map over the (z, y, x) axes for 3D poolings and (y, x) axes for 2D poolings. For example, strides equal "4,2,1" means sliding the window 4 pixel at a time over depth dimension, 2 over height dimension and 1 over width dimension.
  • Range of values: integer values starting from 0
  • Type: int[]
  • Default value: None
  • Required: yes

• pads_begin

  • Description: pads_begin is a number of pixels to add to the beginning along each axis. For example, pads_begin equal "1,2" means adding 1 pixel to the top of the input and 2 to the left of the input.
  • Range of values: integer values starting from 0
  • Type: int[]
  • Default value: None
  • Required: yes
  • Note: the attribute is ignored when auto_pad attribute is specified.

• pads_end

  • Description: pads_end is a number of pixels to add to the ending along each axis. For example, pads_end equal "1,2" means adding 1 pixel to the bottom of the input and 2 to the right of the input.
  • Range of values: integer values starting from 0
  • Type: int[]
  • Default value: None
  • Required: yes
  • Note: the attribute is ignored when auto_pad attribute is specified.

• kernel

  • Description: kernel is a size of each filter. For example, kernel equal (2, 3) means that each filter has height equal to 2 and width equal to 3.
  • Range of values: integer values starting from 1
  • Type: int[]
  • Default value: None
  • Required: yes

• exclude_pad

  • Description: exclude_pad is a type of pooling strategy for values in the padding area. For example, if exclude_pad is "true", zero-values in the padding are not used.
  • Range of values: True or False
  • Type: boolean
  • Default value: None
  • Required: yes

• rounding_type

  • Description: rounding_type is a type of rounding to be applied.
  • Range of values:
    • ceil
    • floor
  • Type: string
  • Default value: floor

• auto_pad

  • Description: auto_pad how the padding is calculated. Possible values:
    • None (not specified): use explicit padding values.
    • same_upper (same_lower) the input is padded to match the output size. In case of odd padding value an extra padding is added at the end (at the beginning).
    • valid - do not use padding.
  • Type: string
  • Default value: None
  • Required: no
  • Note: pads_begin and pads_end attributes are ignored when auto_pad is specified.

Inputs:

• 1: 4D or 5D input tensor. Required.

Mathematical Formulation

\f[
output_{j} = \frac{\sum_{i = 0}^{n}x_{i}}{n}
\f]

Example

<layer ... type="AvgPool" ... >
        <data auto_pad="same_upper" exclude_pad="true" kernel="3,3" pads_begin="0,0" pads_end="1,1" strides="2,2"/>
        <input> ... </input>
        <output> ... </output>
</layer>