Spec-Zone.ru › TensorFlow 1.15

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
)
Предупреждение: ЭТА ФУНКЦИЯ УСТАРЕЛА. Она будет удалена в будущей версии. Инструкции по обновлению: используйте tf.metrics.auc. Обратите внимание, что порядок аргументов labels и predictions был изменён.

Функция 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

Spec-Zone.ru

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