Skip to contents

Add nodes to a GraphSpace object

Source: R/gspace-addition.R
gs_add_nodes.Rd

gs_add_nodes<- adds one or more nodes to a GraphSpace object. The @graph, @nodes, and @fdata slots are updated consistently. Because new nodes introduce coordinates into the existing layout, the normalized state is invalidated and normalizeGraphSpace must be re-run afterwards.

Usage

# S4 method for class 'GraphSpace'
gs_add_nodes(x) <- value

Arguments

x

A GraphSpace object.

value

A data frame with at minimum three columns:

  • name — unique node identifier (character).

  • x, y — node coordinates in raw graph space.

Any additional columns are treated as node attributes. Standard visual attributes (nodeSize, nodeColor, nodeShape, etc.) are filled from package defaults when omitted. The column vertex is reserved and stripped automatically if present.

Value

A GraphSpace object with the new nodes appended and the normalized state cleared.

Details

Adding nodes always invalidates the normalized layout. The @pars normalization flags are cleared, @canvas is reset, and normalizeGraphSpace must be re-run to restore a renderable state. The @edges slot is not affected. Existing node coordinates in @nodes revert to raw graph-space values if the object was previously normalized, since normalization is cleared before @nodes is rebuilt.

Standard node attributes (nodeSize, nodeColor, etc.) are kept consistent across old and new nodes: attributes present on existing nodes but absent from value are filled from package defaults for the new rows, and vice versa.

nodeLabel defaults to the node name when not supplied, consistent with the behaviour of the GraphSpace constructor.

If @fdata is non-empty, new nodes are appended as NA rows so the feature matrix remains aligned with @nodes.

See also

gs_add_edges<-, gs_vertex_attr<-, gs_subset_nodes, gs_nodes, normalizeGraphSpace

Examples

library(RGraphSpace)
library(igraph)

g <- make_star(5, mode = "out")
gs <- GraphSpace(g)
#> Validating the 'igraph' object...
#> Vertex attributes 'x' and 'y' missing; computing layout...
#> Vertex attribute 'name' missing; assigning names... 
#> Ignoring graph-level attributes: 'name', 'mode', 'center'
#> Creating a 'GraphSpace' object...

# Add a single node with coordinates
gs_add_nodes(gs) <- data.frame(name = "n6", x = 0.5, y = 0.5)

# Add multiple nodes with visual attributes
gs_add_nodes(gs) <- data.frame(
  name      = c("n7", "n8"),
  x         = c(0.5, 0.8),
  y         = c(0.5, 0.2),
  nodeSize  = c(8, 5),
  nodeColor = c("steelblue", "tomato")
)
gs <- normalizeGraphSpace(gs)
#> Normalizing node coordinates to graph space...