TensorFlow函數(shù)：tf.metrics.mean_cosine_distance

tf.metrics.mean_cosine_distance函數(shù)

tf.metrics.mean_cosine_distance(
    labels,
    predictions,
    dim,
    weights=None,
    metrics_collections=None,
    updates_collections=None,
    name=None
)

定義在：tensorflow/python/ops/metrics_impl.py.

計(jì)算labels和predictions之間的余弦距離.

該mean_cosine_distance函數(shù)創(chuàng)建兩個(gè)局部變量,total和count,它們被用來(lái)計(jì)算predictions和labels之間的平均余弦距離.該平均是通過(guò)weights來(lái)加權(quán),并且最終返回mean_distance,這是等冪操作,簡(jiǎn)單地使用count除total.

為了估計(jì)數(shù)據(jù)流上的度量,該函數(shù)創(chuàng)建一個(gè)update_op操作來(lái)更新這些變量并返回mean_distance.

如果weights是None,則權(quán)重默認(rèn)為1,使用權(quán)重0來(lái)屏蔽值.

參數(shù)：

• labels：任意形狀的Tensor.
• predictions：與labels具有相同形狀的Tensor.
• dim：計(jì)算余弦距離的維數(shù).
• weights：可選的Tensor,其秩為0或與labels具有相同的秩,并且必須可廣播到labels(即,所有維度必須為1或者與相應(yīng)的labels維度相同).另外,維度dim必須是1.
• metrics_collections：應(yīng)添加度量值變量的集合的可選列表.
• updates_collections：應(yīng)添加度量標(biāo)準(zhǔn)更新操作的集合的可選列表.
• name：可選的variable_scope名稱.

返回：

• mean_distance：代表當(dāng)前均值的Tensor,count除以total的值.
• update_op：是一個(gè)適當(dāng)增加total和count變量的操作.

可能引發(fā)的異常：

• ValueError：如果predictions和labels具有不匹配的形狀,或者weights不是None,并且它的形狀與predictions不匹配,或者如果metrics_collections或updates_collections中任意一個(gè)不是一個(gè)列表或元組.
• RuntimeError：如果啟用了急切執(zhí)行.