torch.nn.utils.prune.custom_from_mask

torch.nn.utils.prune.custom_from_mask(module, name, mask)

通过应用预先计算的 mask 来修剪 module 中名为 name 的参数对应的张量。

通过以下方式原地修改模块（并返回修改后的模块）：

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

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

参数

• module (nn.Module) – module containing the tensor to prune

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

• mask (Tensor) – 将应用于参数的二元掩码。

返回

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

返回类型

module (nn.Module)

示例

>>> from torch.nn.utils import prune
>>> m = prune.custom_from_mask(
...     nn.Linear(5, 3), name="bias", mask=torch.tensor([0, 1, 0])
... )
>>> print(m.bias_mask)
tensor([0., 1., 0.])