gplot.target {sna} | R Documentation

## 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.

### See Also

`gplot.layout.target`, `gplot`

### Examples

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

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

[Package sna version 1.1 Index]