計算給定值的(加權)平均值。
用法
tf.compat.v1.metrics.mean(
values, weights=None, metrics_collections=None, updates_collections=None,
name=None
)
參數
-
values
任意維度的Tensor
。 -
weights
可選Tensor
,其秩為0,或與values
相同的秩,並且必須可廣播到values
(即,所有維度必須是1
,或與相應的values
維度相同) . -
metrics_collections
mean
應添加到的可選集合列表。 -
updates_collections
update_op
應添加到的可選集合列表。 -
name
可選的 variable_scope 名稱。
返回
-
mean
ATensor
表示當前平均值,total
的值除以count
。 -
update_op
適當增加total
和count
變量並且其值與mean_value
匹配的操作。
拋出
-
ValueError
如果weights
不是None
並且其形狀與values
不匹配,或者如果metrics_collections
或updates_collections
不是列表或元組。 -
RuntimeError
如果啟用了即刻執行。
遷移到 TF2
警告:這個 API 是為 TensorFlow v1 設計的。繼續閱讀有關如何從該 API 遷移到本機 TensorFlow v2 等效項的詳細信息。見TensorFlow v1 到 TensorFlow v2 遷移指南有關如何遷移其餘代碼的說明。
tf.compat.v1.metrics.mean
與即刻執行或 tf.function
不兼容。請改用tf.keras.metrics.Mean
進行 TF2 遷移。實例化tf.keras.metrics.Mean
對象後,可以先調用update_state()
方法記錄新值,然後調用result()
方法即刻求平均值。您還可以使用 add_metric
方法將其附加到 Keras 模型。有關詳細信息,請參閱遷移指南。
到 TF2 的結構映射
前:
mean, update_op = tf.compat.v1.metrics.mean(
values=values,
weights=weights,
metrics_collections=metrics_collections,
update_collections=update_collections,
name=name)
後:
m = tf.keras.metrics.Mean(
name=name)
m.update_state(
values=values,
sample_weight=weights)
mean = m.result()
如何映射參數
TF1 參數名稱 | TF2 參數名稱 | 注意 |
---|---|---|
values |
values |
在update_state() 方法中 |
weights |
sample_weight |
在update_state() 方法中 |
metrics_collections
|
不支持 | 應顯式跟蹤指標或使用 Keras API,例如add_metric,而不是通過集合 |
updates_collections |
不支持 | - |
name |
name |
在構造函數中 |
使用示例之前和之後
前:
g = tf.Graph()
with g.as_default():
values = [1, 2, 3]
mean, update_op = tf.compat.v1.metrics.mean(values)
global_init = tf.compat.v1.global_variables_initializer()
local_init = tf.compat.v1.local_variables_initializer()
sess = tf.compat.v1.Session(graph=g)
sess.run([global_init, local_init])
sess.run(update_op)
sess.run(mean)
2.0
後:
m = tf.keras.metrics.Mean()
m.update_state([1, 2, 3])
m.result().numpy()
2.0
# Used within Keras model
model.add_metric(tf.keras.metrics.Mean()(values))
mean
函數創建兩個局部變量 total
和 count
用於計算 values
的平均值。該平均值最終返回為 mean
,這是一個冪等運算,隻需將 total
除以 count
。
為了估計數據流上的度量,該函數創建一個 update_op
操作來更新這些變量並返回 mean
。 update_op
將 total
與 values
和 weights
的乘積之和相加,並以 weights
之和的減小之和增加 count
。
如果 weights
是 None
,則權重默認為 1。使用權重 0 來屏蔽值。
相關用法
- Python tf.compat.v1.metrics.accuracy用法及代碼示例
- Python tf.compat.v1.mixed_precision.enable_mixed_precision_graph_rewrite用法及代碼示例
- Python tf.compat.v1.map_fn用法及代碼示例
- Python tf.compat.v1.make_template用法及代碼示例
- Python tf.compat.v1.multinomial用法及代碼示例
- Python tf.compat.v1.math.log_softmax用法及代碼示例
- Python tf.compat.v1.mixed_precision.MixedPrecisionLossScaleOptimizer用法及代碼示例
- Python tf.compat.v1.math.softmax用法及代碼示例
- Python tf.compat.v1.distributions.Multinomial.stddev用法及代碼示例
- Python tf.compat.v1.distribute.MirroredStrategy.experimental_distribute_dataset用法及代碼示例
- Python tf.compat.v1.data.TFRecordDataset.interleave用法及代碼示例
- Python tf.compat.v1.distributions.Bernoulli.cross_entropy用法及代碼示例
- Python tf.compat.v1.Variable.eval用法及代碼示例
- Python tf.compat.v1.train.FtrlOptimizer.compute_gradients用法及代碼示例
- Python tf.compat.v1.layers.conv3d用法及代碼示例
- Python tf.compat.v1.strings.length用法及代碼示例
- Python tf.compat.v1.data.Dataset.snapshot用法及代碼示例
- Python tf.compat.v1.data.experimental.SqlDataset.reduce用法及代碼示例
- Python tf.compat.v1.feature_column.categorical_column_with_vocabulary_file用法及代碼示例
- Python tf.compat.v1.data.TextLineDataset.from_tensors用法及代碼示例
注:本文由純淨天空篩選整理自tensorflow.org大神的英文原創作品 tf.compat.v1.metrics.mean。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。