Learn R Programming

multigraph (version 0.91)

bmgraph: Bipartite multigraph

Description

A function to create and manipulate bipartite multigraphs

Usage

bmgraph(net, layout = c("bip", "bip3", "bip3e", "bipc", "force", "rand", "circ", 
       "stress", "CA", "circ2"), scope, coord, alpha = c(1, 1, 1), showLbs, showAtts, 
       att = NULL, lbat = "1", main = NULL, cex.main, bg, mar, directed, weighted, 
       collRecip, cex, pos, lwd, lty, col, ecol, vcol, vcol0, asp, seed = NULL, 
       maxiter = 100, bwd, clu, pch, fcol, rot, mirrorX, mirrorY, mirrorV, mirrorH, 
       hds, vedist, jitter, sort, add, adc, cluc, perm, ffamily, fstyle, fsize, ...)

Arguments

net

data frame or array representing the two-mode network (see details)

layout

the visualization layout:

bip (default) bipartite graph

bip3 bipartite graph with three columns

bip3e bipartite graph with three columns for events

bipc ``clustered'' bipartite graph

force force-directed algorithm

rand random

circ circular

stress stress-majorization algorithm

CA correspondence analysis

circ2 two semi-circles

scope

(optional) the scope of the graph (see details)

coord

(optional) data frame with the coordinates of the vertices. If coordinates are given then the layout option is ignored

alpha

vector (vertex, edge, bg) with the alpha color transparecy

showLbs

(optional and logical) whether or not show the vertex labels when dimnames available

showAtts

(optional and logical) whether or not show the vertex attribute labels

att

(optional) a vector or an array representing the vertex attributes

lbat

(optional) the labels for the vertex attributes

main

(optional) title of the plot

cex.main

(optional) the size of the plot's title

bg

(optional) the background color of the plot

mar

(optional) the margins of the plot

directed

(optional and logical) whether or not the graph is directed or unidrected

weighted

(optional and logical) whether or not the graph is weighted or dichotomous

collRecip

(optional and logical) whether or not collapse reciprocated edges in the unidrected graph

cex

(optional) the size of the vertices

pos

(optional) the position of the vertices' labels (0 means ``at the center of the vertex'')

lwd

(optional) the width of the edges. Ignored if weighted is set to TRUE

lty

(optional) the shape of the edges

col

(optional) alias for vcol

ecol

(optional) the color of the edges

vcol

(optional) the color of the vertices

vcol0

(optional) the color of the vertices' contour (only works for pch 21 through 25

asp

(optional) the aspect ratio of the plot

seed

(optional) the random seed number for the vertices' initial coordinates. Ignored except for force, stress and rand

maxiter

(optional) the maximum number of iterations in layout algorithms. Ignored except for force, stress and rand

bwd

(optional) the width of the bundle edges. Ranges from 0 (edges collapsed) to the default 1 (depending on the vertices' size). For weighted a value greater than one is possible

clu

(optional) the clustering of the vertices (see details)

pch

(optional) the symbol representing the vertices

fcol

the font color

rot

(optional) clockwise rotation of the graph in degrees

mirrorX

(optional) mirror of the X axis

mirrorY

(optional) mirror of the Y axis

mirrorV

same as mirrorX

mirrorH

same as mirrorY

hds

(optional and experimental) arcs' head scale

vedist

(optional and experimental) a real number with vertex - edge distance

jitter

(optional) the jitter in stress or CA

sort

(optional and logical) sort the vertex labels

add

add nodes to the graph's domain

adc

add nodes to the graph's codomain

cluc

a list of vectors the clustering information in both the domain and the codomain

perm

(optional) a list of vectors for the permutation of network members in both the domain and codomain

ffamily

the font family

fstyle

the font style

fsize

the font size

Additional argument items (see e.g. par)

Value

A plot of the two-mode networks as bipartite graph or multigraph

Details

Bipartite graphs are visualization devices for two-mode networks. Although this type of data would typically record as a data frame, it is possible to use even three dimensional arrays where each level corresponds to a particular type of tie, and thus the bipartite graphs in this case will be depicted with parallel edges. Besides, it is possible to obtain a graph of the bipartite network using the binomial approach to two-mode data, and plot it with a forced directed algorithm.

See Also

multigraph, frcd, stsm, conc

Examples

Run this code
# NOT RUN {
## Create the data: two binary relations among three elements
arr <- round( replace( array(runif(18), c(3,3,2)), array(runif(18),
       c(3,3,2))>.5, 3 ) )

## Plot this network as Bipartite graph
bmgraph(arr)

## Now with a Force Directed algorithm
bmgraph(arr, layout = "force")

## And with a Correspondence Analysis method
bmgraph(arr, layout = "CA", asp = NA)

# }

Run the code above in your browser using DataLab