range.circular {circular}R Documentation

Circular Range

Description

Computes the circular range of a data set and performs a test of uniformity if specified.

Usage

range.circular(x, test=FALSE, na.rm = FALSE, finite = FALSE, control.circular=list(), ...)

Arguments

x a vector. The object is coerced to class circular.
test logical flag: if TRUE then the test of uniformity is performed; otherwise the test is not performed. Default is FALSE.
na.rm logical, indicating if NA's should be omitted.
finite logical, indicating if all non-finite elements should be omitted.
control.circular
... further parameter passed from/to the method.

Details

The circular range is the shortest arc on the circle containing the entire set of data. The p-value is computed using the exact distribution of the circular range under the hypothesis of uniformity.

Value

Returns the circular range as a circular object. If the significance test is requested the p-value of the test is returned as p.value.

Author(s)

Claudio Agostinelli and Ulric Lund

References

Jammalamadaka, S. Rao and SenGupta, A. (2001). Topics in Circular Statistics, Section 7.4, World Scientific Press, Singapore.

See Also

kuiper.test, rao.spacing.test, rayleigh.test and watson.test.

Examples

data <- rvonmises(n=50, mu=circular(0), kappa=2)
range(data, test=TRUE)
data <- circular(runif(50, 0, 2*pi))
range(data, test=TRUE)
[Package circular version 0.3-8 Index]