Setting and retrieving rules through which network/edge/vertex attributes are copied or renamed when converting network objects.
attrmap(newdf = NULL)
If newdf
is NULL, a data frame with the current copy/rename
rules. Otherwise newdf
are set as new rules and the old ones are
returned invisibly, much like par
.
data.frame, new set of copy/rename rules, see Details
Different classes for network data use different attribute names to store the same information. Some of the classes define attributes not used by other classes. This function is used to retrieve or set the rules in which these attributes are copied, renamed or dropped when converting network objects.
The rules are stored in a data frame with the following columns (all of mode character):
type, or level of the attribute, one of "vertex", "edge" or "network"
name of the class which is being coerced
name of the "source" attribute
name of the class to which coercion is being done
name of the attribute in the result of coercion, or NA
When converting network x
, of class xclass
to network y
of class yclass
the coercion method looks up the rows in this table
for which fromcls=xclass
and tocls=yclass
. If network x
has any of the attributes listed in the fromattr
in the resulting
subset of the table then, it is renamed to the corresponding value of
toattr
. If toattr
is NA
the attribute is dropped from
the result.
This is used by asIgraph
and asNetwork