circtrans {cplots}R Documentation

Circular Transformation Formula

Description

The function performs circular transformation of density or frequency, in an area-proportional or height-proportional manner.

Usage

circtrans(x, radius = 0, area.prop = TRUE, factor = 1)

Arguments

x

a numeric vector storing angular values between 0 and 2 pi, or an object that can be coerced to.

radius

the radius of the reference circle.

area.prop

logical; if TRUE, an area-proportional transformation is applied; if FALSE, a height-proportional transformationis applied.

factor

a positive number representing the scale factor to scale the entire plot.

Value

A numerical vector of the transformed values

Author(s)

Danli Xu <dxu452@aucklanduni.ac.nz>, Yong Wang <yongwang@auckland.ac.nz>

References

Xu, D. and Wang, Y. (2020) Area-proportional Visualization for Circular Data. Journal of Computational and Graphical Statistics, 29, 351-357.

See Also

scalefactor

Examples

library(circular)
x = as.vector(rvonmises(20, circular(pi), 10))
circtrans(x)                            # area-proportional transformation
circtrans(x, area.prop = FALSE)         # height-proportional transformation
circtrans(x, factor = 2)                # with a scaling factor


[Package cplots version 0.5-0 Index]