Spec-Zone.ru › TensorFlow

tf.compat.v1.losses.softmax_cross_entropy

Создает функцию потерь кросс-энтропии с помощью tf.nn.softmax_cross_entropy_with_logits_v2.

tf.compat.v1.losses.softmax_cross_entropy(
    onehot_labels,
    logits,
    weights=1.0,
    label_smoothing=0,
    scope=None,
    loss_collection=ops.GraphKeys.LOSSES,
    reduction=Reduction.SUM_BY_NONZERO_WEIGHTS
)

Перейти на TF2

Внимание: Этот API предназначен для TensorFlow v1. Читайте дальше, чтобы узнать, как перейти с этого API на аналогичную встроенную возможность TensorFlow v2. Инструкции по переносу остальной части кода см. в руководстве по переходу с TensorFlow v1 на TensorFlow v2.

tf.compat.v1.losses.softmax_cross_entropy в основном совместим с eager execution и tf.function. Однако аргумент loss_collection игнорируется при eager execution, и функция потерь не добавляется в коллекции функций потерь. Вам потребуется либо самостоятельно сохранить возвращаемое значение, либо полагаться на отслеживание функций потерь в tf.keras.Model.

Чтобы перейти на нативный стиль TF2, создайте экземпляр класса tf.keras.losses.CategoricalCrossentropy, установив from_logits в значение True, и вызывайте этот объект.

Структурное сопоставление с нативным TF2

До:

loss = tf.compat.v1.losses.softmax_cross_entropy(
  onehot_labels=onehot_labels,
  logits=logits,
  weights=weights,
  label_smoothing=smoothing)

После:

loss_fn = tf.keras.losses.CategoricalCrossentropy(
  from_logits=True,
  label_smoothing=smoothing)
loss = loss_fn(
  y_true=onehot_labels,
  y_pred=logits,
  sample_weight=weights)

Сопоставление аргументов

Имя аргумента TF1 Имя аргумента TF2 Примечание
- from_logits Установите from_logits в значение True, чтобы получить идентичное поведение
onehot_labels y_true В методе __call__()
logits y_pred В методе __call__()
weights sample_weight В методе __call__()
label_smoothing label_smoothing В конструкторе
scope Не поддерживается -
loss_collection Не поддерживается Функции потерь следует отслеживать явно или с помощью API Keras, например add_loss, а не через коллекции
reduction reduction В конструкторе. Значения tf.compat.v1.losses.Reduction.SUM_OVER_BATCH_SIZE, tf.compat.v1.losses.Reduction.SUM, tf.compat.v1.losses.Reduction.NONE в tf.compat.v1.losses.softmax_cross_entropy соответствуют значениям tf.keras.losses.Reduction.SUM_OVER_BATCH_SIZE, tf.keras.losses.Reduction.SUM, tf.keras.losses.Reduction.NONE соответственно. Если вы использовали другое значение для reduction, в том числе значение по умолчанию tf.compat.v1.losses.Reduction.SUM_BY_NONZERO_WEIGHTS, прямого соответствующего значения нет. Измените реализацию функции потерь вручную.

Пример использования до и после

До:

y_true = [[0, 1, 0], [0, 0, 1]]
y_pred = [[0.05, 0.95, 0], [0.1, 0.8, 0.1]]
weights = [0.3, 0.7]
smoothing = 0.2
tf.compat.v1.losses.softmax_cross_entropy(y_true, y_pred, weights=weights,
  label_smoothing=smoothing).numpy()
0.57618

После:

cce = tf.keras.losses.CategoricalCrossentropy(from_logits=True,
  label_smoothing=smoothing)
cce(y_true, y_pred, sample_weight=weights).numpy()
0.57618

Описание

Используется в блокнотах

Используется в руководстве
  • Отладка конвейера обучения после перехода на TensorFlow 2

weights выступает коэффициентом функции потерь. Если задано скалярное значение, функция потерь просто умножается на это значение. Если weights — тензор формы [batch_size], веса функции потерь применяются к каждому соответствующему примеру.

Если label_smoothing не равно нулю, метки сглаживаются в направлении 1/num_classes: new_onehot_labels = onehot_labels * (1 - label_smoothing)

+ label_smoothing / num_classes

Обратите внимание, что onehot_labels и logits должны иметь одинаковую форму, например [batch_size, num_classes]. Форма weights должна допускать широковещательное преобразование относительно функции потерь, форма которой определяется формой logits. Если форма logits равна [batch_size, num_classes], функция потерь представляет собой Tensor формы [batch_size].

Аргументы
onehot_labels Метки в формате one-hot.
logits Выходные логиты сети.
weights Необязательный Tensor, допускающий широковещательное преобразование относительно функции потерь.
label_smoothing Если значение больше 0, метки сглаживаются.
scope Область видимости операций, выполняемых при вычислении функции потерь.
loss_collection Коллекция, в которую будет добавлена функция потерь.
reduction Тип редукции, применяемой к функции потерь.
Возвращает
Взвешенная функция потерь Tensor того же типа, что и logits. Если reduction равно NONE, результат имеет форму [batch_size]; в противном случае возвращается скаляр.
Вызывает исключения
ValueError Если форма logits не совпадает с формой onehot_labels, форма weights недопустима или weights имеет значение None. Также если onehot_labels или logits имеет значение None.

© 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/api_docs/python/tf/compat/v1/losses/softmax_cross_entropy

Spec-Zone.ru

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