评价此页

torch.Tensor.register_hook#

Tensor.register_hook(hook)[source]#

注册一个反向钩子。

该钩子将在每次计算 Tensor 的梯度时被调用。钩子应具有以下签名

hook(grad) -> Tensor or None

钩子不应修改其参数,但可以选择返回一个新梯度,该梯度将用于替换 grad

此函数返回一个句柄,其中包含一个方法 handle.remove(),用于从模块中移除该钩子。

注意

有关此钩子何时执行以及其执行顺序相对于其他钩子的更多信息,请参阅 Backward Hooks execution

示例

>>> v = torch.tensor([0., 0., 0.], requires_grad=True)
>>> h = v.register_hook(lambda grad: grad * 2)  # double the gradient
>>> v.backward(torch.tensor([1., 2., 3.]))
>>> v.grad

 2
 4
 6
[torch.FloatTensor of size (3,)]

>>> h.remove()  # removes the hook