Spec-Zone.ru › TensorFlow 1.15

tf.keras.metrics.SparseCategoricalCrossentropy

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

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

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

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

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

tf.compat.v1.keras.metrics.SparseCategoricalCrossentropy, `tf.compat.v2.keras.metrics.SparseCategoricalCrossentropy`, `tf.compat.v2.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].

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

m = tf.keras.metrics.SparseCategoricalCrossentropy()
m.update_state(
  [1, 2],
  [[0.05, 0.95, 0], [0.1, 0.8, 0.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

print('Final result: ', m.result().numpy())  # Final result: 1.176

Использование с API tf.keras:

model = tf.keras.Model(inputs, outputs)
model.compile(
  'sgd',
  loss='mse',
  metrics=[tf.keras.metrics.SparseCategoricalCrossentropy()])
Аргументы
name (Необязательно) строковое имя экземпляра метрики.
dtype (Необязательно) тип данных результата метрики.
from_logits (Необязательно) ожидается ли y_pred быть тензором логов. По умолчанию предполагается, что y_pred кодирует распределение вероятностей.
axis (Необязательно) По умолчанию -1. Размерность, по которой вычисляется метрика.
Аргументы
fn Функция метрики для обертывания, со сигнатурой fn(y_true, y_pred, **kwargs).
name (Необязательно) строковое имя экземпляра метрики.
dtype (Необязательно) тип данных результата метрики.
**kwargs Ключевые аргументы, которые передаются в fn.

Методы

reset_states

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

reset_states()

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

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

result

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

result()

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

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

update_state

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

update_state(
    y_true, y_pred, sample_weight=None
)

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

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

Аргументы
y_true Значения фактических данных.
y_pred Прогнозируемые значения.
sample_weight Необязательное взвешивание каждого примера. По умолчанию 1. Может быть Tensor, чья ранг равен либо 0, либо такому же рангу, что и у y_true, и должен быть совместим для вещания с y_true.
Возвращаемое значение
Операция обновления.

© 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/metrics/SparseCategoricalCrossentropy

Spec-Zone.ru

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