Skip to contents

Show or hide unit points

Usage

qe_points(
  p,
  show = TRUE,
  units = NULL,
  points = NULL,
  color = NULL,
  shape = NULL,
  labels = NULL,
  name = NULL,
  size = NULL,
  fixed_size = FALSE
)

Arguments

p

A qe_plot object.

show

Logical. Default TRUE; FALSE clears all points and point sets.

units

Unit IDs to draw as a point set (a subset of the model's units).

points

An arbitrary points matrix / data frame / ena.points rows (as rENA's ena.plot.points() accepts). IDs come from the model's id column when present; dimensions from the model's x / y columns, else the first two numeric columns.

color

One colour, or one per point. Default: each point's group colour, else a palette colour per set.

shape

"circle" (default), "square", "triangle" or "diamond"; one or one per point. rENA's "triangle-up" is accepted.

labels

Per-point label text (shown per the point label mode).

name

Point-set name; calls with units / points add a set, and a repeated name replaces it. Default "points 1", "points 2", ….

size

Optional numeric dot size. Omit for the default (2.5). Larger values draw bigger dots; the size is relative to the code-node size.

fixed_size

Logical. When TRUE, unit dots keep a constant on-screen pixel size regardless of data extent, container size, or zoom. Default FALSE (dots scale with the coordinate space, like nodes and edges).

Value

The modified qe_plot object.