prob_best: Calculate the probabilities of each arm being the best

In adaptr: Adaptive Trial Simulator

Calculate the probabilities of each arm being the best

Description

Used internally. This function takes a matrix as calculated by the get_draws_binom(), get_draws_norm() or a corresponding custom function (as specified using the fun_draws argument in setup_trial(); see get_draws_generic()) and calculates the probabilities of each arm being the best (defined as either the highest or the lowest value, as specified by the highest_is_best argument in setup_trial(), setup_trial_binom() or setup_trial_norm()).

Usage

prob_best(m, highest_is_best = FALSE)

Arguments

m	a matrix with one column per trial arm (named as the arms) and one row for each draw from the posterior distributions.
highest_is_best	single logical, specifies whether larger estimates of the outcome are favourable or not; defaults to FALSE, corresponding to, e.g., an undesirable binary outcomes (e.g., mortality) or a continuous outcome where lower numbers are preferred (e.g., hospital length of stay).

Value

A named numeric vector of probabilities (names corresponding to arms).

adaptr documentation built on May 29, 2024, 7:48 a.m.