tf.keras.metrics.BinaryCrossentropy
| Просмотреть исходный код на GitHub |
Вычисляет метрику кроссэнтропии между метками и прогнозами.
Наследуется от: MeanMetricWrapper, Mean, Metric, Layer, Module
tf.keras.metrics.BinaryCrossentropy(
name='binary_crossentropy',
dtype=None,
from_logits=False,
label_smoothing=0
)
Это класс метрики кроссэнтропии, который используется, когда есть только два класса меток (0 и 1).
| Аргументы | |
|---|---|
name | (Необязательно) строковое имя экземпляра метрики. |
dtype | (Необязательно) тип данных результата метрики. |
from_logits | (Необязательно) ожидается ли, что выходной тензор будет представлять собой тензор логарифмов. По умолчанию предполагается, что выходной тензор кодирует распределение вероятностей. |
label_smoothing | (Необязательно) Число с плавающей точкой в диапазоне [0, 1]. При значении > 0 значения меток сглаживаются, что означает, что уверенность в значениях меток ослаблена. Например, label_smoothing=0.2 означает, что мы будем использовать значение 0.1 для метки 0 и 0.9 для метки 1. |
Использование в автономном режиме:
m = tf.keras.metrics.BinaryCrossentropy() m.update_state([[0, 1], [0, 0]], [[0.6, 0.4], [0.4, 0.6]]) m.result().numpy() 0.81492424
m.reset_state()
m.update_state([[0, 1], [0, 0]], [[0.6, 0.4], [0.4, 0.6]],
sample_weight=[1, 0])
m.result().numpy()
0.9162905
Использование с API compile().
model.compile(
optimizer='sgd',
loss='mse',
metrics=[tf.keras.metrics.BinaryCrossentropy()])
Методы
merge_state
merge_state(
metrics
)
Объединяет состояние из одной или нескольких метрик.
Этот метод может использоваться распределёнными системами для объединения состояния, вычисленного различными экземплярами метрики. Обычно состояние хранится в виде весов метрики. Например, метрика tf.keras.metrics.Mean содержит список из двух значений весов: общее значение и счётчик. Если есть два экземпляра tf.keras.metrics.Accuracy, которые каждый независимо агрегируют частичное состояние для расчёта общей точности, эти два состояния метрик можно объединить следующим образом:
m1 = tf.keras.metrics.Accuracy() _ = m1.update_state([[1], [2]], [[0], [2]])
m2 = tf.keras.metrics.Accuracy() _ = m2.update_state([[3], [4]], [[3], [4]])
m2.merge_state([m1]) m2.result().numpy() 0.75
| Аргументы | |
|---|---|
metrics | итерируемый список метрик. Метрики должны иметь совместимое состояние. |
| Исключения | |
|---|---|
ValueError | Если предоставленный итерируемый список не содержит метрик, соответствующих требованиям метрики. |
reset_state
reset_state()
Сбрасывает все переменные состояния метрики.
Эта функция вызывается между эпохами/шагами, когда метрика оценивается во время обучения.
result
result()
Вычисляет и возвращает скалярное тензорное значение метрики или словарь скалярных значений.
Вычисление результата — это идемпотентная операция, которая просто вычисляет значение метрики, используя переменные состояния.
| Возвращаемое значение | |
|---|---|
| Скалярный тензор или словарь скалярных тензоров. |
update_state
update_state(
y_true, y_pred, sample_weight=None
)
Накапливает статистику метрики.
Для метрик разреженных категориальных данных формы y_true и y_pred отличаются.
| Аргументы | |
|---|---|
y_true | Значения меток фактических значений. shape = [batch_size, d0, .. dN-1] или shape = [batch_size, d0, .. dN-1, 1]. |
y_pred | Предсказанные значения вероятности. shape = [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)). |
| Возвращаемое значение | |
|---|---|
| Операция обновления. |
© 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/keras/metrics/BinaryCrossentropy