post_hoc_est: Post hoc estimations

View source: R/prevalence_calc.R

post_hoc_estR Documentation

Post hoc estimations

Description

This function provides probabilistic statements about the composition of a sample after application of a certain test procedure. For this purpose a Binomial distribution is used.

Usage

post_hoc_est(
  combination_method,
  A_threshold,
  B_threshold,
  C_threshold,
  baserate_hp,
  devices,
  samplesize,
  min_number = NULL,
  min_prob = NULL
)

Arguments

combination_method

Number (1 to 18) corresponding to the test method.

A_threshold

(scalar integer) Threshold for Test A (1 to 6).

B_threshold

(scalar integer) Threshold for Test B (1 to 6).

C_threshold

(scalar integer) Threshold for Test C (1 to 6).

baserate_hp

Sets the (estimated) prevalence of headphones in the target population as a number between 0 and 1. Defaults to the unbiased prevalence B of 0.1767 from \insertCiteHALT_2;textualHALT.

devices

Sets the desired playback device. Possible settings are "HP" for headphones or "LS" for loudspeakers.

samplesize

number of participants classified as users of the target device

min_number

minimum number of participants k who passed the test procedure and should have used the correct device. When you use min_number you cannot use min_prob, i.e. min_prob = NULL.

min_prob

Probability (greater than 0, less than 1) for the event that at least an unknown number of participants k who passed the test procedure used the correct device. When you use min_prob you cannot use min_number, i.e. min_number = NULL.

Details

Given a test procedure, prevalence, and sample size the event that at least k participants who passed the test procedure used the correct device is considered. The function either calculates the minimum probability for this event for a given k or k for a given probability for this event.

Note

Only one of the arguments min_number and min_prob can be used.

References

\insertAllCited

klausfrieler/HALT documentation built on March 17, 2023, 6:18 a.m.