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()).
prob_best(m, highest_is_best = FALSE)A named numeric vector of probabilities (names corresponding to
arms).
a matrix with one column per trial arm (named as the arms) and one
row for each draw from the posterior distributions.
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).