Skip to contents

Calculates Informedness for the provided confusion matrix. Informedness is a combined measure of Sensitivity (True Positive Rate) and Specificity (True Negative Rate). It reflects the probability that a classifier is informed about the true class, ranging from -1 to 1.

Usage

dx_informedness(cm, detail = "full", boot = FALSE, bootreps = 1000)

dx_youden_j(cm, detail = "full", boot = FALSE, bootreps = 1000)

Arguments

cm

A dx_cm object created by dx_cm().

detail

Character specifying the level of detail in the output: "simple" for raw estimate, "full" for detailed estimate including 95% confidence intervals.

boot

Logical specifying if confidence intervals should be generated via bootstrapping. Note, this can be slow.

bootreps

The number of bootstrap replications for calculating confidence intervals.

Value

Depending on the detail parameter, returns a numeric value representing the calculated metric or a data frame/tibble with detailed diagnostics including confidence intervals and possibly other metrics relevant to understanding the metric.

Details

Informedness is defined as Informedness = Sensitivity + Specificity - 1. It is the sum of the true positive rate and the true negative rate minus one. It's a useful measure when you want to consider both the sensitivity and specificity of a test. A higher informedness indicates better overall performance of the classifier in distinguishing between the classes.

The formula for Informedness is: $$Informedness = Sensitivity + Specificity - 1$$

See also

dx_cm() to understand how to create and interact with a 'dx_cm' object.

dx_sensitivity(), dx_specificity() for components of informedness.

Examples

cm <- dx_cm(dx_heart_failure$predicted, dx_heart_failure$truth, threshold = 0.5, poslabel = 1)
simple_informedness <- dx_informedness(cm, detail = "simple")
detailed_informedness <- dx_informedness(cm)
print(simple_informedness)
#> [1] 0.6141229
print(detailed_informedness)
#> # A tibble: 1 × 8
#>   measure      summary estimate conf_low conf_high fraction conf_type notes     
#>   <chr>        <chr>      <dbl>    <dbl>     <dbl> <chr>    <chr>     <chr>     
#> 1 Informedness 0.61       0.614       NA        NA ""       NA        Specify `…