Spec-Zone.ru › PyTorch 2.14

L1Loss

class torch.nn.modules.loss.L1Loss(size_average=None, reduce=None, reduction='mean') [source]

Создает функцию потерь, измеряющую среднюю абсолютную ошибку (MAE) между каждым элементом входного тензора xx и целевого тензора yy.

Нередуцированную функцию потерь (то есть с reduction, установленным в 'none') можно описать следующим образом:

ℓ(x,y)=L={l1,…,lN}⊤,ln=∣xn−yn∣,\ell(x, y) = L = \{l_1,\dots,l_N\}^\top, \quad l_n = \left| x_n - y_n \right|,

где NN — размер пакета. Если reduction не равно 'none' (по умолчанию 'mean'), то:

ℓ(x,y)={mean⁡(L),если reduction=‘mean’;sum⁡(L),если reduction=‘sum’.\ell(x, y) = \begin{cases} \operatorname{mean}(L), & \text{if reduction} = \text{`mean';}\\ \operatorname{sum}(L), & \text{if reduction} = \text{`sum'.} \end{cases}

xx и yy — тензоры произвольной формы, каждый из которых содержит в общей сложности NN элементов.

Операция суммирования по-прежнему выполняется по всем элементам с делением на NN.

Деление на NN можно отключить, если установить reduction = 'sum'.

Поддерживаются вещественные и комплексные входные значения.

Параметры:
  • size_average (bool, необязательно) – Устарел (см. reduction). По умолчанию значения функции потерь усредняются по каждому элементу потерь в пакете. Обратите внимание, что для некоторых функций потерь на один образец приходится несколько элементов. Если поле size_average установлено в False, вместо этого значения функции потерь суммируются для каждого мини-пакета. Игнорируется, если reduce равно False. По умолчанию: True
  • reduce (bool, необязательно) – Устарел (см. reduction). По умолчанию значения функции потерь усредняются или суммируются по наблюдениям для каждого мини-пакета в зависимости от size_average. Если reduce равно False, вместо этого возвращается значение функции потерь для каждого элемента пакета, а size_average игнорируется. По умолчанию: True
  • reduction (str, необязательно) – Определяет способ редукции выходных данных: 'none' | 'mean' | 'sum'. 'none': редукция не выполняется; 'mean': сумма выходных данных делится на количество элементов в них; 'sum': выходные данные суммируются. Примечание: size_average и reduce постепенно выводятся из употребления; пока что указание любого из этих аргументов переопределит reduction. По умолчанию: 'mean'
Форма:
  • Входные данные: (∗)(*), где ∗* обозначает любое количество измерений.
  • Целевые данные: (∗)(*), той же формы, что и входные данные.
  • Выходные данные: скаляр. Если reduction равно 'none', то (∗)(*), той же формы, что и входные данные.

Примеры

>>> loss = nn.L1Loss()
>>> input = torch.randn(3, 5, requires_grad=True)
>>> target = torch.randn(3, 5)
>>> output = loss(input, target)
>>> output.backward()
forward(input, target) [source]

Выполняет прямой проход.

Тип возвращаемого значения:

Tensor

© 2026, PyTorch Contributors
PyTorch has a BSD-style license, as found in the LICENSE file.
https://docs.pytorch.org/docs/2.14/generated/torch.nn.modules.loss.L1Loss.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API