- class torchvision.transforms.v2.Resize(size: Union[int, Sequence[int]], interpolation: Union[InterpolationMode, int] = InterpolationMode.BILINEAR, max_size: Optional[int] = None, antialias: Optional[bool] = True)¶
[BETA] Resize the input to the given size.
The Resize transform is in Beta stage, and while we do not expect disruptive breaking changes, some APIs may slightly change according to user feedback. Please submit any feedback you may have in this issue: https://github.com/pytorch/vision/issues/6753.
If the input is a
BoundingBoxesetc.) it can have arbitrary number of leading batch dimensions. For example, the image can have
[..., C, H, W]shape. A bounding box can have
size (sequence or int) –
Desired output size. If size is a sequence like (h, w), output size will be matched to this. If size is an int, smaller edge of the image will be matched to this number. i.e, if height > width, then image will be rescaled to (size * height / width, size).
In torchscript mode size as single int is not supported, use a sequence of length 1:
interpolation (InterpolationMode, optional) – Desired interpolation enum defined by
torchvision.transforms.InterpolationMode. Default is
InterpolationMode.BILINEAR. If input is Tensor, only
InterpolationMode.BICUBICare supported. The corresponding Pillow integer constants, e.g.
PIL.Image.BILINEARare accepted as well.
max_size (int, optional) – The maximum allowed for the longer edge of the resized image. If the longer edge of the image is greater than
max_sizeafter being resized according to
sizewill be overruled so that the longer edge is equal to
max_size. As a result, the smaller edge may be shorter than
size. This is only supported if
sizeis an int (or a sequence of length 1 in torchscript mode).
antialias (bool, optional) –
Whether to apply antialiasing. It only affects tensors with bilinear or bicubic modes and it is ignored otherwise: on PIL images, antialiasing is always applied on bilinear or bicubic modes; on other modes (for PIL images and tensors), antialiasing makes no sense and this parameter is ignored. Possible values are:
True(default): will apply antialiasing for bilinear or bicubic modes. Other mode aren’t affected. This is probably what you want to use.
False: will not apply antialiasing for tensors on any mode. PIL images are still antialiased on bilinear or bicubic modes, because PIL doesn’t support no antialias.
None: equivalent to
Falsefor tensors and
Truefor PIL images. This value exists for legacy reasons and you probably don’t want to use it unless you really know what you are doing.
The default value changed from
Truein v0.17, for the PIL and Tensor backends to be consistent.
Resize:Illustration of transforms