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 与当前 Tensor 具有相同的 torch.dtype 和 torch.device 。

参数:

fill_value（标量）- 用此数字填充输出张量。

关键字参数:

• dtype（ torch.dtype ，可选）- 返回张量的期望类型。默认：如果为 None，则与该张量相同 torch.dtype 。

• device（ torch.device ，可选）- 返回张量的期望设备。默认：如果为 None，则与该张量相同 torch.device 。

• requires_grad (bool，可选) – 如果 autograd 应记录对返回张量的操作。默认： False 。

• layout ( torch.layout ，可选) – 返回 Tensor 的期望布局。默认： torch.strided 。

• pin_memory (bool，可选) – 如果设置，返回的张量将在固定内存中分配。仅适用于 CPU 张量。默认： 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)