Skip to contents

Rename a node attribute

Source: R/rename_node_attrs.R
rename_node_attrs.Rd

Within a graph's internal node data frame (ndf), rename an existing node attribute.

Usage

rename_node_attrs(graph, node_attr_from, node_attr_to)

Arguments

graph

A graph object of class dgr_graph.

node_attr_from

The name of the node attribute that will be renamed.

node_attr_to

The new name of the node attribute column identified in node_attr_from.

Value

A graph object of class dgr_graph.

See also

Other node creation and removal: add_n_node_clones(), add_n_nodes(), add_n_nodes_ws(), add_node(), add_node_clones_ws(), add_node_df(), add_nodes_from_df_cols(), add_nodes_from_table(), colorize_node_attrs(), copy_node_attrs(), create_node_df(), delete_node(), delete_nodes_ws(), drop_node_attrs(), join_node_attrs(), layout_nodes_w_string(), mutate_node_attrs(), mutate_node_attrs_ws(), node_data(), recode_node_attrs(), rescale_node_attrs(), set_node_attr_to_display(), set_node_attr_w_fcn(), set_node_attrs(), set_node_attrs_ws(), set_node_position()

Examples

# Create a random graph using the
# `add_gnm_graph()` function
graph <-
  create_graph() %>%
  add_gnm_graph(
    n = 5,
    m = 8,
    set_seed = 23) %>%
  set_node_attrs(
    node_attr = shape,
    values = "circle") %>%
  set_node_attrs(
    node_attr = value,
    values = rnorm(
      n = count_nodes(.),
      mean = 5,
      sd = 1) %>% round(1))

# Get the graph's internal ndf
# to show which node attributes
# are available
graph %>% get_node_df()
#>   id type label  shape value
#> 1  1 <NA>     1 circle   5.2
#> 2  2 <NA>     2 circle   5.3
#> 3  3 <NA>     3 circle   4.4
#> 4  4 <NA>     4 circle   5.8
#> 5  5 <NA>     5 circle   5.9

# Rename the `value` node
# attribute as `weight`
graph <-
  graph %>%
  rename_node_attrs(
    node_attr_from = value,
    node_attr_to = weight)

# Get the graph's internal
# ndf to show that the node
# attribute had been renamed
graph %>% get_node_df()
#>   id type label  shape weight
#> 1  1 <NA>     1 circle    5.2
#> 2  2 <NA>     2 circle    5.3
#> 3  3 <NA>     3 circle    4.4
#> 4  4 <NA>     4 circle    5.8
#> 5  5 <NA>     5 circle    5.9