R: Replaces the sociomatrix in a network object

network.update {ergm}

R Documentation

Replaces the sociomatrix in a network object

Description

Replaces the edges in a network object with the edges corresponding to the sociomatrix specified by newmatrix. See ergm for more information.

Usage

network.update(nw, newmatrix, matrix.type=NULL, output="network",
              ignore.nattr = c("bipartite", "directed", "hyper", 
              "loops", "mnext", "multiple", "n"), ignore.vattr = c())

Arguments

`nw`	a `network` object. See documentation for the `network` package.
`newmatrix`	Either an adjacency matrix (a matrix of zeros and ones indicating the presence of a tie from i to j) or an edgelist (a two-column matrix listing origin and destination node numbers for each edge; note that in an undirected matrix, the first column should be the smaller of the two numbers).
`matrix.type`	One of "adjacency" or "edgelist" telling which type of matrix `newmatrix` is. Default is to use the `which.matrix.type` function.
`output`	Currently unused.
`ignore.nattr`	character vector of the names of network-level attributes to ignore when updating network objects (defaults to standard network properties)
`ignore.vattr`	character vector of the names of vertex-level attributes to ignore when updating network objects

Value

network.update returns a new network object with the edges specified by newmatrix and network and vertex attributes copied from the input network nw. Input network is not modified.

Examples

#
data(florentine)
#
# test the network.update function
#
# Create a Bernoulli network
rand.net <- network(network.size(flomarriage))
# store the sociomatrix 
rand.mat <- rand.net[,]
# Update the network
network.update(flomarriage, rand.mat, matrix.type="adjacency")
# Try this with an edgelist
rand.mat <- as.matrix.network.edgelist(flomarriage)[1:5,]
network.update(flomarriage, rand.mat, matrix.type="edgelist")