grip (version 0.1.2)

plot.layout: Quick plot for graph layouts

Description

For 2D layouts, draws vertices and edges using base graphics. For 3D layouts, the behaviour depends on the projection argument:

"rgl" (default)

Opens an interactive rgl scene when that package is installed. Falls back to "ortho" with a warning if rgl is not available.

"ortho"

Projects the 3D coordinates to 2D with project.3d and draws them with base graphics, giving a static figure suitable for vignettes and non-interactive reports.

Usage

# S3 method for layout
plot(x, ..., edges = NULL,
  projection = c("rgl", "ortho"), azimuth = 35, elevation = 22,
  vertex.col = "black", edge.col = "gray70")

Value

NULL (called for side effects).

Arguments

x

Numeric coordinate matrix with at least two columns.

...

Additional parameters passed to the underlying plot() call for 2D layouts or the rgl 3D plotting call.

edges

Optional two-column matrix of edges (1-based vertex ids).

projection

Character string controlling how 3D layouts are displayed: "rgl" (default) for an interactive rgl widget, or "ortho" for a static orthographic projection via base graphics. Ignored for 2D layouts.

azimuth

Rotation around the vertical axis in degrees. Only used when projection = "ortho". Default 35.

elevation

Rotation around the horizontal axis in degrees. Only used when projection = "ortho". Default 22.

vertex.col

Colour(s) for the vertices. Recycled to match the number of vertices. Default "black".

edge.col

Colour for the edges. Default "gray70".

Examples

edges <- cbind(1:5, 2:6)
coords <- grip(edges, n = 6, dim = 2,
                      placement = "barycenter",
                      rounds = 5, final_rounds = 5,
                      num_init = 3, num_nbrs = 4,
                      seed = 1)
plot.layout(coords, edges, main = "Path graph", pch = 16, cex = 0.8)