tf.metrics.mean_tensor
Вычисляет поэлементное (взвешенное) среднее значение заданных тензоров.
tf.metrics.mean_tensor(
values, weights=None, metrics_collections=None, updates_collections=None,
name=None
)
В отличие от функции mean, которая возвращает скаляр со средним значением, эта функция возвращает тензор среднего значения с той же формой, что и входные тензоры.
Функция mean_tensor создаёт две локальные переменные, total_tensor и count_tensor, которые используются для вычисления среднего значения values. Это среднее значение в конечном итоге возвращается как mean, что является идемпотентной операцией, которая просто делит total на count.
Для оценки метрики по потоку данных функция создаёт операцию update_op, которая обновляет эти переменные и возвращает mean. update_op увеличивает total на уменьшенную сумму произведения values и weights, и увеличивает count на уменьшенную сумму weights.
Если weights равно None, веса по умолчанию равны 1. Используйте веса 0 для маскирования значений.
| Аргументы | |
|---|---|
values | Tensor произвольных размерностей. |
weights | Необязательные Tensor, чья размерность равна либо 0, либо той же размерности, что и values, и должны быть совместимы для трансляции с values (т.е. все размеры должны быть либо 1, либо такими же, как соответствующий размер values). |
metrics_collections | Необязательный список коллекций, к которым mean должен быть добавлен. |
updates_collections | Необязательный список коллекций, к которым update_op должен быть добавлен. |
name | Необязательное имя области переменных. |
| Возвращает | |
|---|---|
mean | Вещественный Tensor тип, представляющий текущее среднее значение, значение total , делённое на count. |
update_op | Операция, которая увеличивает переменные total и count соответствующим образом и значение которой соответствует mean_value. |
| Возможные исключения | |
|---|---|
ValueError | Если weights не None и его форма не соответствует values, или если 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/mean_tensor