pytorch / 2 / generated / torch.nn.zeropad2d.html

ZeroPad2d

class torch.nn.ZeroPad2d(padding) [source]

Pads the input tensor boundaries with zero.

For N-dimensional padding, use torch.nn.functional.pad().

Parameters

padding (int, tuple) – the size of the padding. If is int, uses the same padding in all boundaries. If a 4-tuple, uses ( padding_left \text{padding\_left} , padding_right \text{padding\_right} , padding_top \text{padding\_top} , padding_bottom \text{padding\_bottom} )

Shape:
  • Input: ( N , C , H i n , W i n ) (N, C, H_{in}, W_{in}) or ( C , H i n , W i n ) (C, H_{in}, W_{in}) .
  • Output: ( N , C , H o u t , W o u t ) (N, C, H_{out}, W_{out}) or ( C , H o u t , W o u t ) (C, H_{out}, W_{out}) , where

    H o u t = H i n + padding_top + padding_bottom H_{out} = H_{in} + \text{padding\_top} + \text{padding\_bottom}

    W o u t = W i n + padding_left + padding_right W_{out} = W_{in} + \text{padding\_left} + \text{padding\_right}

Examples:

>>> m = nn.ZeroPad2d(2)
>>> input = torch.randn(1, 1, 3, 3)
>>> input
tensor([[[[-0.1678, -0.4418,  1.9466],
          [ 0.9604, -0.4219, -0.5241],
          [-0.9162, -0.5436, -0.6446]]]])
>>> m(input)
tensor([[[[ 0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000],
          [ 0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000],
          [ 0.0000,  0.0000, -0.1678, -0.4418,  1.9466,  0.0000,  0.0000],
          [ 0.0000,  0.0000,  0.9604, -0.4219, -0.5241,  0.0000,  0.0000],
          [ 0.0000,  0.0000, -0.9162, -0.5436, -0.6446,  0.0000,  0.0000],
          [ 0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000],
          [ 0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000,  0.0000]]]])
>>> # using different paddings for different sides
>>> m = nn.ZeroPad2d((1, 1, 2, 0))
>>> m(input)
tensor([[[[ 0.0000,  0.0000,  0.0000,  0.0000,  0.0000],
          [ 0.0000,  0.0000,  0.0000,  0.0000,  0.0000],
          [ 0.0000, -0.1678, -0.4418,  1.9466,  0.0000],
          [ 0.0000,  0.9604, -0.4219, -0.5241,  0.0000],
          [ 0.0000, -0.9162, -0.5436, -0.6446,  0.0000]]]])

© 2024, PyTorch Contributors
PyTorch has a BSD-style license, as found in the LICENSE file.
https://pytorch.org/docs/2.1/generated/torch.nn.ZeroPad2d.html