torch.empty_strided

torch.empty_strided(size, stride, *, dtype=None, layout=None, device=None, requires_grad=False, pin_memory=False) → Tensor

创建一个具有指定 size 和 stride 并用未定义数据填充的张量。

警告

如果构造的张量是“重叠的”（有多个索引指向内存中的同一个元素），则其行为是未定义的。

注意

如果 torch.use_deterministic_algorithms() 和 torch.utils.deterministic.fill_uninitialized_memory 都设置为 True，则输出张量将被初始化，以防止因将数据用作操作输入而导致的任何可能的不确定性行为。浮点和复数张量将填充 NaN，整数张量将填充最大值。

参数

• size (tuple of int) – 输出张量的形状

• stride (tuple of int) – 输出张量的步幅

关键字参数

• dtype (torch.dtype, 可选) – 返回张量所需的数据类型。默认值：如果为 None，则使用全局默认值（参见 torch.set_default_dtype()）。

• layout (torch.layout, 可选) – 返回张量所需的布局。默认值：torch.strided。

• device (torch.device, 可选) – 返回张量所需的设备。默认值：如果为 None，则使用默认张量类型的当前设备（参见 torch.set_default_device()）。device 对于 CPU 张量类型将是 CPU，对于 CUDA 张量类型将是当前的 CUDA 设备。

• requires_grad (bool, 可选) – 如果自动求导应记录返回张量上的操作。默认值：False。

• pin_memory (bool, 可选) – 如果设置，返回的张量将分配在锁定内存中。仅适用于 CPU 张量。默认值：False。

示例

>>> a = torch.empty_strided((2, 3), (1, 2))
>>> a
tensor([[8.9683e-44, 4.4842e-44, 5.1239e+07],
        [0.0000e+00, 0.0000e+00, 3.0705e-41]])
>>> a.stride()
(1, 2)
>>> a.size()
torch.Size([2, 3])