sna: gplot.target – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

gplot.target

Display a Graph in Target Diagram Form

Description

Displays an input graph (and associated vector) as a "target diagram," with vertices restricted to lie at fixed radii from the origin. Such displays are useful ways of representing vertex characteristics and/or local structural properties for graphs of small to medium size.

Usage

gplot.target(dat, x, circ.rad = (1:10)/10, circ.col = "blue", 
    circ.lwd = 1, circ.lty = 3, circ.lab = TRUE, circ.lab.cex = 0.75,
    circ.lab.theta = pi, circ.lab.col = 1, circ.lab.digits = 1,
    circ.lab.offset = 0.025, periph.outside = FALSE,
    periph.outside.offset = 1.2, ...)

Arguments

`dat`	an input graph.
`x`	a vector of vertex properties to be plotted (must match the dimensions of `dat`).
`circ.rad`	radii at which to draw reference circles.
`circ.col`	reference circle color.
`circ.lwd`	reference circle line width.
`circ.lty`	reference circle line type.
`circ.lab`	boolean; should circle labels be displayed?
`circ.lab.cex`	expansion factor for circle labels.
`circ.lab.theta`	angle at which to draw circle labels.
`circ.lab.col`	color for circle labels.
`circ.lab.digits`	digits to display for circle labels.
`circ.lab.offset`	offset for circle labels.
`periph.outside`	boolean; should "peripheral" vertices be drawn together beyond the normal vertex radius?
`periph.outside.offset`	radius at which "peripheral" vertices should be drawn if `periph.outside==TRUE`.
`...`	additional arguments to `gplot`.

Details

gplot.target is a front-end to gplot which implements the target diagram layout of Brandes et al. (2003). This layout seeks to optimize various aesthetic criteria, given the constraint that all vertices lie at fixed radii from the origin (set by x). One important feature of this algorithm is that vertices which belong to mutual dyads (described by Brandes et al. as “core” vertices) are treated differently from vertices which do not (“peripheral” vertices). Layout is optimized for core vertices prior to placing peripheral vertices; thus, the result may be misleading if mutuality is not a salient characteristic of the data.

The layout for gplot.target is handled by gplot.layout.target; additional parameters are specied on the associated manual page. Standard arguments may be passed to gplot, as well.

Value

A two-column matrix of vertex positions (generated by gplot.layout.target)

Author(s)

Carter T. Butts buttsc@uci.edu

References

Brandes, U.; Kenis, P.; and Wagner, D. (2003). “Communicating Centrality in Policy Network Drawings.” IEEE Transactions on Visualization and Computer Graphics, 9(2):241-253.

Examples

#Generate a random graph
g<-rgraph(15)

#Produce a target diagram, centering by betweenness
gplot.target(g,betweenness(g))

sna

Tools for Social Network Analysis

v2.6

GPL (>= 2)

Authors

Carter T. Butts [aut, cre, cph]

Initial release

2020-10-5