R/randomeloextract.R

In EloRating: Animal Dominance Hierarchies by Elo Rating

#' extract ratings from random sequences based on an interaction matrix
#'
#' extract ratings from random sequences based on an interaction matrix
#'
#' @param x output from \code{\link{randomelo}}
#' @param ID character, ID
#' @param mode character, one of three: 1) \code{"obj"}: a random value from all
#'        the sequences; 2) \code{"samp"}: a random value sampled from a normal
#'        distribution with mean and sd of all randomized values; 3)
#'        \code{"avg"}: the average value from all the runs
#'
#' @return numeric
#'
#' @author Christof Neumann
#'
#' @export
#'
#' @importFrom stats rnorm
#'
#' @examples
#' data(adv)
#' elores <- elo.seq(winner = adv$winner, loser = adv$loser, Date = adv$Date)
#' mat <- creatematrix(elores)
#' res <- randomelo(mat, runs = 10)
#' randomeloextract(res, "a", "samp")
#' randomeloextract(res, "a", "obj")
#' randomeloextract(res, "a", "avg")

randomeloextract <- function(x,
                             ID,
                             mode = c("obj", "samp", "avg")) {
  if (!ID %in% colnames(x[[1]])) {
    stop("selected ID is not in the matrix", call. = FALSE)
  }

  if (mode == "obj") {
    return(sample(x[[1]][, ID], 1))
  }

  if (mode == "samp") {
    rd <- rnorm(1, mean(x[[1]][, ID]), sd(x[[1]][, ID]))
    return(round(rd, 1))
  }

  if (mode == "avg") {
    return(round(mean(x[[1]][, ID]), 1))
  }
}