.. index:: pair: page; ConvolutionBackwardWeights
.. _doxid-dev_guide_op_convolutionbackwardweights:

ConvolutionBackwardWeights
==========================

General
~~~~~~~

ConvolutionBackwardWeights operation accepts :math:`\src`, :math:`\diffdst` and optional weights shape as inputs, and compute the :math:`\diffweights`.

Operation attributes
~~~~~~~~~~~~~~~~~~~~

===========================================================================================================================  ============================================================================================================================================================================================================  =======  =====================================================================  =========  
Attribute Name                                                                                                               De                                                                                                                                                                                                            
===========================================================================================================================  ============================================================================================================================================================================================================  =======  =====================================================================  =========  
:ref:`strides <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684a3372f3d8ac7d6db0997a8fe6b38d549a>`          Controls the strides the weights tensor is moved when computing convolution.                                                                                                                                  s64      A s64 list containing positive values                                  Required   
:ref:`pads_begin <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684ad9563b69290681059378cb6b98127310>`       Controls number of zeros to be add to the front/top/left of spatial dimensions, the attribute will be ignored when ``auto_pad`` attribute is specified to ``same_upper`` , ``same_lower`` or ``valid`` .      s64      A s64 list containing non-negative values                              Required   
:ref:`pads_end <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684ae9dcd3256fd8b6e2b6385091cffe2cd6>`         Controls number of zeros to be add to the back/bottom/right of spatial dimensions, the attribute will be ignored when ``auto_pad`` attribute is specified to ``same_upper`` , ``same_lower`` or ``valid`` .   s64      A s64 list containing non-negative values                              Required   
:ref:`dilations <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684acbcf9c952f6e423b94fe04593665b49e>`        Controls the amount of stretching the kernel before convolution ( `visualization link <https://github.com/vdumoulin/conv_arithmetic/blob/master/README.md#dilated-convolution-animations>`__ ).               s64      A s64 list containing positive values (>1 means dilated convolution)   Required   
:ref:`auto_pad <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684a9a6ac749896e044fe3122bd98e44ac9b>`         Controls how the padding is calculated.                                                                                                                                                                       string   ``none`` (default), ``same_upper`` , ``same_lower`` , ``valid``        Optional   
:ref:`groups <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684a1471e4e05a4db95d353cc867fe317314>`           Controls how input channels and output channels are divided into.                                                                                                                                             s64      A positive s64 value, ``1`` by default                                 Optional   
:ref:`data_format <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684a4abbd547d2eb3887fd8613bb8be33cc5>`      Controls how to interpret the shape of ``src`` and ``dst`` .                                                                                                                                                  string   ``NCX`` , ``NXC`` (default)                                            Optional   
:ref:`weights_format <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684a51c305464b90b1e5e4092ccfb5e904a7>`   Controls how to interpret the shape of ``weights`` .                                                                                                                                                          string   ``OIX`` , ``XIO`` (default)                                            Optional   
:ref:`weights_shape <doxid-classdnnl_1_1graph_1_1op_1ac7650c0c15849338f9c558f53ce82684a62793d74da7cb2cac94dc9e5d7516151>`    Denotes the shape of the ``weights`` tensor.                                                                                                                                                                  s64      A s64 list containing positive values                                  Optional   
===========================================================================================================================  ============================================================================================================================================================================================================  =======  =====================================================================  =========

Execution arguments
~~~~~~~~~~~~~~~~~~~

The inputs and outputs must be provided according to below index order when constructing an operation.

Inputs
------

======  ==================  =========  
Index   Argu                
======  ==================  =========  
0       ``src``             Required   
1       ``diff_dst``        Required   
2       ``weights_shape``   Optional   
======  ==================  =========

.. note:: 

   The shape of :math:`\weights` is :math:`(out\_channels, in\_channels / groups, spatial\_shape)` for ``OIX`` format or :math:`(spatial\_shape, in\_channels / groups, out\_channels)` for ``XIO`` format. Both :math:`in\_channels` and :math:`out\_channels` must be divisible by groups attribute.
   
   
Note Either ``weights_shape`` input or ``weights_shape`` attribute should be provided. If both provided, ``weights_shape`` input will precede over ``weights_shape`` attribute.

Outputs
-------

======  =================  =========  
Index   Argu               
======  =================  =========  
0       ``diff_weights``   Required   
======  =================  =========

Supported data types
~~~~~~~~~~~~~~~~~~~~

ConvolutionBackwardWeights operation supports the following data type combinations.

=====  ========  =====  ====  
Src    Diff_ds   
=====  ========  =====  ====  
f32    f32       f32    s32   
bf16   bf16      bf16   s32   
f16    f16       f16    s32   
=====  ========  =====  ====

