Background environment layer — geom_xnicher

A self-contained ggplot2 layer that draws the environmental background env_m as a faint point cloud in 2-D environmental space. Designed to be composed with geom_xnicher_occ and geom_xnicher_ellipse via the + operator.

Usage

geom_xnicher_background(
  env_m,
  var_names = NULL,
  size = 0.3,
  alpha = 0.25,
  colour = "grey60",
  ...
)

Arguments

env_m: Matrix or data frame with at least two columns. Only the first two columns are used (positional indexing).
var_names: Optional character vector of length 2 used to name the columns of the layer's internal data frame. Defaults to c("x1", "x2").
size, alpha, colour: Aesthetic parameters; defaults are tuned for a discreet background layer.
...: Additional fixed parameters passed to the underlying ggplot2::geom_point.

Value

A ggplot2 layer.

Examples

# \donttest{
  library(ggplot2)
  ggplot() + geom_xnicher_background(example_env_m_2d)

# }