Arguments
- prev
The condition's prevalence
prev(i.e., the probability of condition beingTRUE).- sens
The decision's sensitivity
sens(i.e., the conditional probability of a positive decision provided that the condition isTRUE).- spec
The decision's specificity value
spec(i.e., the conditional probability of a negative decision provided that the condition isFALSE).
Value
Overall error rate err as a probability (proportion).
A warning is provided for NaN values.
Details
comp_err uses comp_acc to
compute err as the
complement of acc:
err = 1 - acc
See comp_acc and acc
for further details and
accu for other accuracy metrics
and several possible interpretations of accuracy.
See also
comp_acc computes overall accuracy acc from probabilities;
accu lists all accuracy metrics;
comp_accu_prob computes exact accuracy metrics from probabilities;
comp_accu_freq computes accuracy metrics from frequencies;
comp_sens and comp_PPV compute related probabilities;
is_extreme_prob_set verifies extreme cases;
comp_complement computes a probability's complement;
is_complement verifies probability complements;
comp_prob computes current probability information;
prob contains current probability information;
is_prob verifies probabilities.
Other functions computing probabilities:
comp_FDR(),
comp_FOR(),
comp_NPV(),
comp_PPV(),
comp_acc(),
comp_accu_freq(),
comp_accu_prob(),
comp_comp_pair(),
comp_complement(),
comp_complete_prob_set(),
comp_fart(),
comp_mirt(),
comp_ppod(),
comp_prob(),
comp_prob_freq(),
comp_sens(),
comp_spec()
Other metrics:
acc,
accu,
comp_acc(),
comp_accu_freq(),
comp_accu_prob(),
err
Examples
# ways to work:
comp_err(.10, .200, .300) # => err = 0.71
#> [1] 0.71
comp_err(.50, .333, .666) # => err = 0.5005
#> [1] 0.5005
# watch out for vectors:
prev.range <- seq(0, 1, by = .1)
comp_err(prev.range, .5, .5) # => 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5
#> [1] 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5 0.5
# watch out for extreme values:
comp_err(1, 1, 1) # => 0
#> [1] 0
comp_err(1, 1, 0) # => 0
#> [1] 0
comp_err(1, 0, 1) # => 1
#> [1] 1
comp_err(1, 0, 0) # => 1
#> [1] 1
comp_err(0, 1, 1) # => 0
#> [1] 0
comp_err(0, 1, 0) # => 1
#> [1] 1
comp_err(0, 0, 1) # => 0
#> [1] 0
comp_err(0, 0, 0) # => 1
#> [1] 1