torch.nn.utils.prune.random_structured

torch.nn.utils.prune.random_structured(module, name, amount, dim)

通过移除指定维度上的随机通道来修剪张量。

通过移除指定 amount 数量的（当前未修剪的）通道（沿着指定的 dim 随机选择），来修剪 module 中名为 name 的参数所对应的张量。通过以下方式原地修改模块（并返回修改后的模块）：

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

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

参数

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

• name (str) – module 中将进行修剪操作的参数名称。

• amount (int 或 float) – 要修剪的参数数量。如果为 float，应介于 0.0 和 1.0 之间，表示要修剪的参数比例。如果为 int，则表示要修剪的参数的绝对数量。

• dim (int) – 定义要修剪通道的维度的索引。

返回

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

返回类型

模块 (nn.Module)

示例

>>> m = prune.random_structured(
...     nn.Linear(5, 3), 'weight', amount=3, dim=1
... )
>>> columns_pruned = int(sum(torch.sum(m.weight, dim=0) == 0))
>>> print(columns_pruned)
3