tf.compat.v1.metrics.recall_at_k

Вычисляет recall@k предсказаний относительно разреженных меток.

tf.compat.v1.metrics.recall_at_k(
    labels,
    predictions,
    k,
    class_id=None,
    weights=None,
    metrics_collections=None,
    updates_collections=None,
    name=None
)

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

sparse_recall_at_k создаёт две локальные переменные, true_positive_at_<k> и false_negative_at_<k>, которые используются для вычисления частоты recall_at_k. Эта частота в конечном итоге возвращается как recall_at_<k>: идемпотентная операция, которая просто делит true_positive_at_<k> на сумму true_positive_at_<k> и false_negative_at_<k>.

Для оценки метрики по потоку данных функция создаёт операцию update_op, которая обновляет эти переменные и возвращает recall_at_<k>. Внутри операция top_k вычисляет Tensor, указывающую на топ-k predictions. Операции с множествами, применяемые к top_k и labels, вычисляют истинные положительные и ложные отрицательные значения, взвешенные по weights. Затем update_op увеличивает true_positive_at_<k> и false_negative_at_<k> с использованием этих значений.

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

Args
`labels`	`int64` `Tensor` или `SparseTensor` с формой [D1, ... DN, num_labels] или [D1, ... DN], где последнее подразумевает num_labels=1. N >= 1 и num_labels — количество целевых классов для соответствующего предсказания. Обычно N=1 и `labels` имеет форму [размер_пакета, num_labels]. [D1, ... DN] должно соответствовать `predictions`. Значения должны быть в диапазоне [0, num_classes), где num_classes — последняя размерность `predictions`. Значения за пределами этого диапазона всегда учитываются в `false_negative_at_<k>`.
`predictions`	Вещественное значение `Tensor` с формой [D1, ... DN, num_classes], где N >= 1. Обычно N=1 и predictions имеет форму [размер пакета, num_classes]. Последняя размерность содержит значения лог-вероятностей для каждого класса. [D1, ... DN] должно соответствовать `labels`.
`k`	Целое число, k для метрики @k.
`class_id`	Целое число, идентификатор класса, для которого мы хотим бинарных метрик. Он должен находиться в диапазоне [0, num_classes), где num_classes — последняя размерность `predictions`. Если class_id находится вне этого диапазона, метод возвращает NaN.
`weights`	`Tensor` , ранг которого равен либо 0, либо n-1, где n — ранг `labels`. Если последнее, он должен быть совместим с `labels` (т. е., все размерности должны быть либо `1`, или совпадать с соответствующей размерностью `labels`).
`metrics_collections`	Необязательный список коллекций, в которые должны быть добавлены значения.
`updates_collections`	Необязательный список коллекций, в которые должны быть добавлены обновления.
`name`	Имя новой операции обновления и имя пространства имён для других зависимых операций.

Возвращает
`recall`	Скалярное значение `float64` `Tensor`, равное значению `true_positives` делённому на сумму `true_positives` и `false_negatives`.
`update_op`	Операция `Operation`, которая увеличивает переменные `true_positives` и `false_negatives` соответствующим образом и значение которой соответствует `recall`.

Исключения
`ValueError`	Если `weights` не является `None` и его форма не соответствует `predictions`, или если `metrics_collections` или `updates_collections` не являются списком или кортежем.
`RuntimeError`	Если включена жадная (eager) вычислительная модель.

© 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/compat/v1/metrics/recall_at_k