Manipulating number of nodes

These functions allow users to add and delete nodes:

• add_nodes() adds an additional number of nodes to network data.

• delete_nodes() deletes nodes from network data.

• bind_nodes() adds two nodesets together.

• filter_nodes() subsets nodes based on some nodal attribute-related logical statement.

• arrange_nodes() reorders nodes based on some nodal attribute.

While add_*()/delete_*() functions operate similarly as comparable {igraph} functions, bind_*() and filter_*() works like a {tidyverse} or {dplyr}-style function.

add_nodes(.data, nodes, attribute = NULL)

delete_nodes(.data, nodes)

bind_nodes(.data, object2)

filter_nodes(.data, ..., .by = NULL)

arrange_nodes(.data, ...)

Arguments

.data

An object of a {manynet}-consistent class:

• adjacency or incidence matrix from {base} R

• edgelist data.frame from {base} R or tbl/tbl_df from {tibble}

• stocnet stocnet, from the {manynet} package

• igraph igraph, from the {igraph} package

• network network, from the {network} package

• tidygraph tbl_graph, from the {tidygraph} package

nodes

The number of nodes to be added.

attribute

A named list to be added as tie or node attributes.

object2

A second object to copy nodes or ties from.

...

Additional parameters and arguments passed on internally.

.by

An attribute name to join objects by. By default, NULL.

Value

A data object of the same class as the function was given.

Details

Not all functions have methods available for all object classes. Below are the currently implemented S3 methods for these functions:

              default igraph network stocnet tbl_graph
add_nodes           *      *       *                 *
arrange_nodes       *                      *         *
bind_nodes          *                      *
delete_nodes        *      *       *                 *
filter_nodes        *                      *         *

If a method is not available for a particular class, but a default method is, the default method will attempt to coerce the object to a class for which a method is defined, and then coerce the output back to the original class. If no method is available for any class, an error will be thrown.

See also

Other nodes: manip_nodes_attr

Other manipulations: manip_changes, manip_global, manip_info, manip_nodes_attr, manip_ties_attr, manip_ties_num

Examples

  other <- create_filled(4) |> mutate(name = c("A", "B", "C", "D"))
  add_nodes(other, 4, list(name = c("Matthew", "Mark", "Luke", "Tim")))
#> 
#> ── # Filled network ────────────────────────────────────────────────────────────
#> # A labelled, undirected network of 8 nodes and 6 ties
#> 
#> ── Nodes 
#> # A tibble: 8 × 1
#>   name   
#>   <chr>  
#> 1 A      
#> 2 B      
#> 3 C      
#> 4 D      
#> 5 Matthew
#> 6 Mark   
#> # ℹ 2 more rows
#> 
#> ── Ties 
#> # A tibble: 6 × 2
#>    from    to
#>   <int> <int>
#> 1     1     2
#> 2     1     3
#> 3     1     4
#> 4     2     3
#> 5     2     4
#> 6     3     4
#>