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()).
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).