DistatisR (version 1.1.1)

DistanceFromRank: DistanceFromRank: Creates a 3-dimensional distance array from the results of a ranking task.

Description

DistanceFromRank: Takes the results from a (plain) ranking task where \(K\) assessors rank (with possible ties) \(I\) observations on one dimension and transform it into a brick of data to be used by distatis.

Usage

DistanceFromRank(X)

Value

DistanceFromRank returns an

\(I\times I \times K\)

array of distance.

Arguments

X

gives the results of a ranking task (see example below) as an objects (rows) by assessors (columns) matrix.

Author

Herve Abdi

Details

DistanceFromRank creates an \(I \times I \times K\) array of distance in which each of the \(K\) "slices" stores the (squared Euclidean ranking) distance matrix of the \(k\)th assessor. In one of these distance matrices, the distance between two objects is computed from he Pythagorean theorem. The ouput ot the function DistanceFromRank is used as input for the function distatis.

The input should have assessors as columns and observations as rows (see example below).

See Also

distatis DistanceFromSort

Examples

# Use the data set WinesRankingRawData stored in an excel file.
path2file <- system.file("extdata",
           "WinesRankingRawData.xlsx", package = 'DistatisR')
ranking6Wines <- read.df.excel(path = path2file, sheet = 'Ranking')
aCubeOfDistance <- DistanceFromRank(ranking6Wines$df.data)