tf.keras.metrics.Метрика

Инкапсулирует логику и состояние метрики.

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

tf.keras.metrics.Metric(
    name=None, dtype=None, **kwargs
)

Использование в качестве самостоятельной метрики:

m = SomeMetric(...)
for input in ...:
  m.update_state(input)
print('Final result: ', m.result().numpy())

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

model = tf.keras.Sequential()
model.add(tf.keras.layers.Dense(64, activation='relu'))
model.add(tf.keras.layers.Dense(64, activation='relu'))
model.add(tf.keras.layers.Dense(10, activation='softmax'))

model.compile(optimizer=tf.keras.optimizers.RMSprop(0.01),
              loss=tf.keras.losses.CategoricalCrossentropy(),
              metrics=[tf.keras.metrics.CategoricalAccuracy()])

data = np.random.random((1000, 32))
labels = np.random.random((1000, 10))

dataset = tf.data.Dataset.from_tensor_slices((data, labels))
dataset = dataset.batch(32)

model.fit(dataset, epochs=10)

Для реализации подклассами:

• __init__(): Все переменные состояния должны быть созданы в этом методе, вызывая self.add_weight() следующим образом: self.var = self.add_weight(...)
• update_state(): Содержит все обновления переменных состояния, например: self.var.assign_add(...).
• result(): Вычисляет и возвращает значение метрики из переменных состояния.

Пример реализации подкласса:

class BinaryTruePositives(tf.keras.metrics.Metric):

  def __init__(self, name='binary_true_positives', **kwargs):
    super(BinaryTruePositives, self).__init__(name=name, **kwargs)
    self.true_positives = self.add_weight(name='tp', initializer='zeros')

  def update_state(self, y_true, y_pred, sample_weight=None):
    y_true = tf.cast(y_true, tf.bool)
    y_pred = tf.cast(y_pred, tf.bool)

    values = tf.logical_and(tf.equal(y_true, True), tf.equal(y_pred, True))
    values = tf.cast(values, self.dtype)
    if sample_weight is not None:
      sample_weight = tf.cast(sample_weight, self.dtype)
      sample_weight = tf.broadcast_to(sample_weight, values.shape)
      values = tf.multiply(values, sample_weight)
    self.true_positives.assign_add(tf.reduce_sum(values))

  def result(self):
    return self.true_positives

Методы

add_weight

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

add_weight(
    name, shape=(), aggregation=tf.compat.v1.VariableAggregation.SUM,
    synchronization=tf.VariableSynchronization.ON_READ, initializer=None, dtype=None
)

Добавляет переменную состояния. Только для использования подклассами.

reset_states

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

reset_states()

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

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

result

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

@abc.abstractmethod
result()

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

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

update_state

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

@abc.abstractmethod
update_state(
    *args, **kwargs
)

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

Примечание: Эта функция выполняется как функция графа в режиме графа. Это означает: a) Операции с одним и тем же ресурсом выполняются в текстовом порядке. Это должно упростить выполнение таких операций, как добавление обновленного значения переменной к другой, например. b) Вам не нужно беспокоиться о сборе операций обновления для выполнения. Все операции обновления, добавленные в граф этой функцией, будут выполнены. В результате код в целом должен работать одинаково как с графическим, так и с неграфическим выполнением.