DistanceFromRank {DistatisR}R Documentation

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)

Arguments

X

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

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 kth 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).

Value

DistanceFromRank returns an I\times I \times K array of distance.

Author(s)

Herve Abdi

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)


[Package DistatisR version 1.1.1 Index]