tf.metrics.specificity_at_sensitivity
Вычисляет специфичность при заданной чувствительности.
tf.metrics.specificity_at_sensitivity(
labels, predictions, sensitivity, weights=None, num_thresholds=200,
metrics_collections=None, updates_collections=None, name=None
)
Функция specificity_at_sensitivity создает четыре локальные переменные, true_positives, true_negatives, false_positives и false_negatives, используемые для вычисления специфичности при заданном значении чувствительности. Порог для заданного значения чувствительности вычисляется и используется для оценки соответствующей специфичности.
Для оценки метрики по потоку данных функция создает операцию update_op, которая обновляет эти переменные и возвращает specificity. update_op увеличивает счетчики true_positives, true_negatives, false_positives и false_negatives с весом каждого случая, найденного в predictions и labels.
Если weights равно None, веса по умолчанию равны 1. Используйте веса 0 для маскирования значений.
Дополнительную информацию о специфичности и чувствительности см. по следующим ссылкам: https://en.wikipedia.org/wiki/Sensitivity_and_specificity
| Аргументы | |
|---|---|
labels | Значения фактического результата, Tensor, размерность которого должна соответствовать predictions. Будет приведено к типу bool. |
predictions | Числовое значение с плавающей точкой Tensor произвольной формы, значения которого находятся в диапазоне [0, 1]. |
sensitivity | Скалярное значение в диапазоне [0, 1]. |
weights | Необязательные Tensor, ранг которых равен либо 0, либо совпадает с рангом labels, и должен быть транслируемым в labels (т.е., все размеры должны быть либо 1, либо совпадать с соответствующим размером labels). |
num_thresholds | Количество пороговых значений для соответствия заданной чувствительности. |
metrics_collections | Необязательный список коллекций, к которым specificity должен быть добавлен. |
updates_collections | Необязательный список коллекций, к которым update_op должен быть добавлен. |
name | Необязательное имя области переменных. |
| Возвращаемое значение | |
|---|---|
specificity | Скалярное значение Tensor, представляющее специфичность при заданном значении sensitivity. |
update_op | Операция, которая увеличивает true_positives, true_negatives, false_positives и false_negatives переменные соответствующим образом, и значение которой совпадает со значением specificity. |
| Исключения | |
|---|---|
ValueError | Если predictions и labels имеют несовпадающие формы, если weights не None и его форма не соответствует predictions, или если sensitivity не находится между 0 и 1, или если metrics_collections или updates_collections не являются списком или кортежем. |
RuntimeError | Если выполнение в режиме eager включено. |
© 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/metrics/specificity_at_sensitivity
