PerMallows (version 1.14)

lgmm: Learn a Generalized Mallows Model

Description

Learn the parameter of the distribution of a sample of n permutations comming from a Generalized Mallows Model (GMM).

Usage

lgmm(
  data,
  sigma_0_ini = identity.permutation(dim(data)[2]),
  dist.name = "kendall",
  estimation = "approx"
)

Value

A list with the parameters of the estimated distribution: the mode and the dispersion parameter vector

Arguments

data

the matrix with the permutations to estimate

sigma_0_ini

optional the initial guess for the consensus permutation

dist.name

optional name of the distance used by the GMM. One of: kendall (default), cayley, hamming

estimation

optional select the approximated or the exact. One of: approx, exact

References

"Ekhine Irurozki, Borja Calvo, Jose A. Lozano (2016). PerMallows: An R Package for Mallows and Generalized Mallows Models. Journal of Statistical Software, 71(12), 1-30. doi:10.18637/jss.v071.i12"

Examples

data <- matrix(c(1,2,3,4, 1,4,3,2, 1,2,4,3), nrow = 3, ncol = 4, byrow = TRUE)
lgmm(data, dist.name="kendall", estimation="approx")
lgmm(data, dist.name="cayley", estimation="approx")
lgmm(data, dist.name="cayley", estimation="exact")
lgmm(data, dist.name="hamming", estimation="approx")