Spec-Zone.ru › TensorFlow 2.4

tf.keras.metrics.Precision

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

Вычисляет точность прогнозов относительно меток.

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

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

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

tf.metrics.Precision

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

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

tf.compat.v1.keras.metrics.Precision

tf.keras.metrics.Precision(
    thresholds=None, top_k=None, class_id=None, name=None, dtype=None
)

Метрика создаёт две локальные переменные, true_positives и false_positives, используемые для вычисления точности. Это значение в конечном итоге возвращается как precision, идемпотентная операция, которая просто делит true_positives на сумму true_positives и false_positives.

Если sample_weight является None, веса по умолчанию равны 1. Используйте значения весов 0 для маскирования значений.

Если top_k установлено, мы вычислим точность как частоту, с которой в среднем класс среди верхних k классов с наибольшими предсказанными значениями записи пакета является верным и может быть найден в метке для этой записи.

Если указано class_id, мы вычисляем точность, учитывая только записи в пакете, для которых class_id превышает порог и/или находится в числе k лучших прогнозов, и вычисляем долю из них, для которых class_id действительно является правильной меткой.

Аргументы
thresholds (Необязательно) Числовое значение с плавающей точкой или список/кортеж питоновских значений пороговых значений с плавающей точкой в диапазоне [0, 1]. Порог сравнивается со значениями прогнозов, чтобы определить истинное значение прогнозов (т.е., выше порога — true, ниже — false). Одно значение метрики генерируется для каждого значения порога. Если не заданы ни пороги, ни top_k, по умолчанию вычисляется точность с thresholds=0.5.
top_k (Необязательно) По умолчанию не задано. Целочисленное значение, определяющее k лучших прогнозов для учёта при расчёте точности.
class_id (Необязательно) Целочисленный идентификатор класса, для которого мы хотим получить бинарные метрики. Он должен находиться в полуоткрытом интервале [0, num_classes), где num_classes — последняя размерность прогнозов.
name (Необязательно) Строковое имя экземпляра метрики.
dtype (Необязательно) Тип данных результата метрики.

Применение в отдельности:

m = tf.keras.metrics.Precision()
m.update_state([0, 1, 1, 1], [1, 0, 1, 1])
m.result().numpy()
0.6666667
m.reset_states()
m.update_state([0, 1, 1, 1], [1, 0, 1, 1], sample_weight=[0, 0, 1, 0])
m.result().numpy()
1.0
# With top_k=2, it will calculate precision over y_true[:2] and y_pred[:2]
m = tf.keras.metrics.Precision(top_k=2)
m.update_state([0, 0, 1, 1], [1, 1, 1, 1])
m.result().numpy()
0.0
# With top_k=4, it will calculate precision over y_true[:4] and y_pred[:4]
m = tf.keras.metrics.Precision(top_k=4)
m.update_state([0, 0, 1, 1], [1, 1, 1, 1])
m.result().numpy()
0.5

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

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

Методы

reset_states

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

reset_states()

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

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

result

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

result()

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

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

update_state

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

update_state(
    y_true, y_pred, sample_weight=None
)

Накапливает статистику истинно-положительных и ложно-положительных результатов.

Аргументы
y_true Значения истинного результата, с той же размерностью, что и y_pred. Будут преобразованы к типу bool.
y_pred Предсказанные значения. Каждый элемент должен находиться в диапазоне [0, 1].
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/r2.4/api_docs/python/tf/keras/metrics/Precision

Spec-Zone.ru

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