Spec-Zone.ru › TensorFlow 1.15

tf.keras.losses.Loss

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

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

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

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

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

tf.compat.v1.keras.losses.Loss, `tf.compat.v2.keras.losses.Loss`, `tf.compat.v2.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):
    y_pred = ops.convert_to_tensor(y_pred)
    y_true = math_ops.cast(y_true, y_pred.dtype)
    return K.mean(math_ops.square(y_pred - y_true), axis=-1)

При использовании с tf.distribute.Strategy вне встроенных циклов обучения, таких как tf.keras compile и fit, используйте типы редукции 'SUM' или 'NONE', и явно уменьшайте потери в цикле обучения. Использование 'AUTO' или 'SUM_OVER_BATCH_SIZE' вызовет ошибку.

Дополнительные сведения см. в https://www.tensorflow.org/alpha/tutorials/distribute/training_loops.

Вы можете реализовать 'SUM_OVER_BATCH_SIZE', используя глобальный размер пакета, например:

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 вызовет ошибку. Дополнительные сведения см. в https://www.tensorflow.org/alpha/tutorials/distribute/training_loops.
name Необязательное имя операции.

Методы

call

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

@abc.abstractmethod
call(
    y_true, y_pred
)

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

Аргументы
y_true Значения истинного значения с той же формой, что и 'y_pred'.
y_pred Предсказанные значения.

from_config

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

@classmethod
from_config(
    config
)

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

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

get_config

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

get_config()

__call__

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

__call__(
    y_true, y_pred, sample_weight=None
)

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

Аргументы
y_true Значения истинного значения. форма = [batch_size, d0, .. dN]
y_pred Предсказанные значения. форма = [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.)
Возвращает
Весовые потери число с плавающей точкой Tensor. Если reduction равно NONE, эта форма равна [batch_size, d0, .. dN-1]; в противном случае — скаляр. (Примечание dN-1 , так как все функции потерь уменьшаются на 1 размерность, обычно ось = -1.)
Возможные исключения
ValueError Если форма sample_weight недопустима.

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

Spec-Zone.ru

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