Spec-Zone.ru › TensorFlow 2.4

tf.keras.metrics.SparseCategoricalCrossentropy

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

Вычисляет метрику кроссэнтропии между метками и предсказаниями.

Наследуется от: Mean, Metric, Layer, Module

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

Основные псевдонимы

tf.metrics.SparseCategoricalCrossentropy

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

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

tf.compat.v1.keras.metrics.SparseCategoricalCrossentropy

tf.keras.metrics.SparseCategoricalCrossentropy(
    name='sparse_categorical_crossentropy', dtype=None, from_logits=False,
    axis=-1
)

Используйте эту метрику кроссэнтропии, когда существует две или более категорий меток. Ожидается, что метки будут представлены в виде целых чисел. Если вы хотите предоставить метки с использованием one-hot представления, пожалуйста, используйте метрику CategoricalCrossentropy. Должно быть # classes значений с плавающей точкой на признак для y_pred и одно значение с плавающей точкой на признак для y_true.

В примере ниже для y_true существует одно значение с плавающей точкой на пример, а для # classes - y_pred значений с плавающей точкой на пример. Форма y_true равна [batch_size], а форма y_pred равна [batch_size, num_classes].

Аргументы
name (Необязательно) строковое имя экземпляра метрики.
dtype (Необязательно) тип данных результата метрики.
from_logits (Необязательно) ожидается ли на выходе тензор логарифмов. По умолчанию предполагается, что вывод кодирует распределение вероятностей.
axis (Необязательно) По умолчанию -1. Размерность, по которой вычисляется метрика.

Использование автономно:

# y_true = one_hot(y_true) = [[0, 1, 0], [0, 0, 1]]
# logits = log(y_pred)
# softmax = exp(logits) / sum(exp(logits), axis=-1)
# softmax = [[0.05, 0.95, EPSILON], [0.1, 0.8, 0.1]]
# xent = -sum(y * log(softmax), 1)
# log(softmax) = [[-2.9957, -0.0513, -16.1181],
#                [-2.3026, -0.2231, -2.3026]]
# y_true * log(softmax) = [[0, -0.0513, 0], [0, 0, -2.3026]]
# xent = [0.0513, 2.3026]
# Reduced xent = (0.0513 + 2.3026) / 2
m = tf.keras.metrics.SparseCategoricalCrossentropy()
m.update_state([1, 2],
               [[0.05, 0.95, 0], [0.1, 0.8, 0.1]])
m.result().numpy()
1.1769392
m.reset_states()
m.update_state([1, 2],
               [[0.05, 0.95, 0], [0.1, 0.8, 0.1]],
               sample_weight=tf.constant([0.3, 0.7]))
m.result().numpy()
1.6271976

Использование с API compile():

model.compile(
  optimizer='sgd',
  loss='mse',
  metrics=[tf.keras.metrics.SparseCategoricalCrossentropy()])

Методы

reset_states

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

reset_states()

Сбрасывает все переменные состояния метрики.

Эта функция вызывается между эпохами/шагами, когда метрика оценивается во время обучения.

result

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

result()

Вычисляет и возвращает тензор значения метрики.

Вычисление результата является идемпотентной операцией, которая просто вычисляет значение метрики с использованием переменных состояния.

update_state

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

update_state(
    y_true, y_pred, sample_weight=None
)

Накапливает статистику метрики.

y_true и y_pred должны иметь одинаковую форму.

Аргументы
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)).
Возвращаемое значение
Операция обновления.

© 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/r2.4/api_docs/python/tf/keras/metrics/SparseCategoricalCrossentropy

Spec-Zone.ru

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