<code>plot.network</code> produces a simple two-dimensional plot of network
<code>x</code>, using optional attribute <code>attrname</code> to set edge values. A
variety of options are available to control vertex placement, display
details, color, etc.

plot.network.default

Tools to create and modify network objects.  The network class can represent a range of relational data types, and supports arbitrary vertex/edge/graph attributes.

Carter Butts

network

Classes for Relational Data

Carter T. Butts

David Hunter

Mark Handcock

Skye Bender-deMoll

Jeffrey Horner

Li Wang

Pavel N. Krivitsky

Brendan Knapp

Michał Bojanowski

Chad Klumb

plot.network.default function

Two-Dimensional Visualization for Network Objects — plot.network.default

<dl>

<dt>x</dt>
<dd>an object of class <code>network</code>.</dd>


<dt>...</dt>
<dd>additional arguments to <code><a href='https://rdrr.io/r/graphics/plot.default.html'>plot</a></code>.</dd>


<dt>attrname</dt>
<dd>an optional edge attribute, to be used to set edge values.</dd>


<dt>label</dt>
<dd>a vector of vertex labels, if desired; defaults to the vertex
labels returned by <code>network.vertex.names</code>. If <code>label</code> has
one element and it matches with a vertex attribute name, the value of the
attribute will be used. Note that labels may be set but hidden by the
<code>displaylabels</code> argument.</dd>


<dt>coord</dt>
<dd>user-specified vertex coordinates, in an network.size(x)x2
matrix. Where this is specified, it will override the <code>mode</code> setting.</dd>


<dt>jitter</dt>
<dd>boolean; should the output be jittered?</dd>


<dt>thresh</dt>
<dd>real number indicating the lower threshold for tie values.
Only ties of value &gt;<code>thresh</code> are displayed. By default,
<code>thresh</code>=0.</dd>


<dt>usearrows</dt>
<dd>boolean; should arrows (rather than line segments) be used
to indicate edges?</dd>


<dt>mode</dt>
<dd>the vertex placement algorithm; this must correspond to a
<code>network.layout</code> function.</dd>


<dt>displayisolates</dt>
<dd>boolean; should isolates be displayed?</dd>


<dt>interactive</dt>
<dd>boolean; should interactive adjustment of vertex
placement be attempted?</dd>


<dt>xlab</dt>
<dd>x axis label.</dd>


<dt>ylab</dt>
<dd>y axis label.</dd>


<dt>xlim</dt>
<dd>the x limits (min, max) of the plot.</dd>


<dt>ylim</dt>
<dd>the y limits of the plot.</dd>


<dt>pad</dt>
<dd>amount to pad the plotting range; useful if labels are being
clipped.</dd>


<dt>label.pad</dt>
<dd>amount to pad label boxes (if <code>boxed.labels==TRUE</code>),
in character size units.</dd>


<dt>displaylabels</dt>
<dd>boolean; should vertex labels be displayed?</dd>


<dt>boxed.labels</dt>
<dd>boolean; place vertex labels within boxes?</dd>


<dt>label.pos</dt>
<dd>position at which labels should be placed, relative to
vertices. <code>0</code> results in labels which are placed away from the center
of the plotting region; <code>1</code>, <code>2</code>, <code>3</code>, and <code>4</code> result in
labels being placed below, to the left of, above, and to the right of
vertices (respectively); and <code>label.pos&gt;=5</code> results in labels which are
plotted with no offset (i.e., at the vertex positions).</dd>


<dt>label.bg</dt>
<dd>background color for label boxes (if
<code>boxed.labels==TRUE</code>); may be a vector, if boxes are to be of different
colors.</dd>


<dt>vertex.sides</dt>
<dd>number of polygon sides for vertices; may be given as a
vector or a vertex attribute name, if vertices are to be of different types.
As of v1.12, radius of polygons are scaled so that all shapes have equal
area</dd>


<dt>vertex.rot</dt>
<dd>angle of rotation for vertices (in degrees); may be given
as a vector or a vertex attribute name, if vertices are to be rotated
differently.</dd>


<dt>vertex.lwd</dt>
<dd>line width of vertex borders; may be given as a vector or
a vertex attribute name, if vertex borders are to have different line
widths.</dd>


<dt>arrowhead.cex</dt>
<dd>expansion factor for edge arrowheads.</dd>


<dt>label.cex</dt>
<dd>character expansion factor for label text.</dd>


<dt>loop.cex</dt>
<dd>expansion factor for loops; may be given as a vector or a
vertex attribute name, if loops are to be of different sizes.</dd>


<dt>vertex.cex</dt>
<dd>expansion factor for vertices; may be given as a vector or
a vertex attribute name, if vertices are to be of different sizes.</dd>


<dt>edge.col</dt>
<dd>color for edges; may be given as a vector, adjacency matrix,
or edge attribute name, if edges are to be of different colors.</dd>


<dt>label.col</dt>
<dd>color for vertex labels; may be given as a vector or a
vertex attribute name, if labels are to be of different colors.</dd>


<dt>vertex.col</dt>
<dd>color for vertices; may be given as a vector or a vertex
attribute name, if vertices are to be of different colors.</dd>


<dt>label.border</dt>
<dd>label border colors (if <code>boxed.labels==TRUE</code>); may
be given as a vector, if label boxes are to have different colors.</dd>


<dt>vertex.border</dt>
<dd>border color for vertices; may be given as a vector or
a vertex attribute name, if vertex borders are to be of different colors.</dd>


<dt>edge.lty</dt>
<dd>line type for edge borders; may be given as a vector,
adjacency matrix, or edge attribute name, if edge borders are to have
different line types.</dd>


<dt>label.lty</dt>
<dd>line type for label boxes (if <code>boxed.labels==TRUE</code>);
may be given as a vector, if label boxes are to have different line types.</dd>


<dt>vertex.lty</dt>
<dd>line type for vertex borders; may be given as a vector or
a vertex attribute name, if vertex borders are to have different line types.</dd>


<dt>edge.lwd</dt>
<dd>line width scale for edges; if set greater than 0, edge
widths are scaled by <code>edge.lwd*dat</code>. May be given as a vector,
adjacency matrix, or edge attribute name, if edges are to have different
line widths.</dd>


<dt>edge.label</dt>
<dd>if non-<code>NULL</code>, labels for edges will be drawn. May be
given as a vector, adjacency matrix, or edge attribute name, if edges are to
have different labels. A single value of <code>TRUE</code> will use edge ids as
labels. NOTE: currently doesn't work for curved edges.</dd>


<dt>edge.label.cex</dt>
<dd>character expansion factor for edge label text; may be
given as a vector or a edge attribute name, if edge labels are to have
different sizes.</dd>


<dt>edge.label.col</dt>
<dd>color for edge labels; may be given as a vector or a
edge attribute name, if labels are to be of different colors.</dd>


<dt>label.lwd</dt>
<dd>line width for label boxes (if <code>boxed.labels==TRUE</code>);
may be given as a vector, if label boxes are to have different line widths.</dd>


<dt>edge.len</dt>
<dd>if <code>uselen==TRUE</code>, curved edge lengths are scaled by
<code>edge.len</code>.</dd>


<dt>edge.curve</dt>
<dd>if <code>usecurve==TRUE</code>, the extent of edge curvature is
controlled by <code>edge.curv</code>. May be given as a fixed value, vector,
adjacency matrix, or edge attribute name, if edges are to have different
levels of curvature.</dd>


<dt>edge.steps</dt>
<dd>for curved edges (excluding loops), the number of line
segments to use for the curve approximation.</dd>


<dt>loop.steps</dt>
<dd>for loops, the number of line segments to use for the
curve approximation.</dd>


<dt>object.scale</dt>
<dd>base length for plotting objects, as a fraction of the
linear scale of the plotting region. Defaults to 0.01.</dd>


<dt>uselen</dt>
<dd>boolean; should we use <code>edge.len</code> to rescale edge
lengths?</dd>


<dt>usecurve</dt>
<dd>boolean; should we use <code>edge.curve</code>?</dd>


<dt>suppress.axes</dt>
<dd>boolean; suppress plotting of axes?</dd>


<dt>vertices.last</dt>
<dd>boolean; plot vertices after plotting edges?</dd>


<dt>new</dt>
<dd>boolean; create a new plot? If <code>new==FALSE</code>, vertices and
edges will be added to the existing plot.</dd>


<dt>layout.par</dt>
<dd>parameters to the <code>network.layout</code> function
specified in <code>mode</code>.</dd>

</dl>

Arguments

Carter T. Butts <a href='mailto:buttsc@uci.edu'>buttsc@uci.edu</a>

Author

Two-Dimensional Visualization for Network Objects

plot.network.default: Two-Dimensional Visualization for Network Objects

Description

Usage

Arguments

Value

Details

References

See Also

Examples