Skip to contents

Overlay a fitted wrapped Cauchy density curve on a radiate plot

Source: R/circular_plotting.R
add_wrappedcauchy_density.Rd

Evaluates dwrappedcauchy on a fine angular grid and draws it as a closed polygon in the same Cartesian space as radiate. Intended as a visual companion to add_vonmises_density: overlaying both curves shows whether the data favour the lighter-tailed von Mises or the heavier-tailed wrapped Cauchy.

Usage

add_wrappedcauchy_density(
  fit,
  scale = 0.4,
  inner_r = 0,
  group_col = NULL,
  n_pts = 360L,
  colour = "darkorange",
  linewidth = 0.8,
  fill = NA,
  alpha = 0.8,
  display = NULL
)

Arguments

fit

Data frame from wrappedcauchy_fit, containing at least mu and rho columns.

scale

Maximum outer radius as a fraction of the unit circle. Default 0.4.

inner_r

Inner radius. Default 0.

group_col

Column for faceting; must match panel_by in the parent radiate() call.

n_pts

Angular evaluation points. Default 360L.

colour

Outline colour. Default "darkorange".

linewidth

Outline width. Default 0.8.

fill

Fill colour. Default NA (outline only).

alpha

Opacity. Default 0.8.

display

A `circ_display()` controlling rotation, matching the parent `radiate()` plot. Default `NULL` uses the input's `display` attribute when present, otherwise the identity display.

Value

A geom_polygon layer, or NULL if estimation fails.

Details

Default colour is "darkorange" to distinguish from add_vonmises_density ("steelblue") and add_circular_kde ("tomato").

See also

add_vonmises_density, add_circular_kde