permutations (version 1.0-9)

permorder: The order of a permutation

Description

Returns the order of a permutation \(P\): the smallest strictly positive integer \(n\) for which \(P^n\) is the identity.

Usage

permorder(x, singly = TRUE)

Arguments

x

Permutation, coerced to cycle form

singly

Boolean, with default TRUE meaning to return the order of each element of the vector, and FALSE meaning to return the order of the vector itself (that is, the smallest strictly positive integer for which all(x^n==id)).

Details

Coerces its argument to cycle form.

The order of the identity permutation is 1.

See Also

sgn

Examples

# NOT RUN {
x <- rperm(5,20)
permorder(x)
permorder(x,FALSE)

stopifnot(all(is.id(x^permorder(x))))
stopifnot(is.id(x^permorder(x,FALSE)))
# }