准确率指标
Accuracy 类
keras.metrics.Accuracy(name="accuracy", dtype=None)
计算预测值等于标签的频率。
该指标创建两个局部变量 total 和 count，用于计算 y_pred 与 y_true 匹配的频率。此频率最终作为二元准确率返回：一个简单的将 total 除以 count 的幂等操作。
如果 sample_weight 为 None，则权重默认为 1。使用 sample_weight 为 0 来屏蔽值。
参数
- name：(可选) 指标实例的字符串名称。
- dtype：(可选) 指标结果的数据类型。
示例
>>> m = keras.metrics.Accuracy()
>>> m.update_state([[1], [2], [3], [4]], [[0], [2], [3], [4]])
>>> m.result()
0.75
>>> m.reset_state()
>>> m.update_state([[1], [2], [3], [4]], [[0], [2], [3], [4]],
... sample_weight=[1, 1, 0, 0])
>>> m.result()
0.5
与 compile() API 一起使用
model.compile(optimizer='sgd',
loss='binary_crossentropy',
metrics=[keras.metrics.Accuracy()])
BinaryAccuracy 类
keras.metrics.BinaryAccuracy(name="binary_accuracy", dtype=None, threshold=0.5)
计算预测值与二元标签匹配的频率。
该指标创建两个局部变量 total 和 count，用于计算 y_pred 与 y_true 匹配的频率。此频率最终作为二元准确率返回：一个简单的将 total 除以 count 的幂等操作。
如果 sample_weight 为 None，则权重默认为 1。使用 sample_weight 为 0 来屏蔽值。
参数
- name：(可选) 指标实例的字符串名称。
- dtype：(可选) 指标结果的数据类型。
- threshold：(可选) 一个浮点数，表示决定预测值是否为 1 或 0 的阈值。
示例
>>> m = keras.metrics.BinaryAccuracy()
>>> m.update_state([[1], [1], [0], [0]], [[0.98], [1], [0], [0.6]])
>>> m.result()
0.75
>>> m.reset_state()
>>> m.update_state([[1], [1], [0], [0]], [[0.98], [1], [0], [0.6]],
... sample_weight=[1, 0, 0, 1])
>>> m.result()
0.5
与 compile() API 一起使用
model.compile(optimizer='sgd',
loss='binary_crossentropy',
metrics=[keras.metrics.BinaryAccuracy()])
CategoricalAccuracy 类
keras.metrics.CategoricalAccuracy(name="categorical_accuracy", dtype=None)
计算预测值与独热标签匹配的频率。
你可以将类的 logits 作为 y_pred 提供，因为 logits 和概率的 argmax 是相同的。
该指标创建两个局部变量 total 和 count，用于计算 y_pred 与 y_true 匹配的频率。此频率最终作为分类准确率返回：一个简单的将 total 除以 count 的幂等操作。
y_pred 和 y_true 应该作为概率向量而不是标签传递。如有必要，使用 ops.one_hot 将 y_true 扩展为向量。
如果 sample_weight 为 None，则权重默认为 1。使用 sample_weight 为 0 来屏蔽值。
参数
- name：(可选) 指标实例的字符串名称。
- dtype：(可选) 指标结果的数据类型。
示例
>>> m = keras.metrics.CategoricalAccuracy()
>>> m.update_state([[0, 0, 1], [0, 1, 0]], [[0.1, 0.9, 0.8],
... [0.05, 0.95, 0]])
>>> m.result()
0.5
>>> m.reset_state()
>>> m.update_state([[0, 0, 1], [0, 1, 0]], [[0.1, 0.9, 0.8],
... [0.05, 0.95, 0]],
... sample_weight=[0.7, 0.3])
>>> m.result()
0.3
与 compile() API 一起使用
model.compile(optimizer='sgd',
loss='categorical_crossentropy',
metrics=[keras.metrics.CategoricalAccuracy()])
SparseCategoricalAccuracy 类
keras.metrics.SparseCategoricalAccuracy(
name="sparse_categorical_accuracy", dtype=None
)
计算预测值与整数标签匹配的频率。
acc = np.dot(sample_weight, np.equal(y_true, np.argmax(y_pred, axis=1))
你可以将类的 logits 作为 y_pred 提供，因为 logits 和概率的 argmax 是相同的。
该指标创建两个局部变量 total 和 count，用于计算 y_pred 与 y_true 匹配的频率。此频率最终作为稀疏分类准确率返回：一个简单的将 total 除以 count 的幂等操作。
如果 sample_weight 为 None，则权重默认为 1。使用 sample_weight 为 0 来屏蔽值。
参数
- name：(可选) 指标实例的字符串名称。
- dtype：(可选) 指标结果的数据类型。
示例
>>> m = keras.metrics.SparseCategoricalAccuracy()
>>> m.update_state([[2], [1]], [[0.1, 0.6, 0.3], [0.05, 0.95, 0]])
>>> m.result()
0.5
>>> m.reset_state()
>>> m.update_state([[2], [1]], [[0.1, 0.6, 0.3], [0.05, 0.95, 0]],
... sample_weight=[0.7, 0.3])
>>> m.result()
0.3
与 compile() API 一起使用
model.compile(optimizer='sgd',
loss='sparse_categorical_crossentropy',
metrics=[keras.metrics.SparseCategoricalAccuracy()])
TopKCategoricalAccuracy 类
keras.metrics.TopKCategoricalAccuracy(
k=5, name="top_k_categorical_accuracy", dtype=None
)
计算目标值在 K 个最高预测值中的频率。
参数
- k：(可选) 用于计算准确率的顶部元素数量。默认为
5。 - name：(可选) 指标实例的字符串名称。
- dtype：(可选) 指标结果的数据类型。
示例
>>> m = keras.metrics.TopKCategoricalAccuracy(k=1)
>>> m.update_state([[0, 0, 1], [0, 1, 0]],
... [[0.1, 0.9, 0.8], [0.05, 0.95, 0]])
>>> m.result()
0.5
>>> m.reset_state()
>>> m.update_state([[0, 0, 1], [0, 1, 0]],
... [[0.1, 0.9, 0.8], [0.05, 0.95, 0]],
... sample_weight=[0.7, 0.3])
>>> m.result()
0.3
与 compile() API 一起使用
model.compile(optimizer='sgd',
loss='categorical_crossentropy',
metrics=[keras.metrics.TopKCategoricalAccuracy()])
SparseTopKCategoricalAccuracy 类
keras.metrics.SparseTopKCategoricalAccuracy(
k=5, name="sparse_top_k_categorical_accuracy", dtype=None, from_sorted_ids=False
)
计算整数目标值在 K 个最高预测值中的频率。
默认情况下，update_state() 期望的参数为：- y_true：形状为 (batch_size) 的张量，表示真实类别的索引。- y_pred：形状为 (batch_size, num_categories) 的张量，包含每个样本所有可能类别的得分。
当 from_sorted_ids=True 时，update_state 期望的参数为：- y_true：形状为 (batch_size) 的张量，表示真实类别的索引或 ID。- y_pred：形状为 (batch_size, N) 的张量，包含前 N 个类别的索引或 ID，并按得分从高到低排序。N 必须大于或等于 k。
当类别集合非常大并且模型具有优化方式来检索前几个类别时，from_sorted_ids=True 选项可以更有效，无论是不进行评分还是不维护所有可能类别的得分。
参数
- k：(可选) 用于计算准确率的顶部元素数量。默认为
5。 - name：(可选) 指标实例的字符串名称。
- dtype：(可选) 指标结果的数据类型。
- from_sorted_ids：(可选) 当
False（默认值）时，传入y_pred的张量包含所有可能类别的未排序得分。当True时，y_pred包含前几个类别的索引或 ID。
示例
>>> m = keras.metrics.SparseTopKCategoricalAccuracy(k=1)
>>> m.update_state([2, 1], [[0.1, 0.9, 0.8], [0.05, 0.95, 0]])
>>> m.result()
0.5
>>> m.reset_state()
>>> m.update_state([2, 1], [[0.1, 0.9, 0.8], [0.05, 0.95, 0]],
... sample_weight=[0.7, 0.3])
>>> m.result()
0.3
>>> m = keras.metrics.SparseTopKCategoricalAccuracy(k=1,
... from_sorted_ids=True)
>>> m.update_state([2, 1], [[1, 0, 3], [1, 2, 3]])
>>> m.result()
0.5
与 compile() API 一起使用
model.compile(optimizer='sgd',
loss='sparse_categorical_crossentropy',
metrics=[keras.metrics.SparseTopKCategoricalAccuracy()])