View source: R/add_n_nodes_ws.R

add_n_nodes_ws | R Documentation |

Add `n`

new nodes to or from one or more nodes available as a selection in a
graph object of class `dgr_graph`

. New graph edges will all move either from
the nodes in the selection toward the newly created nodes (with the option
`direction = "from"`

), or to the selected nodes already in the graph (using
`direction = "to"`

). Optionally, set node `type`

and edge `rel`

values for
all the new nodes and edges created, respectively.

This function makes use of an active selection of nodes (and the function
ending with `_ws`

hints at this).

Selections of nodes can be performed using the following node selection
(`select_*()`

) functions: `select_nodes()`

, `select_last_nodes_created()`

,
`select_nodes_by_degree()`

, `select_nodes_by_id()`

, or
`select_nodes_in_neighborhood()`

.

Selections of nodes can also be performed using the following traversal
(`trav_*()`

) functions: `trav_out()`

, `trav_in()`

, `trav_both()`

,
`trav_out_node()`

, `trav_in_node()`

, `trav_out_until()`

, or
`trav_in_until()`

.

```
add_n_nodes_ws(
graph,
n,
direction = NULL,
type = NULL,
label = NULL,
rel = NULL,
node_aes = NULL,
edge_aes = NULL,
node_data = NULL,
edge_data = NULL
)
```

`graph` |
A graph object of class |

`n` |
The number of new nodes to attach as successor nodes to the nodes in the selection. |

`direction` |
Using |

`type` |
An optional character vector that provides group identifiers for the nodes to be added. |

`label` |
An optional character object that describes the nodes to be added. |

`rel` |
An optional string to apply a |

`node_aes` |
An optional list of named vectors comprising node aesthetic
attributes. The helper function |

`edge_aes` |
An optional list of named vectors comprising edge aesthetic
attributes. The helper function |

`node_data` |
An optional list of named vectors comprising node data
attributes. The helper function |

`edge_data` |
An optional list of named vectors comprising edge data
attributes. The helper function |

A graph object of class `dgr_graph`

.

Other Node creation and removal:
`add_n_node_clones()`

,
`add_n_nodes()`

,
`add_node_clones_ws()`

,
`add_node_df()`

,
`add_nodes_from_df_cols()`

,
`add_nodes_from_table()`

,
`add_node()`

,
`colorize_node_attrs()`

,
`copy_node_attrs()`

,
`create_node_df()`

,
`delete_nodes_ws()`

,
`delete_node()`

,
`drop_node_attrs()`

,
`join_node_attrs()`

,
`layout_nodes_w_string()`

,
`mutate_node_attrs_ws()`

,
`mutate_node_attrs()`

,
`node_data()`

,
`recode_node_attrs()`

,
`rename_node_attrs()`

,
`rescale_node_attrs()`

,
`set_node_attr_to_display()`

,
`set_node_attr_w_fcn()`

,
`set_node_attrs_ws()`

,
`set_node_attrs()`

,
`set_node_position()`

```
# Create an empty graph, add a node to it, select
# that node, and then add 5 more nodes to the graph
# with edges from the original node to all of the
# new nodes
graph <-
create_graph() %>%
add_n_nodes(n = 1) %>%
select_last_nodes_created() %>%
add_n_nodes_ws(
n = 5,
direction = "from")
# Get the graph's nodes
graph %>% get_node_ids()
# Get the graph's edges
graph %>% get_edges()
# Create an empty graph, add a node to it, select
# that node, and then add 5 more nodes to the graph
# with edges toward the original node from all of
# the new nodes
graph <-
create_graph() %>%
add_n_nodes(n = 1) %>%
select_last_nodes_created() %>%
add_n_nodes_ws(
n = 5,
direction = "to")
# Get the graph's nodes
graph %>% get_node_ids()
# Get the graph's edges
graph %>% get_edges()
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.