tf.keras.metrics.Sum

Вычисляет (взвешенную) сумму заданных значений.

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

tf.keras.metrics.Sum(
    name='sum', dtype=None
)

Например, если значения равны [1, 3, 5, 7], то сумма равна 16. Если веса заданы как [1, 1, 0, 0], то сумма будет 4.

Этот метрический показатель создаёт одну переменную, total, которая используется для вычисления суммы values. В конечном итоге это возвращается как sum.

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

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

m = tf.keras.metrics.Sum()
m.update_state([1, 3, 5, 7])
m.result().numpy()
16.0

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

model.add_metric(tf.keras.metrics.Sum(name='sum_1')(outputs))
model.compile(optimizer='sgd', loss='mse')

Методы

merge_state

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

merge_state(
    metrics
)

Объединяет состояние из одной или нескольких метрик.

Этот метод может использоваться распределёнными системами для объединения состояния, вычисленного различными экземплярами метрик. Обычно состояние хранится в виде весов метрики. Например, метрика tf.keras.metrics.Mean содержит список из двух значений весов: общее значение и количество. Если было два экземпляра метрики tf.keras.metrics.Accuracy, которые независимо агрегировали частичное состояние для расчёта общей точности, состояние этих двух метрик можно объединить следующим образом:

m1 = tf.keras.metrics.Accuracy()
_ = m1.update_state([[1], [2]], [[0], [2]])

m2 = tf.keras.metrics.Accuracy()
_ = m2.update_state([[3], [4]], [[3], [4]])

m2.merge_state([m1])
m2.result().numpy()
0.75

reset_state

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

reset_state()

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

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

result

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

result()

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

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

update_state

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

update_state(
    values, sample_weight=None
)

Накапливает статистику для вычисления метрики.