文档反馈

问题文档片段

问题文档片段包含公式时,显示为空格。

提交类型
issue

有点复杂...

找人问问吧。

PR

小问题,全程线上修改...

一键搞定!

请选择提交类型

问题类型
规范和低错类

- 规范和低错类:

- 错别字或拼写错误,标点符号使用错误、公式错误或显示异常。

- 链接错误、空单元格、格式错误。

- 英文中包含中文字符。

- 界面和描述不一致,但不影响操作。

- 表述不通顺,但不影响理解。

- 版本号不匹配:如软件包名称、界面版本号。

易用性

- 易用性:

- 关键步骤错误或缺失,无法指导用户完成任务。

- 缺少主要功能描述、关键词解释、必要前提条件、注意事项等。

- 描述内容存在歧义指代不明、上下文矛盾。

- 逻辑不清晰,该分类、分项、分步骤的没有给出。

正确性

- 正确性:

- 技术原理、功能、支持平台、参数类型、异常报错等描述和软件实现不一致。

- 原理图、架构图等存在错误。

- 命令、命令参数等错误。

- 代码片段错误。

- 命令无法完成对应功能。

- 界面错误,无法指导操作。

- 代码样例运行报错、运行结果不符。

风险提示

- 风险提示:

- 对重要数据或系统存在风险的操作,缺少安全提示。

内容合规

- 内容合规:

- 违反法律法规,涉及政治、领土主权等敏感词。

- 内容侵权。

问题描述

请勾选同意隐私声明

mindspore.experimental.optim.SGD

查看源文件
class mindspore.experimental.optim.SGD(params, lr, momentum=0, dampening=0, weight_decay=0.0, nesterov=False, *, maximize=False)[源代码]

随机梯度下降算法。

vt+1=uvt+gradient(1dampening)

如果nesterov为True:

pt+1=ptlr(gradient+uvt+1)

如果nesterov为False:

pt+1=ptlrvt+1

需要注意的是,对于训练的第一步 vt+1=gradient。其中,p、v和u分别表示 parametersaccummomentum

警告

这是一个实验性的优化器接口,需要和 LRScheduler 下的动态学习率接口配合使用。

参数:
  • params (Union[list(Parameter), list(dict)]) - 网络参数的列表或指定了参数组的列表。

  • lr (Union[int, float, Tensor]) - 学习率。

  • momentum (Union[int, float], 可选) - 动量值。默认值:0

  • weight_decay (float, 可选) - 权重衰减(L2 penalty),必须大于等于0。默认值:0.

  • dampening (Union[int, float], 可选) - 动量的阻尼值。默认值:0

  • nesterov (bool, 可选) - 启用Nesterov动量。如果使用Nesterov,动量必须为正,阻尼必须等于0.0。默认值:False

关键字参数:
  • maximize (bool, 可选) - 是否根据目标函数最大化网络参数。默认值:False

输入:
  • gradients (tuple[Tensor]) - 网络权重的梯度。

异常:
  • ValueError - 学习率不是int、float或Tensor。

  • ValueError - 学习率小于0。

  • ValueError - momentumweight_decay 值小于0.0。

  • ValueError - momentum, dampeningweight_decay 不是int或float。

  • ValueError - nesterovmaximize 不是布尔类型。

  • ValueError - nesterov 为True时, momentum 不为正或 dampening 不为0。

支持平台:

Ascend GPU CPU

样例:

>>> import mindspore
>>> from mindspore import nn
>>> from mindspore.experimental import optim
>>> # Define the network structure of LeNet5. Refer to
>>> # https://gitee.com/mindspore/docs/blob/master/docs/mindspore/code/lenet.py
>>> net = LeNet5()
>>> loss_fn = nn.SoftmaxCrossEntropyWithLogits(sparse=True)
>>> optimizer = optim.SGD(net.trainable_params(), lr=0.1)
>>> def forward_fn(data, label):
...     logits = net(data)
...     loss = loss_fn(logits, label)
...     return loss, logits
>>> grad_fn = mindspore.value_and_grad(forward_fn, None, optimizer.parameters, has_aux=True)
>>> def train_step(data, label):
...     (loss, _), grads = grad_fn(data, label)
...     optimizer(grads)
...     return loss