Add Vertices to an Existing Network
add.vertices adds a specified number of vertices to an existing network; if desired, attributes for the new vertices may be specified as well.
an object of class
the number of vertices to add
optionally, a list of attributes with one entry per new vertex
logical; should the new vertices be added to the last (rather than the first) mode of a bipartite network?
possible additional arguments to add.vertices
New vertices are generally appended to the end of the network (i.e., their vertex IDs begin with
network.size(x) an count upward). The one exception to this rule is when
x is bipartite and
last.mode==FALSE. In this case, new vertices are added to the end of the first mode, with existing second-mode vertices being permuted upward in ID. (
bipartite attribute is adjusted accordingly.)
Note that the attribute format used here is based on the internal (vertex-wise) storage method, as opposed to the attribute-wise format used by
vattr should be a list with one entry per new vertex, the ith element of which should be a list with an element for every attribute of the ith vertex. (If the required
na attribute is not given, it will be automatically created.)
Invisibly, a pointer to the updated
add.vertices modifies its argument in place.
add.vertices was converted to an S3 generic funtion in version 1.9, so it actually calls
add.vertices.network by default and may call other versions depending on context (i.e. when called with a
Carter T. Butts email@example.com
Butts, C. T. (2008). “network: a Package for Managing Relational Data in R.” Journal of Statistical Software, 24(2). http://www.jstatsoft.org/v24/i02/
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
#Initialize a network object g<-network.initialize(5) g #Add five more vertices add.vertices(g,5) g #Create two more, with attributes vat<-replicate(2,list(is.added=TRUE,num.added=2),simplify=FALSE) add.vertices(g,2,vattr=vat) g%v%"is.added" #Values are only present for the new cases g%v%"num.added" #Add to a bipartite network bip <-network.initialize(5,bipartite=3) get.network.attribute(bip,'bipartite') # how many vertices in first mode? add.vertices(bip,3,last.mode=FALSE) get.network.attribute(bip,'bipartite')
Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.