Make mean resultant length arrow

Computes the circular mean direction and resultant length, returning a `geom_segment()` layer that can be added to an existing ggplot.

Usage

directedness_arrow(
  data,
  angle_col,
  arrow_head_cm = 0.2,
  colour = "gray",
  size = 2,
  color = NULL
)

Arguments

data

Data frame containing the angle column.

angle_col

Column containing angles in radians.

arrow_head_cm

Length of the arrowhead in centimetres.

colour, color

Colour of the arrow. `color` is the American-spelling alias.

size

Width of the arrow segment (applied to the geom's `linewidth`).

Value

A `geom_segment()` layer.

Examples

# Arrow showing mean direction and resultant length
hd <- derive_headings(cpunctatus[1:5], rule = "distal")
library(ggplot2)
ggplot() +
  coord_fixed() +
  add_circ() +
  directedness_arrow(hd, angle_col = "heading")