inference_mode¶
- 类 torch.autograd.grad_mode.inference_mode(mode=True)[源代码][源代码]¶
用于启用或禁用推理模式的上下文管理器。
InferenceMode 是一个上下文管理器,类似于
no_grad
,用于当你确定你的操作不会与 autograd 交互时(例如,模型训练)。在此模式下运行的代码通过禁用视图跟踪和版本计数器更新来获得更好的性能。请注意,与一些其他局部启用或禁用梯度的机制不同,进入 inference_mode 也会禁用 正向模式 AD。这个上下文管理器是线程本地的;它不会影响其他线程中的计算。
也可作为装饰器使用。
注意
推理模式是几种可以局部启用或禁用梯度的机制之一,参见 局部禁用梯度计算 以了解更多关于它们之间比较的信息。
- 参数
mode (布尔值 或 函数) – 一个布尔标志,用于启用或禁用推理模式,或一个要用推理模式启用的 Python 函数
- 示例:
>>> import torch >>> x = torch.ones(1, 2, 3, requires_grad=True) >>> with torch.inference_mode(): ... y = x * x >>> y.requires_grad False >>> y._version Traceback (most recent call last): File "<stdin>", line 1, in <module> RuntimeError: Inference tensors do not track version counter. >>> @torch.inference_mode() ... def func(x): ... return x * x >>> out = func(x) >>> out.requires_grad False >>> @torch.inference_mode() ... def doubler(x): ... return x * 2 >>> out = doubler(x) >>> out.requires_grad False