torch.Size#

创建日期：2024 年 4 月 19 日 | 最后更新日期：2025 年 6 月 18 日

torch.Size 是调用 torch.Tensor.size() 的结果类型。它描述了原始张量所有维度的大小。作为 tuple 的子类，它支持常见的序列操作，如索引和长度。

示例

    >>> x = torch.ones(10, 20, 30)
    >>> s = x.size()
    >>> s
    torch.Size([10, 20, 30])
    >>> s[1]
    20
    >>> len(s)
    3

class torch.Size(iterable=(), /)#

index(value, start=0, stop=9223372036854775807, /)#

返回值的第一个索引。

如果值不存在，则引发 ValueError。

numel() → int#

返回给定大小的 torch.Tensor 将包含的元素数量。

更正式地说，对于大小为 s = torch.Size([10, 10]) 的张量 x = tensor.ones(10, 10)，x.numel() == x.size().numel() == s.numel() == 100 为真。

示例

>>> x=torch.ones(10, 10)
>>> s=x.size()
>>> s
torch.Size([10, 10])
>>> s.numel()
100
>>> x.numel() == s.numel()
True

警告

此函数不返回 torch.Size 描述的维度数量，而是返回具有该大小的 torch.Tensor 将包含的元素数量。

文档