Spec-Zone.ru › TensorFlow 2.9

tf.keras.losses.Loss

Просмотреть исходный код на GitHub

Базовый класс потерь.

Просмотр псевдонимов

Псевдонимы для миграции

См. Руководство по миграции для получения дополнительных сведений.

tf.compat.v1.keras.losses.Loss

tf.keras.losses.Loss(
    reduction=losses_utils.ReductionV2.AUTO, name=None
)

Для реализации подклассами:

  • call(): Содержит логику расчёта потерь с использованием y_true, y_pred.

Пример реализации подкласса:

class MeanSquaredError(Loss):

  def call(self, y_true, y_pred):
    return tf.reduce_mean(tf.math.square(y_pred - y_true), axis=-1)

При использовании с tf.distribute.Strategy вне встроенных циклов обучения, таких как tf.keras compile и fit, используйте типы сведения «СУММА» или «НЕТ», и явно уменьшайте потери в цикле обучения. Использование «АВТО» или «СУММА_ПО_РАЗМЕРУ_ПАЧКИ» приведёт к ошибке.

Для получения дополнительных сведений об этом см. этот учебник по кастомизированному обучению туториал.

Вы можете реализовать «СУММА_ПО_РАЗМЕРУ_ПАЧКИ» используя глобальный размер пачки, например:

with strategy.scope():
  loss_obj = tf.keras.losses.CategoricalCrossentropy(
      reduction=tf.keras.losses.Reduction.NONE)
  ....
  loss = (tf.reduce_sum(loss_obj(labels, predictions)) *
          (1. / global_batch_size))
Аргументы
reduction Тип tf.keras.losses.Reduction для применения к потерям. Значение по умолчанию — AUTO. AUTO указывает, что вариант сведения определяется контекстом использования. Практически во всех случаях по умолчанию это SUM_OVER_BATCH_SIZE. При использовании с tf.distribute.Strategy вне встроенных циклов обучения, таких как tf.keras compile и fit, использование AUTO или SUM_OVER_BATCH_SIZE приведёт к ошибке. Для получения дополнительных сведений об этом см. этот учебник по кастомизированному обучению туториал.
name Необязательное имя экземпляра.

Методы

call

Просмотреть исходный код

@abc.abstractmethod
call(
    y_true, y_pred
)

Вызывает экземпляр Loss.

Аргументы
y_true Значения целевой переменной. shape = [batch_size, d0, .. dN], за исключением функций потерь для разреженных данных, таких как sparse categorical crossentropy, где shape = [batch_size, d0, .. dN-1]
y_pred Предсказанные значения. shape = [batch_size, d0, .. dN]
Возвращаемое значение
Значения потерь с формой [batch_size, d0, .. dN-1].

from_config

Просмотреть исходный код

@classmethod
from_config(
    config
)

Создаёт экземпляр Loss из его конфигурации (вывода get_config()).

Аргументы
config Вывод get_config().
Возвращаемое значение
Экземпляр Loss .

get_config

Просмотреть исходный код

get_config()

Возвращает словарь конфигурации для экземпляра Loss.

__call__

Просмотреть исходный код

__call__(
    y_true, y_pred, sample_weight=None
)

Вызывает экземпляр Loss.

Аргументы
y_true Значения целевой переменной. shape = [batch_size, d0, .. dN], за исключением функций потерь для разреженных данных, таких как sparse categorical crossentropy, где shape = [batch_size, d0, .. dN-1]
y_pred Предсказанные значения. shape = [batch_size, d0, .. dN]
sample_weight Необязательный sample_weight, выступающий в качестве коэффициента для потерь. Если задано скалярное значение, потери просто масштабируются на заданное значение. Если sample_weight является тензором размером [batch_size], то общие потери для каждого образца пачки масштабируются соответствующим элементом в векторе sample_weight. Если форма sample_weight имеет вид [batch_size, d0, .. dN-1] (или может быть расширена до этой формы), то каждый элемент потерь y_pred масштабируется соответствующим значением sample_weight. (Примечание по dN-1: все функции потерь уменьшают размерность на 1, обычно осью -1.)
Возвращаемое значение
Весовые потери float Tensor. Если reduction является NONE, у него форма [batch_size, d0, .. dN-1]; в противном случае это скаляр. (Примечание dN-1: все функции потерь уменьшают размерность на 1, обычно осью -1.)
Исключения
ValueError Если форма sample_weight некорректна.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.9/api_docs/python/tf/keras/losses/Loss

Spec-Zone.ru

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