# circtrans: Circular Transformation Formula In cplots: Plots for Circular Data

 circtrans 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.

`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

```

cplots documentation built on March 24, 2022, 9:05 a.m.