torch.autograd.backward¶
- torch.autograd.backward(tensors, grad_tensors=None, retain_graph=None, create_graph=False, grad_variables=None, inputs=None)[源码][源码]¶
计算给定张量对图叶节点的梯度总和。
图使用链式法则进行微分。如果
tensors
中的任何张量是非标量(即其数据包含多个元素)且需要梯度,则会计算雅可比向量积。在这种情况下,该函数还需要指定grad_tensors
。它应该是一个长度匹配的序列,包含雅可比向量积中的“向量”,通常是微分函数相对于相应张量的梯度(对于所有不需要梯度张量的张量,None
是可接受的值)。此函数在叶节点中累积梯度 - 在调用它之前,您可能需要将
.grad
属性清零或将其设置为None
。有关累积梯度的内存布局的详细信息,请参阅 默认梯度布局。注意
使用
create_graph=True
调用此方法会在参数及其梯度之间产生一个引用循环,这可能导致内存泄漏。我们建议在创建图时使用autograd.grad
来避免此问题。如果您必须使用此函数,请务必在使用后将参数的.grad
字段重置为None
,以打破循环并避免泄漏。注意
如果您在用户指定的 CUDA 流上下文中运行任何前向操作,创建
grad_tensors
,和/或调用backward
,请参阅 后向传播的流语义。注意
当提供了
inputs
并且给定的输入不是叶节点时,当前实现将调用其 grad_fn(即使获取这些梯度并不严格需要这样做)。这是一个实现细节,用户不应依赖它。更多详细信息请参阅 https://github.com/pytorch/pytorch/pull/60521#issuecomment-867061780。- 参数
tensors (Sequence[Tensor] 或 Tensor 或 Sequence[GradientEdge] 或 GradientEdge) – 将计算导数的张量。
grad_tensors (Sequence[Tensor 或 None] 或 Tensor, 可选) – 雅可比向量积中的“向量”,通常是相对于相应张量中每个元素的梯度。对于标量张量或不需要梯度的张量,可以指定 None 值。如果对于所有 grad_tensors 都可以接受 None 值,则此参数是可选的。
retain_graph (bool, 可选) – 如果为
False
,用于计算梯度的图将被释放。请注意,在几乎所有情况下,将此选项设置为True
都是不必要的,并且通常可以通过更高效的方式解决。默认为create_graph
的值。create_graph (bool, 可选) – 如果为
True
,将构建导数的图,从而允许计算更高阶导数积。默认为False
。inputs (Sequence[Tensor] 或 Tensor 或 Sequence[GradientEdge], 可选) – 将梯度累积到
.grad
的输入张量。所有其他张量将被忽略。如果未提供,梯度将累积到用于计算tensors
的所有叶节点张量中。