Spec-Zone.ru › TensorFlow 2.9

tf.compat.v1.losses.mean_squared_error

Добавляет потерю сумм квадратов в процедуру обучения.

tf.compat.v1.losses.mean_squared_error(
    labels,
    predictions,
    weights=1.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.mean_squared_error в основном совместим с выполнением eager и tf.function. Но аргумент loss_collection игнорируется при выполнении eager, и никакие потери не будут записаны в коллекции потерь. Вам нужно будет либо вручную сохранить возвращаемое значение, либо положиться на отслеживание потерь с помощью tf.keras.Model.

Чтобы перейти к стилю native TF2, инициализируйте класс tf.keras.losses.MeanSquaredError и вызовите объект вместо этого.

Структурное соответствие с native TF2

До:

loss = tf.compat.v1.losses.mean_squared_error(
  labels=labels,
  predictions=predictions,
  weights=weights,
  reduction=reduction)

После:

loss_fn = tf.keras.losses.MeanSquaredError(
  reduction=reduction)
loss = loss_fn(
  y_true=labels,
  y_pred=predictions,
  sample_weight=weights)

Как сопоставить аргументы

Имя аргумента TF1 Имя аргумента TF2 Примечание
labels y_true В методе __call__()
predictions y_pred В методе __call__()
weights sample_weight В методе __call__(). Требования к форме sample_weight отличаются от weights. Подробности см. в определении аргумента.
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 = [1, 2, 3]
y_pred = [1, 3, 5]
weights = [0, 1, 0.25]
# samples with zero-weight are excluded from calculation when `reduction`
# argument is set to default value `Reduction.SUM_BY_NONZERO_WEIGHTS`
tf.compat.v1.losses.mean_squared_error(
   labels=y_true,
   predictions=y_pred,
   weights=weights).numpy()
1.0
tf.compat.v1.losses.mean_squared_error(
   labels=y_true,
   predictions=y_pred,
   weights=weights,
   reduction=tf.compat.v1.losses.Reduction.SUM_OVER_BATCH_SIZE).numpy()
0.66667

После:

y_true = [[1.0], [2.0], [3.0]]
y_pred = [[1.0], [3.0], [5.0]]
weights = [1, 1, 0.25]
mse = tf.keras.losses.MeanSquaredError(
   reduction=tf.keras.losses.Reduction.SUM_OVER_BATCH_SIZE)
mse(y_true=y_true, y_pred=y_pred, sample_weight=weights).numpy()
0.66667

Описание

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

Аргументы
labels Tensor целевого выходного значения, размерность которого совпадает с 'predictions'.
predictions Прогнозируемые выходные значения.
weights Необязательный Tensor, ранг которого равен 0 или совпадает с рангом labels, и должен быть совместим с labels (т. е., все измерения должны быть либо 1, либо совпадать с соответствующим измерением losses).
scope Область для операций, выполняемых при вычислении потерь.
loss_collection Коллекция, в которую будут добавлены потери.
reduction Тип редукции, применяемой к потерям.
Возвращаемое значение
Весовые потери с плавающей точкой Tensor. Если reduction равно NONE, форма результата совпадает с формой labels; в противном случае - скаляр.
Исключения
ValueError Если форма predictions не совпадает с формой labels или если форма weights некорректна. Также, если labels или predictions равны 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/versions/r2.9/api_docs/python/tf/compat/v1/losses/mean_squared_error

Spec-Zone.ru

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