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
的张量。默认情况下,返回的张量与该张量具有相同的torch.dtype
和torch.device
。- 参数
fill_value (标量) – 用于填充输出张量的数字。
- 关键字参数
dtype (
torch.dtype
, 可选) – 返回张量的所需类型。默认值:如果为 None,则与该张量具有相同的torch.dtype
。device (
torch.device
, 可选) – 返回张量的所需设备。默认值:如果为 None,则与该张量具有相同的torch.device
。requires_grad (bool, 可选) – 是否应记录返回张量上的操作。默认值:
False
。layout (
torch.layout
, 可选) – 返回张量的所需布局。默认值: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)