BayesMallows (version 1.4.0)

metropolis_hastings_alpha: Metropolis-Hastings Alpha

Description

Function to perform Metropolis-Hastings for new rho under the Mallows model with footrule distance metric!

Usage

metropolis_hastings_alpha(
  alpha,
  n_items,
  rankings,
  rho,
  logz_estimate,
  cardinalities,
  metric = "footrule",
  alpha_prop_sd = 0.5,
  alpha_max = 1e+06,
  lambda = 0.1
)

Value

alpha or alpha_prime: Numeric value to be used as the proposal of a new alpha

Arguments

alpha

Numeric value of the scale parameter

n_items

Integer is the number of items in a ranking

rankings

the observed rankings, i.e, preference data

rho

Numeric vector specifying the current consensus ranking

logz_estimate

Estimate grid of log of partition function, computed with estimate_partition_function.

cardinalities

Cardinalities for exact computation of partition function, returned from prepare_partition_function.

metric

A character string specifying the distance metric to use in the Bayesian Mallows Model. Available options are "footrule", "spearman", "cayley", "hamming", "kendall", and "ulam".

alpha_prop_sd

Numeric value specifying the standard deviation of the lognormal proposal distribution used for \(\alpha\) in the Metropolis-Hastings algorithm. Defaults to 0.1.

alpha_max

Maximum value of alpha in the truncated exponential prior distribution.

lambda

Strictly positive numeric value specifying the rate parameter of the truncated exponential prior distribution of \(\alpha\). Defaults to 0.1. When n_cluster > 1, each mixture component \(\alpha_{c}\) has the same prior distribution.

Author

Anja Stein

Details

rankings is a matrix of size \(N \)\(\times\)\( n_items\) of rankings in each row. Alternatively, if \(N\) equals 1, rankings can be a vector.

Examples

rho <- c(1, 2, 3, 4, 5, 6)
alpha <- 2
metric <- "footrule"
n_items <- 6
rankings <- sample_mallows(
  rho0 = rho, alpha0 = alpha, n_samples = 10, burnin = 1000, thinning = 500
)

# Copmute exact partition function
cardinalities <- prepare_partition_function(metric = metric,
                                            n_items = n_items)$cardinalities

metropolis_hastings_alpha(
  alpha, n_items, rankings, rho, logz_estimate = NULL,
  cardinalities = cardinalities, alpha_prop_sd = 0.5,
  lambda = 0.1, alpha_max = 20, metric
)

metropolis_hastings_alpha(
  alpha, n_items, rankings, rho, logz_estimate = NULL,
  cardinalities = cardinalities, alpha_prop_sd = 0.15, lambda = 0.1,
  alpha_max = 20, metric
)

metropolis_hastings_alpha(
  alpha, n_items, rankings, rho, logz_estimate = NULL,
  cardinalities = cardinalities, alpha_prop_sd = 0.5, lambda = 0.15,
  alpha_max = 20, metric
)

metropolis_hastings_alpha(
  alpha, n_items, rankings, rho, logz_estimate = NULL,
  cardinalities = cardinalities, alpha_prop_sd = 0.15, lambda = 0.15,
  alpha_max = 20, metric
)