torch.nn.utils.parametrizations.weight_norm

torch.nn.utils.parametrizations.weight_norm(module, name='weight', dim=0)

對給定模組中的引數應用權重歸一化。

$$\mathbf{w} = g \dfrac{\mathbf{v}}{\|\mathbf{v}\|}$$

權重歸一化是一種重引數化，它將權重張量的大小與其方向解耦。這將由 name 指定的引數替換為兩個引數：一個指定大小，另一個指定方向。

預設情況下，使用 dim=0 時，範數是獨立計算每個輸出通道/平面的。要計算整個權重張量的範數，請使用 dim=None。

參見 https://arxiv.org/abs/1602.07868

引數

• module (Module) – 包含該引數的模組

• name (str, 可選) – 權重引數的名稱

• dim (int, 可選) – 計算範數的維度

返回值

已應用權重歸一化鉤子的原始模組

示例

>>> m = weight_norm(nn.Linear(20, 40), name='weight')
>>> m
ParametrizedLinear(
  in_features=20, out_features=40, bias=True
  (parametrizations): ModuleDict(
    (weight): ParametrizationList(
      (0): _WeightNorm()
    )
  )
)
>>> m.parametrizations.weight.original0.size()
torch.Size([40, 1])
>>> m.parametrizations.weight.original1.size()
torch.Size([40, 20])