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

tf.metrics.recall_at_thresholds函數(shù)

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

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

用于計(jì)算predictions上不同的thresholds的各種recall值.

該recall_at_thresholds函數(shù)為各種閾值創(chuàng)建了四個(gè)局部變量：true_positives,true_negatives,false_positives和false_negatives值.recall[i]被定義為大于thresholds[i]的predictions的值的總權(quán)重,其中它在labels的相應(yīng)的條目是True,除以labels中的True值的總權(quán)重,即：(true_positives[i] / (true_positives[i] + false_negatives[i]))

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

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

參數(shù)：

• labels：正確標(biāo)記(ground truth),Tensor的維度必須匹配predictions,將被轉(zhuǎn)換為bool.
• predictions：任意形狀的浮點(diǎn)Tensor,其值在該[0, 1]范圍內(nèi).
• thresholds：一個(gè)python列表或[0, 1]中浮動(dòng)閾值的元組.
• weights：可選的Tensor,其秩為0或與labels具有相同等級(jí),并且必須可廣播到labels(即,所有維度必須為1或者與相應(yīng)的labels維度相同).
• metrics_collections：recall應(yīng)添加到的集合的可選列表.
• updates_collections：update_op應(yīng)添加到的集合的可選列表.
• name：可選的variable_scope名稱.

返回：

• recall：一個(gè)具有形狀[len(thresholds)]的浮動(dòng)Tensor.
• update_op：表示遞增true_positives,true_negatives,false_positives和false_negatives變量的操作,在計(jì)算recall中使用.

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

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