range.circular: Circular Range

Description

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

Usage

# S3 method for circular
range(x, test=FALSE, na.rm = FALSE, finite = FALSE, 
  control.circular=list(), ...)

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.

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: the attribute of the resulting object.
...: further parameter passed from/to the method.

Author

Claudio Agostinelli and Ulric Lund

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, details can be found in Mardia and Jupp (1999) pag. 107.

References

K.V. Mardia and P.E. Jupp (1999) Directional Statistics, Wiley.

Examples

Run this code

data <- rvonmises(n=50, mu=circular(0), kappa=2)
range(data, test=TRUE)
data <- circular(runif(50, 0, 2*pi))
range(data, test=TRUE)

Run the code above in your browser using DataLab