no_grad

class torch.no_grad(orig_func=None)

禁用梯度计算的上下文管理器。

禁用梯度计算对于推理非常有用，特别是当你确定不会调用 Tensor.backward() 时。它将减少那些否则会具有 requires_grad=True 的计算的内存消耗。

在此模式下，即使输入具有 requires_grad=True，每次计算的结果也将具有 requires_grad=False。但有一个例外！所有工厂函数，或创建新 Tensor 并接受 requires_grad kwarg 的函数，不受此模式影响。

此上下文管理器是线程本地的；它不会影响其他线程中的计算。

也可作为装饰器使用。

注意

No-grad 是几种可以在本地启用或禁用梯度的机制之一，请参阅 本地禁用梯度计算 以了解更多关于它们的比较信息。

注意

此 API 不适用于 正向模式 AD。如果要禁用计算的正向 AD，可以解包双张量。

示例：

>>> x = torch.tensor([1.], requires_grad=True)
>>> with torch.no_grad():
...     y = x * 2
>>> y.requires_grad
False
>>> @torch.no_grad()
... def doubler(x):
...     return x * 2
>>> z = doubler(x)
>>> z.requires_grad
False
>>> @torch.no_grad()
... def tripler(x):
...     return x * 3
>>> z = tripler(x)
>>> z.requires_grad
False
>>> # factory function exception
>>> with torch.no_grad():
...     a = torch.nn.Parameter(torch.rand(10))
>>> a.requires_grad
True