torch.Tensor.new_full

Tensor.new_full(size, fill_value, *, dtype=None, device=None, requires_grad=False, layout=torch.strided, pin_memory=False) → Tensor

返回一个大小为 size，并用 fill_value 填充的 Tensor。默认情况下，返回的 Tensor 的 torch.dtype 和 torch.device 与此 Tensor 相同。

参数

fill_value (scalar) – 用于填充输出 Tensor 的数值。

关键字参数

• dtype (torch.dtype, optional) – 所需的返回 Tensor 的类型。默认值：如果为 None，则与此 Tensor 相同。

• device (torch.device, optional) – 所需的返回 Tensor 的设备。默认值：如果为 None，则与此 Tensor 相同。

• requires_grad (bool, optional) – 如果 autograd 应记录返回 Tensor 上的操作。默认值：False。

• layout (torch.layout, optional) – 所需的返回 Tensor 的布局。默认值：torch.strided。

• pin_memory (bool, optional) – 如果设置为 True，返回的 Tensor 将在固定内存中分配。仅对 CPU Tensor 有效。默认值：False。

示例

>>> tensor = torch.ones((2,), dtype=torch.float64)
>>> tensor.new_full((3, 4), 3.141592)
tensor([[ 3.1416,  3.1416,  3.1416,  3.1416],
        [ 3.1416,  3.1416,  3.1416,  3.1416],
        [ 3.1416,  3.1416,  3.1416,  3.1416]], dtype=torch.float64)