permute_channels¶
- torchvision.transforms.v2.functional.permute_channels(inpt: Tensor, permutation: List[int]) Tensor [源代码]¶
根据给定的置换调整输入的通道顺序。
此函数支持普通的
Tensor
、PIL.Image.Image
,以及torchvision.tv_tensors.Image
和torchvision.tv_tensors.Video
。示例
>>> rgb_image = torch.rand(3, 256, 256) >>> bgr_image = F.permute_channels(rgb_image, permutation=[2, 1, 0])
- 参数:
permutation (List[int]) –
输入通道索引的有效置换。列表中元素的索引决定输入中的通道索引,值决定输出中的通道索引。例如,
permutation=[2, 0 , 1]
会取
ìnpt[..., 0, :, :]
并将其放置在output[..., 2, :, :]
,取
ìnpt[..., 1, :, :]
并将其放置在output[..., 0, :, :]
,以及取
ìnpt[..., 2, :, :]
并将其放置在output[..., 1, :, :]
。
- 抛出:
ValueError – 如果
len(permutation)
与输入的通道数不匹配。