torch.nn.utils.prune.identity

torch.nn.utils.prune.identity(module, name)

应用剪枝重参数化，但不对任何单元进行实际剪枝。

通过以下方式，对 module 中名为 name 的张量应用剪枝重参数化，而不实际剪枝任何单元。修改 module（并返回修改后的 module）：

1. 添加一个名为 name+'_mask' 的命名缓冲区，对应于剪枝方法应用于参数 name 的二值掩码。

2. 用剪枝后的版本替换参数 name，同时将原始（未剪枝）参数存储在一个名为 name+'_orig' 的新参数中。

注意

掩码是一个全为 1 的张量。

参数

• module (nn.Module) – 包含要剪枝张量的模块。

• name (str) – 在 module 中执行剪枝操作的参数名称。

返回

模块的修改（即剪枝）后的版本

返回类型

module (nn.Module)

示例

>>> m = prune.identity(nn.Linear(2, 3), "bias")
>>> print(m.bias_mask)
tensor([1., 1., 1.])