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 的 Tensor，並以 fill_value 填充。 預設情況下，返回的 Tensor 具有與此 tensor 相同的 torch.dtype 和 torch.device 。

參數

fill_value (純量) – 用於填充輸出 tensor 的數字。

關鍵字參數

• dtype (torch.dtype, optional) – 返回的 tensor 的期望類型。預設值：如果為 None，則與此 tensor 的 torch.dtype 相同。

• device (torch.device, optional) – 返回的 tensor 的期望裝置。預設值：如果為 None，則與此 tensor 的 torch.device 相同。

• requires_grad (bool, optional) – 如果 autograd 應該記錄返回的 tensor 上的操作。預設值：False。

• layout (torch.layout, optional) – 返回的 Tensor 的期望佈局。預設值：torch.strided。

• pin_memory (bool, optional) – 如果設定，返回的 tensor 將分配在 pinned memory 中。僅適用於 CPU tensors。預設值：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)