parsec (version 1.2.0)

average_ranks: Average Ranks

Description

The function evaluates the average rank (and other details of their distributions) for each element of the poset.

Usage

average_ranks(x, ...)
# S3 method for cover
average_ranks(x, level = 0.9, error = 10^(-5), ...)
# S3 method for incidence
average_ranks(x, level = 0.9, error = 10^(-5), ...)

Arguments

x

an incidence or cover matrix representing a partial order.

level

coverage probability of the rank intervals.

error

the "distance" from uniformity in the sampling distribution of linear extensions used to evaluate the average ranks. See idn for details.

…

any of above.

Value

A dataframe of class average_ranks whose columns are:

avrg

the average rank;

inf

the lower extreme of the rank interval;

sup

the upper extreme of the rank interval;

prob

the effective coverage probability of the rank interval;

min

the minimum rank;

max

the maximum rank;

range

the rank range.

Details

The function evaluates the rank distribution for each element of the poset through the function idn. Then it determines if there are any equivalent profiles through the function equivalences and it uniforms their rank distribution. Finally it provides a dataframe that for each element of the poset contains the average rank avrg, the extremes inf and sup of the rank interval, the effective coverage probability of the rank interval prob, the estimated minimum and maximum rank values (min and max), the rank range.

The output is a dataframe of class of class average_ranks, that has a method of the function plot. See plot.average_ranks for details.

See Also

idn, equivalences, plot.average_ranks

Examples

# NOT RUN {
profiles <- var2prof(varlen = c(3, 2, 2))
Z <- getzeta(profiles)
res <- average_ranks(Z)
plot(res)
# }