| MPSCNNPoolingAverageGradient(3) | MetalPerformanceShaders.framework | MPSCNNPoolingAverageGradient(3) |
MPSCNNPoolingAverageGradient
#import <MPSCNNPooling.h>
Inherits MPSCNNPoolingGradient.
(nonnull instancetype) -
initWithDevice:kernelWidth:kernelHeight:strideInPixelsX:strideInPixelsY:
(nullable instancetype) - initWithCoder:device:
NSUInteger zeroPadSizeX
NSUInteger zeroPadSizeY
This depends on Metal.framework Specifies the filter for computing the gradient of the average pooling filter. The operation backpropagates a gradient vector using chain rule.
Average pooling forward pass is defined as:
out(x) = sum_{dx in Window(x)} in(s*x+dx) / N(x), where
the pooling window definition 'Window(x)' follows MPSCNNPooling specification, 'N(x)' is effective pooling window size in pixels as specified in MPSCNNPoolingAverage, 's' is the pixel stride and in() is the source input image.
Hence the partial derivative of the output value wrt. to the input value needed in the gradient backpropagation in MPSCNNPoolingGradient is:
d out(x)/d in(y) = sum_{dx in Window(x)} delta_{s*x+dx, y} / N(x), where
delta_{x,y} is the Kronecker delta symbol for which
delta_{x,y} = { 1, when x == y
{ 0, otherwise.
In practice this means that the gradient value for the destination image at pixel 'x' is the sum over these contributions coming from all pooling windows that contribute to the average pooling computation in the forward pass, multiplied by the input gradient value in the source area of the corresponding pooling window.
Note: As average pooling is a linear operation of its inputs, the gradient does not depend at all on the original input values, but the original input image size is needed so that we know the limits where the input values seize to exist to inhibit accumulation of gradient values for those pixels. Therefore, as secondary input, any correctly sized image will produce correct results for the gradient backpropagation and hence it is recommended to use a temporary image of correct size (see MPSTemporaryImage) for the secondary source image parameter.
NSSecureCoding compatability See MPSKernel::initWithCoder.
Parameters:
Returns:
Reimplemented from MPSCNNPoolingGradient.
Initialize a gradient average pooling filter
Parameters:
Returns:
Reimplemented from MPSCNNPoolingGradient.
How much zero padding to apply to both left and right borders of the input image for average pooling, when using
See also:
edgeMode MPSImageEdgeModeZero this property is ignored and the area outside the image is interpreted to contain zeros. The zero padding size is used to shrink the pooling window to fit inside the area bound by the source image and its padding region, but the effect is that the normalization factor of the average computation is computed also for the zeros in the padding region.
How much zero padding to apply to both top and bottom borders of the input image for average pooling, when using
See also:
edgeMode MPSImageEdgeModeZero this property is ignored and the area outside the image is interpreted to contain zeros. The zero padding size is used to shrink the pooling window to fit inside the area bound by the source image and its padding region, but the effect is that the normalization factor of the average computation is computed also for the zeros in the padding region.
Generated automatically by Doxygen for MetalPerformanceShaders.framework from the source code.
| Mon Jul 9 2018 | Version MetalPerformanceShaders-119.3 |