tf.keras.metrics.SparseCategoricalCrossentropy
| Просмотреть исходный код на GitHub |
Вычисляет метрику кроссэнтропии между метками и прогнозами.
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.3/api_docs/python/tf/keras/metrics/SparseCategoricalCrossentropy