.. index:: pair: struct; dnnl_pooling_v2_desc_t
.. _doxid-structdnnl__pooling__v2__desc__t:

struct dnnl_pooling_v2_desc_t
=============================

.. toctree::
	:hidden:

Overview
~~~~~~~~

A descriptor of a pooling operation. :ref:`More...<details-structdnnl__pooling__v2__desc__t>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <dnnl_types.h>
	
	struct dnnl_pooling_v2_desc_t
	{
		// fields
	
		:ref:`dnnl_primitive_kind_t<doxid-group__dnnl__api__primitives__common_1ga9878f4795e53ad8443e5c0a29e53286a>` :ref:`primitive_kind<doxid-structdnnl__pooling__v2__desc__t_1aa588ccd5e6923c67bc8628652454cb87>`;
		:ref:`dnnl_prop_kind_t<doxid-group__dnnl__api__primitives__common_1gae3c1f22ae55645782923fbfd8b07d0c4>` :ref:`prop_kind<doxid-structdnnl__pooling__v2__desc__t_1a4822b19243e3c917a98504bebbcfdf5b>`;
		:ref:`dnnl_alg_kind_t<doxid-group__dnnl__api__primitives__common_1ga96946c805f6c4922c38c37049ab95d23>` :ref:`alg_kind<doxid-structdnnl__pooling__v2__desc__t_1aaae75a2798a03254de0226da64ee9b98>`;
		:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` :ref:`src_desc<doxid-structdnnl__pooling__v2__desc__t_1a28c9c90697df14b57c8c73d141e6fcf2>`;
		:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` :ref:`diff_src_desc<doxid-structdnnl__pooling__v2__desc__t_1ab1eb745888b2d7e29ea284d6a1458fa5>`;
		:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` :ref:`dst_desc<doxid-structdnnl__pooling__v2__desc__t_1ae4b3b22efb2bcc44ecf0022a31205df9>`;
		:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` :ref:`diff_dst_desc<doxid-structdnnl__pooling__v2__desc__t_1a90a655a14c3614ef72cbe4425a403ce5>`;
		:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` :ref:`strides<doxid-structdnnl__pooling__v2__desc__t_1a4d33f71638bdf76e259f1291ab57e316>`;
		:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` :ref:`kernel<doxid-structdnnl__pooling__v2__desc__t_1a9fadcb50dba6152611ef294be12abd1b>`;
		:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` :ref:`padding<doxid-structdnnl__pooling__v2__desc__t_1abd47bcc772e5cb51b2559d7d2580a872>`[2];
		:ref:`dnnl_data_type_t<doxid-group__dnnl__api__memory_1ga012ba1c84ff24bdd068f9d2f9b26a130>` :ref:`accum_data_type<doxid-structdnnl__pooling__v2__desc__t_1a92b6615be76524cf800856ee63a5672f>`;
		:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` :ref:`dilation<doxid-structdnnl__pooling__v2__desc__t_1a3bf00b2a4349b302d1b51af25424a884>`;
	};
.. _details-structdnnl__pooling__v2__desc__t:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

A descriptor of a pooling operation.

Fields
------

.. index:: pair: variable; primitive_kind
.. _doxid-structdnnl__pooling__v2__desc__t_1aa588ccd5e6923c67bc8628652454cb87:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_primitive_kind_t<doxid-group__dnnl__api__primitives__common_1ga9878f4795e53ad8443e5c0a29e53286a>` primitive_kind

The kind of primitive.

Used for self-identifying the primitive descriptor. Must be :ref:`dnnl_pooling_v2 <doxid-group__dnnl__api__primitives__common_1gga9878f4795e53ad8443e5c0a29e53286aa8e72f7ad7890633f05e49b81287fef42>`.

.. index:: pair: variable; prop_kind
.. _doxid-structdnnl__pooling__v2__desc__t_1a4822b19243e3c917a98504bebbcfdf5b:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_prop_kind_t<doxid-group__dnnl__api__primitives__common_1gae3c1f22ae55645782923fbfd8b07d0c4>` prop_kind

The kind of propagation.

Possible values: :ref:`dnnl_forward_training <doxid-group__dnnl__api__primitives__common_1ggae3c1f22ae55645782923fbfd8b07d0c4a992e03bebfe623ac876b3636333bbce0>`, :ref:`dnnl_forward_inference <doxid-group__dnnl__api__primitives__common_1ggae3c1f22ae55645782923fbfd8b07d0c4a2f77a568a675dec649eb0450c997856d>`, :ref:`dnnl_backward <doxid-group__dnnl__api__primitives__common_1ggae3c1f22ae55645782923fbfd8b07d0c4a326a5e31769302972e7bded555e1cc10>`, and :ref:`dnnl_backward_data <doxid-group__dnnl__api__primitives__common_1ggae3c1f22ae55645782923fbfd8b07d0c4a524dd6cb2ed9680bbd170ba15261d218>`.

.. index:: pair: variable; alg_kind
.. _doxid-structdnnl__pooling__v2__desc__t_1aaae75a2798a03254de0226da64ee9b98:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_alg_kind_t<doxid-group__dnnl__api__primitives__common_1ga96946c805f6c4922c38c37049ab95d23>` alg_kind

The kind of pooling algorithm.

Possible values: :ref:`dnnl_pooling_max <doxid-group__dnnl__api__primitives__common_1gga96946c805f6c4922c38c37049ab95d23acf3529ba1c4761c0da90eb6750def6c7>`, :ref:`dnnl_pooling_avg_include_padding <doxid-group__dnnl__api__primitives__common_1gga96946c805f6c4922c38c37049ab95d23ac13a4cc7c0dc1edfcbf1bac23391d5cb>`, and :ref:`dnnl_pooling_avg_exclude_padding <doxid-group__dnnl__api__primitives__common_1gga96946c805f6c4922c38c37049ab95d23a00156580493fd7c2f4cdbaaf9fcbde79>`.

.. index:: pair: variable; src_desc
.. _doxid-structdnnl__pooling__v2__desc__t_1a28c9c90697df14b57c8c73d141e6fcf2:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` src_desc

Source memory descriptor.

.. index:: pair: variable; diff_src_desc
.. _doxid-structdnnl__pooling__v2__desc__t_1ab1eb745888b2d7e29ea284d6a1458fa5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` diff_src_desc

Source gradient memory descriptor.

.. index:: pair: variable; dst_desc
.. _doxid-structdnnl__pooling__v2__desc__t_1ae4b3b22efb2bcc44ecf0022a31205df9:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` dst_desc

Destination memory descriptor.

.. index:: pair: variable; diff_dst_desc
.. _doxid-structdnnl__pooling__v2__desc__t_1a90a655a14c3614ef72cbe4425a403ce5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_memory_desc_t<doxid-structdnnl__memory__desc__t>` diff_dst_desc

Destination gradient memory descriptor.

.. index:: pair: variable; strides
.. _doxid-structdnnl__pooling__v2__desc__t_1a4d33f71638bdf76e259f1291ab57e316:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` strides

Pooling kernel strides for spatial dimensions.

.. index:: pair: variable; kernel
.. _doxid-structdnnl__pooling__v2__desc__t_1a9fadcb50dba6152611ef294be12abd1b:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` kernel

Pooling kernel spatial dimensions.

.. index:: pair: variable; padding
.. _doxid-structdnnl__pooling__v2__desc__t_1abd47bcc772e5cb51b2559d7d2580a872:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` padding[2]

Padding in each spatial dimension.

padding[0] is a padding in the beginning (``padding_l``), padding[1] is a padding in the end (``padding_r``).

.. index:: pair: variable; accum_data_type
.. _doxid-structdnnl__pooling__v2__desc__t_1a92b6615be76524cf800856ee63a5672f:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_data_type_t<doxid-group__dnnl__api__memory_1ga012ba1c84ff24bdd068f9d2f9b26a130>` accum_data_type

The accumulator data type. Initialized automatically.

.. index:: pair: variable; dilation
.. _doxid-structdnnl__pooling__v2__desc__t_1a3bf00b2a4349b302d1b51af25424a884:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`dnnl_dims_t<doxid-group__dnnl__api__memory_1ga8331e1160e52a5d4babe96736464095a>` dilation

Pooling dilations for spatial dimensions.