cograph (version 2.7.2)

layout_saqr: 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, ...)

Value

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

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.

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)