torch_npu.optim.NpuFusedSGD

产品支持情况

产品	是否支持
[object Object]Atlas A3 训练系列产品[object Object]	√
[object Object]Atlas A2 训练系列产品[object Object]	√
[object Object]Atlas 训练系列产品[object Object]	√

功能说明

通过张量融合实现的高性能SGD优化器，核心功能和torch.optim.SGD兼容。

SGD的功能和原理可参考。

函数原型

参数说明

• params (dict)：必选参数，模型参数或模型参数组，params为参数的可迭代对象或参数组的dict类型。
• lr (float)：必选参数，学习率。lr不配置或值小于0时，打印“ValueError”异常信息。
• momentum (float)：可选参数，动量系数，默认值为0。momentum小于0时，打印“ValueError”异常信息。
• dampening (float)：可选参数，动量的抑制系数，默认值为0。
• weight_decay (float)：可选参数，权重衰减，默认值为0。weight_decay小于0时，打印“ValueError”异常信息。
• nesterov (bool)：可选参数，是否使用Nesterov动量，默认值为False。nesterov为True，同时momentum小于0或者dampening不等于0，打印“TypeError”异常信息。

返回值说明

类型为NpuFusedSGD的对象。

约束说明

NpuFusedSGD的实现机制要求params中的每一个模型参数对象在使用过程中不能被重新申请，否则将导致无法预料的结果。引起模型参数对象被重新申请的操作包括但不限于：

• 将模型或其子Module进行.cpu()操作
• 将模型参数对象指向新的对象
• 将模型参数对象置为None

对模型参数对象进行inplace计算，或者读取参数的值，NpuFusedSGD可正常工作。

调用示例