tf.contrib.metrics.streaming_auc
Вычисляет приблизительную AUC с помощью суммы Римана. (устарело)
tf.contrib.metrics.streaming_auc(
predictions, labels, weights=None, num_thresholds=200, metrics_collections=None,
updates_collections=None, curve='ROC', name=None
)
Функция streaming_auc создаёт четыре локальные переменные, true_positives, true_negatives, false_positives и false_negatives, используемые для вычисления AUC. Для дискретизации кривой AUC используется линейно распределённый набор пороговых значений для вычисления пар значений отзыва и точности. Таким образом, площадь под кривой ROC вычисляется с помощью высоты значений отзыва по отношению к скорости ложных срабатываний, а площадь под кривой PR вычисляется с помощью высоты значений точности по отношению к отзывчивости.
Это значение в конечном итоге возвращается как auc, идемпотентная операция, которая вычисляет площадь под дискретизированной кривой точности по отношению к отзывчивости (вычисляемой с использованием упомянутых выше переменных). Переменная num_thresholds управляет степенью дискретизации, и большие значения порога более точно аппроксимируют истинную AUC. Качество приближения может значительно варьироваться в зависимости от num_thresholds.
Для достижения наилучших результатов predictions должны быть распределены примерно равномерно в диапазоне [0, 1] и не должны иметь пиков около 0 или 1. Качество аппроксимации AUC может быть плохим, если это не так.
Для оценки метрики по потоку данных функция создаёт операцию update_op , которая обновляет эти переменные и возвращает auc.
Если weights является None, веса по умолчанию равны 1. Используйте веса 0 для маскирования значений.
| Args | |
|---|---|
predictions | Вещественное Tensor произвольной формы, значения которого находятся в диапазоне [0, 1]. |
labels | bool Tensor , форма которого соответствует predictions. |
weights | Tensor , ранг которого равен либо 0, либо совпадает с рангом labels, и должен быть совместим с labels (то есть все измерения должны быть либо 1, или совпадать с соответствующим измерением labels). |
num_thresholds | Количество пороговых значений для дискретизации кривой roc. |
metrics_collections | Необязательный список коллекций, к которым auc должны быть добавлены. |
updates_collections | Необязательный список коллекций, к которым update_op должны быть добавлены. |
curve | Указывает имя вычисляемой кривой, 'ROC' [по умолчанию] или 'PR' для кривой точности-полноты. |
name | Необязательное имя области переменных. |
| Returns | |
|---|---|
auc | Скалярное Tensor , представляющее текущую площадь под кривой. |
update_op | Операция, которая увеличивает true_positives, true_negatives, false_positives и false_negatives переменные соответствующим образом и значение которой соответствует auc. |
| Raises | |
|---|---|
ValueError | Если predictions и labels имеют несовпадающие формы, или если weights не является None и его форма не соответствует predictions, или если metrics_collections или updates_collections не являются списком или кортежем. |
© 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/contrib/metrics/streaming_auc