Select which edge network to draw — qe

Controls edge rendering. Supply either a group name (group) or a specific unit ID (unit) as the primary edge source; compare or also optionally bring in a second group for subtraction or overlay. Omitting both group and unit (or calling qe_edges(show = FALSE)) suppresses the edge network entirely, leaving only group means and unit points visible.

Usage

qe_edges(
  p,
  group = NULL,
  unit = NULL,
  compare = NULL,
  also = NULL,
  show = TRUE
)

Arguments

p: A qe_plot object.
group: Name of the primary group whose mean edge network to draw. Must match a value in the model's group column. Mutually exclusive with unit.
unit: ID of a single unit whose individual edge network to draw (e.g. "FirstGame::steven z"). Mutually exclusive with group. compare and also are not supported when unit is supplied.
compare: Name of a second group to subtract (group − compare). Positive differences use the primary colour; negative use the secondary. Cannot be combined with unit.
also: Name of a second group to overlay alongside group. Cannot be combined with unit.
show: Logical. FALSE suppresses all edge rendering regardless of other arguments. Default TRUE.

Value

The modified qe_plot object.

Details

Use qe_units() to inspect the unit IDs present in the model.

Examples

if (FALSE) { # \dontrun{
# Single group mean network
qe_plot(set) |> qe_edges("FirstGame")

# Individual unit network
qe_plot(set) |> qe_edges(unit = "FirstGame::steven z")

# Individual unit + show all group means
qe_plot(set) |> qe_group() |> qe_edges(unit = "FirstGame::steven z")

# Subtraction
qe_plot(set) |> qe_edges("FirstGame", compare = "SecondGame")

# Overlay
qe_plot(set) |> qe_edges("FirstGame", also = "SecondGame")

# No edges (means and/or points only)
qe_plot(set) |> qe_group() |> qe_edges(show = FALSE)
} # }