tf.compat.v1.metrics.recall_at_top_k

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

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

Отличается от recall_at_k тем, что предсказания должны быть представлены в виде индексов классов top k, тогда как recall_at_k ожидает логиты. Подробнее см. recall_at_k.

Аргументы
`labels`	`int64` `Tensor` или `SparseTensor` с формой [D1, ... DN, num_labels] или [D1, ... DN], где во втором случае подразумевается num_labels=1. N >= 1, а num_labels — количество целевых классов для соответствующего предсказания. Обычно N=1 и `labels` имеет форму [batch_size, num_labels]. [D1, ... DN] должно соответствовать `predictions`. Значения должны находиться в диапазоне [0, num_classes), где num_classes — размер последнего измерения `predictions`. Значения вне этого диапазона всегда учитываются как `false_negative_at_<k>`.
`predictions_idx`	Целочисленный `Tensor` с формой [D1, ... DN, k], где N >= 1. Обычно N=1, а predictions имеет форму [batch size, k]. Последнее измерение содержит индексы top `k` предсказанных классов. [D1, ... DN] должно соответствовать `labels`.
`k`	Целое число k для метрики @k. Используется только для имени операции по умолчанию.
`class_id`	Целочисленный идентификатор класса, для которого нужны бинарные метрики. Он должен находиться в диапазоне [0, num_classes), где num_classes — размер последнего измерения `predictions`. Если class_id находится вне этого диапазона, метод возвращает NAN.
`weights`	`Tensor`, ранг которого равен 0 или n-1, где n — ранг `labels`. Если ранг равен n-1, он должен допускать широковещательное преобразование к `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` не является списком или кортежем.

© 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/api_docs/python/tf/compat/v1/metrics/recall_at_top_k