kunfolding: Kemeny-equivalent augmented unfolding

View source: R/kunfolding.R

kunfoldingR Documentation

Kemeny-equivalent augmented unfolding

Description

Kemeny-equivalent augmented unfolding.

Usage

kunfolding(X, p = 2, control = mdscontrol(...), ...)

Arguments

X

A n by m data matrix, in which there are n judges and m objects to be judged. Each row is a ranking of the objects which are represented by the columns.

p

the dimensionality of the solution. Default p=2

control

a list of options that control details of the kunfolding model governed by the function mdscontrol. The options govern the MDS model ("ordinal" or "metric"), the initial configuration ("torgerson", "random" or "user"), the transformation ("primary", "secondary", "tertiary","spline","ratio", "interval","none"), the set of weights, and other related options

...

arguments passed bypassing mdscontrol

Details

The MDS engine is smacofsym from smacof.In a future release other mds algorithms will be implemented. The output consists in a object of the class "kunfolding". It contains:

rawstress raw stress
nrawstress normalized raw stress
stress1 Stress-1
rowcoord row (individuals) coordinates
colcord column (items) coordinates
dhat dhat
dij configuration distance
shepardD DeSarbo I Index
kendallfit Kendall tau_b between transformed and fitted proximities
tauxfit Tau_X between transformed and fitted proximities
avgrecov Averaged recovery measure between raw preference data and fitted proximities
avgedpearson Averaged Pearson correlation between raw preference data and fitted proximities
avgspearman Averaged Spearman rho between raw preference data and fitted proximities
avgkendall Averaged Kendall taub between raw preference data and fitted proximities
avgtaux Averaged Tau_X between raw preference data and fitted proximities
resume Resume meausures
resumerec tab Resume of recovery measures
resumeaug Resume of augmentation matrix
kDelta Kemeny equivalent dissimilarity matrix
beta beta parameter
alpha alpha parameter
interactions n x m interaction submatrix
csi csi parameter
mdssol mds solution as returned by smacof package
n_i number of individuals
n_c number of items
tots total
model mds model
transf transformation used

Value

An object of the class kunfolding. See details for detailed information.

Author(s)

Antonio D'Ambrosio antdambr@unina.it

References

D'Ambrosio, A., Vera, J. F., & Heiser, W. J. (2022). Avoiding degeneracies in ordinal unfolding using Kemeny-equivalent dissimilarities for two-way two-mode preference rank data. Multivariate Behavioral Research, 57(4), 679-699.

See Also

augmatrix

Examples

data("breakfast", package="smacof")
unfout <- kunfolding(breakfast)
itemsl <- colnames(breakfast)
plot(unfout,labs=itemsl)


ConsRankClass documentation built on June 8, 2025, 10:33 a.m.