torch.nn.utils.prune.identity

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

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

对 module 中名为 name 的参数对应的张量应用剪枝重参数化，但不实际剪除任何单元。该函数会原地修改模块（并返回修改后的模块），具体操作包括：

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

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

注意

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

参数

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

• name (str) – 模块中将要进行剪枝操作的参数名称。

返回

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

返回类型

module (nn.Module)

示例

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