.. _l-onnx-op-groupnormalization-d18-21:

GroupNormalization - 18 vs 21
=============================

Next section compares an older to a newer version of the same operator 
after both definition are converted into markdown text.
Green means an addition to the newer version, red means a deletion.
Anything else is unchanged.

.. raw:: html


    <div id="div_GroupNormalization_2"></div>
    <link rel="stylesheet" type="text/css" href="../_static/diff2html.min.css" />
    <script type="text/javascript" src="../_static/diff2html-ui-slim.min.js"></script>
    <script>
    const diffString = `
    --- a/GroupNormalization18
    +++ b/GroupNormalization21
    @@ -1 +1 @@
      A GroupNormalization function. Carries out group normalization as described in
      the paper https://arxiv.org/abs/1803.08494
  
      This operator transforms input according to
  
      y = scale * (x - mean) / sqrt(variance + epsilon) + bias,
  
      where the mean and variance are computed per instance per group of channels, and
      scale and bias should be specified for each group of channels. The number of
      groups num_groups should be divisible by the number of channels so that there are
      an equal number of channels per group.
    + 
    + The overall computation has two stages: the first stage normalizes the elements to
    + have zero mean and unit variance for each instance in each group, and the second
    + stage scales and shifts the results of the first stage. The floating-point precision
    + used in the first stage is determined by the stash_type attribute. For example,
    + if stash_type is 1, the operator casts all input variables to 32-bit float,
    + performs the computation, and finally casts the normalized results back to the
    + original type of X. The second stage does not depend on stash_type.
  
      When the number of groups is the same as the number of channels, this operator is
      equivalent to InstanceNormalization. When there is only one group, this operator
      is equivalent to LayerNormalization.
  
      ### Attributes
  
      * **epsilon - FLOAT** (default is '1e-05'):
  
        The epsilon value to use to avoid division by zero.
  
      * **num_groups - INT** (required) :
  
        The number of groups of channels. It should be a divisor of the number of channels C.
  
    + * **stash_type - INT** (default is '1'):
    + 
    +   The floating-point precision used in stage one of the computation.
    + 
      ### Inputs
  
      - **X** (heterogeneous) - **T**:
  
        Input data tensor. Dimensions for image cases are (N x C x H x W), where N is the batch size, C is the number of channels, and H and W are the height and width of the data. Statistics are computed for every group of channels over C, H, and W. For non-image cases, the dimensions are in the form of (N x C x D1 x D2 ... Dn).
      - **scale** (heterogeneous) - **T**:
  
    -   Scale tensor of shape (num_groups).
    ?                          ^^^^^^^^^^
    +   Scale tensor of shape (C).
    ?                          ^
      - **bias** (heterogeneous) - **T**:
  
    -   Bias tensor of shape (num_groups).
    ?                         ^^^^^^^^^^
    +   Bias tensor of shape (C).
    ?                         ^
  
      ### Outputs
  
      - **Y** (heterogeneous) - **T**:
  
        The output tensor of the same shape as X.
  
      ### Type Constraints
  
      * **T** in ( tensor(bfloat16), tensor(double), tensor(float), tensor(float16) ):
  
        Constrain input and output types to float tensors.
    `;

    document.addEventListener('DOMContentLoaded', function () {
    var targetElement = document.getElementById('div_GroupNormalization_2');
    var configuration = {
        drawFileList: true,
        fileListToggle: false,
        fileListStartVisible: false,
        fileContentToggle: false,
        matching: 'lines',
        outputFormat: 'line-by-line',
        synchronisedScroll: true,
        highlight: true,
        renderNothingWhenEmpty: false,
    };
    var diff2htmlUi = new Diff2HtmlUI(targetElement, diffString, configuration);
    diff2htmlUi.draw();
    diff2htmlUi.highlightCode();
    });
    </script>