tf.keras.metrics.CategoricalCrossentropy
| Просмотреть исходный код на GitHub |
Вычисляет метрику кроссэнтропии между метками и предсказаниями.
tf.keras.metrics.CategoricalCrossentropy(
name='categorical_crossentropy', dtype=None, from_logits=False,
label_smoothing=0
)
Это класс метрики кроссэнтропии, который используется, когда существует несколько классов меток (2 или более). Здесь мы предполагаем, что метки представлены в виде one_hot. Например, когда значения меток [2, 0, 1], y_true = [[0, 0, 1], [1, 0, 0], [0, 1, 0]].
| Аргументы | |
|---|---|
name | (Необязательно) имя метрики. |
dtype | (Необязательно) тип данных результата метрики. |
from_logits | (Необязательно) ожидается ли тензор логарифмов. По умолчанию предполагается, что выход представляет распределение вероятностей. |
label_smoothing | (Необязательно) Число в диапазоне [0, 1]. Если > 0, значения меток сглаживаются, что означает смягчение уверенности в значениях меток. Например, label_smoothing=0.2 означает, что мы будем использовать значение 0.1 для метки 0 и 0.9 для метки 1 |
Использование в автономном режиме:
# EPSILON = 1e-7, y = y_true, y` = y_pred
# y` = clip_ops.clip_by_value(output, EPSILON, 1. - EPSILON)
# y` = [[0.05, 0.95, EPSILON], [0.1, 0.8, 0.1]]
# xent = -sum(y * log(y'), axis = -1)
# = -((log 0.95), (log 0.1))
# = [0.051, 2.302]
# Reduced xent = (0.051 + 2.302) / 2
m = tf.keras.metrics.CategoricalCrossentropy()
m.update_state([[0, 1, 0], [0, 0, 1]],
[[0.05, 0.95, 0], [0.1, 0.8, 0.1]])
m.result().numpy()
1.1769392
m.reset_states()
m.update_state([[0, 1, 0], [0, 0, 1]],
[[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.CategoricalCrossentropy()])
Методы
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.3/api_docs/python/tf/keras/metrics/CategoricalCrossentropy