TensorFlow函數：tf.metrics.recall

tf.metrics.recall函數

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

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

計算有關labels的predictions的recall.

該recall函數創(chuàng)建兩個局部變量,true_positives和false_negatives,它們被用于計算recall.這個值最終返回為recall,這是一個冪等操作,true_positives除以true_positives和false_negatives的和.

為了估計數據流上的度量,該函數創(chuàng)建一個update_op操作來更新這些變量并返回變量recall.update_op通過weights中相應的值對每個預測進行加權.

如果weights是None,則權重默認為1,使用權重0來屏蔽值.

參數：

• labels：正確標記(ground truth),Tensor的維度必須匹配predictions,將被轉換為bool.
• predictions：預測值,任意維度的Tensor,將被轉換為bool.
• weights：可選的Tensor,其秩為0或與labels具有相同的秩,并且必須可廣播到labels(即,所有維度必須為1或者相應的labels維度相同).
• metrics_collections：recall應添加到的集合的可選列表.
• updates_collections：update_op應添加到的集合的可選列表.
• name：可選的variable_scope名稱.

返回：

• recall：標量浮點Tensor值,true_positives除以true_positives和false_negatives的和.
• update_op：適當增加true_positives和false_negatives變量的操作,其值匹配recall.

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

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