tf.keras.metrics.Recall

Просмотреть исходный код на GitHub

Вычисляет полноту предсказаний относительно меток.

Наследуется от: Metric

Просмотр псевдонимов

Основные псевдонимы

tf.metrics.Recall

Псевдонимы для миграции

См. Руководство по миграции для получения дополнительных сведений.

tf.compat.v1.keras.metrics.Recall

tf.keras.metrics.Recall(
    thresholds=None, top_k=None, class_id=None, name=None, dtype=None
)

Этот метрический показатель создает две локальные переменные, true_positives и false_negatives, которые используются для вычисления полноты. Это значение в конечном итоге возвращается как recall, идемпотентная операция, которая просто делит true_positives на сумму true_positives и false_negatives.

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

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

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

Аргументы
`thresholds`	(Необязательно) Числовое значение с плавающей точкой или список/кортеж питонских значений порога с плавающей точкой в диапазоне [0, 1]. Порог сравнивается со значениями предсказания для определения истинного значения предсказания (т.е., выше порога — `true`, ниже — `false`). Для каждого значения порога генерируется одно значение метрики. Если не заданы ни пороговые значения, ни top_k, по умолчанию вычисляется полнота с `thresholds=0.5`.
`top_k`	(Необязательно) По умолчанию не задано. Целочисленное значение, определяющее топ-k предсказаний для рассмотрения при вычислении полноты.
`class_id`	(Необязательно) Целочисленный идентификатор класса, для которого требуются бинарные метрики. Он должен находиться в полуоткрытом интервале `[0, num_classes)`, где `num_classes` — последняя размерность предсказаний.
`name`	(Необязательно) Имя строки экземпляра метрики.
`dtype`	(Необязательно) Тип данных результата метрики.

Использование в автономном режиме:

m = tf.keras.metrics.Recall()
m.update_state([0, 1, 1, 1], [1, 0, 1, 1])
m.result().numpy()
0.6666667

m.reset_states()
m.update_state([0, 1, 1, 1], [1, 0, 1, 1], sample_weight=[0, 0, 1, 0])
m.result().numpy()
1.0

Использование с API compile():

model.compile(optimizer='sgd',
              loss='mse',
              metrics=[tf.keras.metrics.Recall()])

Методы

`reset_states`

Просмотреть исходный код

reset_states()

Сбрасывает все переменные состояния метрики.

Эта функция вызывается между эпохами/шагами, когда метрика оценивается во время обучения.

`result`

Просмотреть исходный код

result()

Вычисляет и возвращает тензор значения метрики.

Вычисление результата — это идемпотентная операция, которая просто вычисляет значение метрики с использованием переменных состояния.

`update_state`

Просмотреть исходный код

update_state(
    y_true, y_pred, sample_weight=None
)

Накапливает статистику истинно-положительных и ложно-отрицательных значений.

Аргументы
`y_true`	Значения целевого истинного значения, с теми же размерами, что и `y_pred`. Будет приведено к типу `bool`.
`y_pred`	Значения предсказанных значений. Каждое значение должно быть в диапазоне `[0, 1]`.
`sample_weight`	Необязательное взвешивание каждого примера. По умолчанию 1. Может быть `Tensor`, ранг которого равен 0 или соответствует рангу `y_true`, и должен быть совместим для использования с `y_true`.

Возвращаемое значение
Операция обновления.

© 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/r2.3/api_docs/python/tf/keras/metrics/Recall