riskyr (version 0.1.0)

FDR: The false detection rate of a decision process or diagnostic procedure.

Description

FDR defines a decision's false detection (or false discovery) rate (FDR): The conditional probability of the condition being FALSE provided that the decision is positive.

Usage

FDR

Format

An object of class numeric of length 1.

Details

Understanding or obtaining the false detection fate or false discovery rate (FDR):

• Definition: FDR is the conditional probability for the condition being FALSE given a positive decision:

  FDR = p(condition = FALSE | decision = positive)

• Perspective: FDR further classifies the subset of dec.pos individuals by condition (FDR = fa/dec.pos = fa/(hi + fa)).

• Alternative names: false discovery rate

• Relationships:

  a. FDR is the complement of the positive predictive value PPV:

  FDR = 1 - PPV

  b. FDR is the opposite conditional probability -- but not the complement -- of the false alarm rate fart:

  fart = p(decision = positive | condition = FALSE)

• In terms of frequencies, FDR is the ratio of fa divided by dec.pos (i.e., hi + fa):

  FDR = fa/dec.pos = fa/(hi + fa)

• Dependencies: FDR is a feature of a decision process or diagnostic procedure and a measure of incorrect decisions (positive decisions that are actually FALSE).

  However, due to being a conditional probability, the value of FDR is not intrinsic to the decision process, but also depends on the condition's prevalence value prev.

References

Consult Wikipedia for additional information.

See Also

comp_FDR computes FDR as the complement of PPV; prob contains current probability information; comp_prob computes current probability information; num contains basic numeric parameters; init_num initializes basic numeric parameters; comp_freq computes current frequency information; is_prob verifies probability inputs.

Other probabilities: FOR, NPV, PPV, fart, mirt, ppod, prev, sens, spec

Examples

# NOT RUN {
FDR <- .45     # => sets a false discovery rate (FDR) of 45%
FDR <- 45/100  # => (condition = FALSE) for 45 out of 100 people with (decision = positive)
is_prob(FDR)   # => TRUE (as FDR is a probability)
# }