circular (version 0.4-93)

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(), ...)

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.

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.

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.

See Also

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

Examples

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