torch.nn.utils.prune.custom_from_mask

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

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

在原地对 module 进行修改（并返回修改后的 module）：

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

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

参数:

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

• 名称（str）- 在 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.])