pval_fixed: Determine p-values in a single-stage single-arm trial design...
In mjg211/singlearm: Design and analysis of single-arm clinical trials

Description Usage Arguments Details Value See Also Examples

Determines all possible p-values at the end of a single-stage single-arm trial for a single binary endpoint, as determined using des_fixed(). Support is available to compute p-values using exact binomial tail probabilities, or using a normal approximation.

1	pval_fixed(des, pi, method = c("exact", "normal"), summary = F)

`des`	An object of class `"sa_des_fixed"`, as returned by `des_fixed()`.
`pi`	A vector of response probabilities to evaluate the expected performance of the p-value calculation procedure at. This will internally default to be the π₀ and π₁ from `des` if it is left unspecified.
`method`	A vector of methods to use to construct p-values. Currently, support is available to use exact binomial tail probabilities (`"exact"`) and to use a normal approximation (`"normal"`) approach.
`summary`	A logical variable indicating whether a summary of the function's progress should be printed to the console.

In addition, the performance of the chosen p-value calculation procedures (including their expected value and variance) for each value of pi in the supplied vector pi, will also be evaluated.

A list of class "sa_pval_fixed" containing the following elements

A tibble in the slot $pval summarising the possible p-values at the end of the trial for the supplied design, according to the chosen methods.
A tibble in the slot $perf summarising the performance of the chosen p-value calculation procedures for each specified value of π.
Each of the input variables as specified, subject to internal modification.

des_fixed, opchar_fixed, est_fixed, ci_fixed, and their associated plot family of functions.

# Find the optimal single-stage design for the default parameters
des  <- des_fixed()
# Determine the performance of both supported p-value calculation procedures
# for a range of possible response probabilities
pval <- pval_fixed(des, pi = seq(0, 1, 0.01))