layout_saqr: Saqr Layout (Start/End transition flow)

In cograph: Analysis and Visualization of Complex Networks

Saqr Layout (Start/End transition flow)

Description

Port of the Dynalytics Desktop "saqr" layout (Saqr et al., LAK25). Designed for directed transition networks: the Start node sits alone on the top row, the End node (if present) alone on the bottom row, and every other node is ranked by its outgoing weight from Start (strongest connections nearest Start) and split into 2 middle rows (<= 10 middle nodes) or 3 (> 10). A sine envelope narrows the rows near Start/End for a lens-shaped silhouette, and the first middle row is zig-zag jittered.

Usage

layout_saqr(network, start = "Start", end = "End", jitter = 0.32, ...)

Arguments

network	A CographNetwork or cograph_network object.
start	Label of the Start node (default "Start"). Falls back to the highest out-degree node when the label is not found.
end	Label of the End node (default "End"). The End row is omitted when the label is not found.
jitter	Numeric in [0, 1]. Zig-zag amount applied to the first middle row, as a fraction of the row spacing (default 0.32).
...	Additional arguments (ignored).

Details

If the start label is absent the highest out-degree node is used. The End row is only drawn when the end label is present.

Value

Data frame with x, y coordinates, one row per node.

Examples

adj <- matrix(0, 5, 5,
  dimnames = list(c("Start", "A", "B", "C", "End"),
                  c("Start", "A", "B", "C", "End")))
adj["Start", "A"] <- 5; adj["Start", "B"] <- 3; adj["Start", "C"] <- 1
adj["A", "End"] <- 2; adj["B", "End"] <- 4; adj["C", "End"] <- 1
net <- CographNetwork$new(adj, directed = TRUE)
layout_saqr(net)

cograph documentation built on Sept. 30, 2026, 5:08 p.m.