torch.normal()用法
torch.normal()函数,用于生成符合正态分布(高斯分布)的随机数。在 PyTorch 中,这个函数通常用于生成 Tensor。
该函数共有四个方法:
python
@overload
def normal(mean: Tensor, std: Tensor, *, generator: Optional[Generator] = None, out: Optional[Tensor] = None) -> Tensor: ...
@overload
def normal(mean: Tensor, std: _float = 1, *, generator: Optional[Generator] = None, out: Optional[Tensor] = None) -> Tensor: ...
@overload
def normal(mean: _float, std: Tensor, *, generator: Optional[Generator] = None, out: Optional[Tensor] = None) -> Tensor: ...
@overload
def normal(mean: _float, std: _float, size: Sequence[Union[_int, SymInt]], *,
generator: Optional[Generator] = None, out: Optional[Tensor] = None,
dtype: Optional[_dtype] = None, layout: Optional[_layout] = None,
device: Optional[Optional[DeviceLikeType]] = None,
pin_memory: Optional[_bool] = False,
requires_grad: Optional[_bool] = False) -> Tensor: ...
参数解析
- mean: 表示正态分布的均值 (μ)。可以是一个标量,也可以是一个张量,如果是张量,其形状必须与 std 相容。如果 mean 是一个张量,那么函数将生成与 mean 相同形状的随机数张量,并以 mean 中的值作为各个维度的均值。
- std: 表示正态分布的标准差 (σ)。可以是一个标量,也可以是一个张量,如果是张量,其形状必须与 mean 相容。如果 std 是一个张量,那么函数将生成与 std 相同形状的随机数张量,并以 std 中的值作为各个维度的标准差。
- "*" (星号):星号后的参数为关键字参数,只能用关键字指定。
- size:指定生成张量的尺寸。
- generator=None:指定一个随机数生成器。PyTorch 常用 torch.Generator() 创建生成器。如果不指定,使用默认生成器。
- out=None:用于指定输出的 Tensor。如果不提供,函数将返回一个新创建的 Tensor。
返回值
返回一个张量,其形状与 mean 和 std 相同,其中的元素服从均值为 mean,标准差为 std 的正态分布。
使用示例
python
import torch
random_value = torch.normal(mean=0.0, std=1.0, size=(2, 2))
print(random_value)
# 生成一个服从均值0和标准差1的单个随机数
random_value = torch.normal(mean=0, std=1, size=(1,))
print(random_value)
# 生成一个服从均值0和标准差1的张量
mean_tensor = torch.zeros(3, 3) # 均值张量
std_tensor = torch.ones(3, 3) # 标准差张量
random_tensor = torch.normal(mean_tensor, std_tensor)
print(random_tensor)
# 使用指定生成器生成随机数
generator = torch.Generator().manual_seed(42)
random_value_with_generator = torch.normal(mean=0.0, std=1.0, size=(2, 2), generator=generator)
print(random_value_with_generator)
# 输出到指定Tensor
out_tensor = torch.empty(3, 3)
torch.normal(mean_tensor, std_tensor, out=out_tensor)
print(out_tensor)
以上是 torch.normal() 函数的基本用法。可以根据具体需求调整 mean 和 std 的值来生成不同形状、不同均值和标准差的正态分布随机数。