comp_fart: Compute a decision's false alarm rate from its specificity.

In riskyr: Rendering Risk Literacy more Transparent

Compute a decision's false alarm rate from its specificity.

Description

comp_fart is a conversion function that takes a specificity spec – given as a probability (i.e., a numeric value in the range from 0 to 1) – as its input, and returns the corresponding false alarm rate fart – also as a probability – as its output.

Usage

comp_fart(spec)

Arguments

spec	The decision's specificity value spec as a probability.

Details

The false alarm rate fart and specificity spec are complements (fart = (1 - spec)) and both features of the decision process (e.g., a diagnostic test).

The function comp_fart is complementary to the conversion function comp_spec and uses the generic function comp_complement.

Value

The decision's false alarm rate fart as a probability.

See Also

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_accu_freq(), comp_accu_prob(), comp_acc(), comp_comp_pair(), comp_complement(), comp_complete_prob_set(), comp_err(), comp_mirt(), comp_ppod(), comp_prob_freq(), comp_prob(), comp_sens(), comp_spec()

Examples

comp_fart(2)                       # => NA + warning (beyond range)
comp_fart(1/3)                     # => 0.6666667
comp_fart(comp_complement(0.123))  # => 0.123

riskyr documentation built on Aug. 15, 2022, 9:09 a.m.