# Visualizing graphs with overlapping node groups

I recently came across some data about multilateral agreements, which needed to be visualized as network plots. This data had some peculiarities that made it more difficult to create a plot that was easy to understand. First, the nodes in the graph were organized in groups but each node could belong to multiple groups or to no group at all. Second, there was one “super node” that was connected to all other nodes (while “normal” nodes were only connected within their group). This made it difficult to find the right layout that showed the connections between the nodes as well as the group memberships. However, digging a little deeper into the R packages igraph and ggraph it is possible to get satisfying results in such a scenario.

### Example data, nodes & edges

We will use the following packages that we need to load at first:

``````library(dplyr)
library(purrr)
library(igraph)
library(ggplot2)
library(ggraph)
library(RColorBrewer)
``````

Let’s create some exemplary data. Let’s say we have 4 groups a, b, c, d and 40 nodes with the node IDs 1 to 40. Each node can belong to several groups but it must not belong to any group. An example would be the following data:

``````group_a <- 1:5            # nodes 1 to 5 in group a
group_b <- 1:10           # nodes 1 to 10 in group b
group_c <- c(1:3, 7:18)   # nodes 1 to 3 and 7 to 18 in c
group_d <- c(1:4, 15:25)  # nodes 1 to 4 and 15 to 25 in d

members <- data_frame(id = c(group_a, group_b, group_c, group_d, 26:40),
group = c(rep('a', length(group_a)),
rep('b', length(group_b)),
rep('c', length(group_c)),
rep('d', length(group_d)),
rep(NA, 15)))   # nodes 26 to 40 do not
# belong to any group
``````

An excerpt of the data:

``````> members
id group
<int> <chr>
1 a
2 a
[...]
5 a
1 b
2 b
[...]
38 NA
39 NA
40 NA
``````

Now we can create the edges of the graph, i.e. the connections between the nodes. All nodes within a group are connected to each other. Additionally, all nodes are connected with one “super node” (as mentioned in the introduction). In our example data, we pick node ID 1 to be this special node. Let’s start to create our edges by connecting all nodes to node 1:

``````edges <- data_frame(from = 1, to = 2:max(members\$id), group = NA)
``````

We also denote here, that these edges are not part of any group memberships. We’ll handle these group memberships now:

``````within_group_edges <- members %>%
split(.\$group) %>%
map_dfr(function (grp) {
id2id <- combn(grp\$id, 2)
data_frame(from = id2id[1,],
to = id2id[2,],
group = unique(grp\$group))
})

edges <- bind_rows(edges, within_group_edges)
``````

At first, we split the `members` data by their `group` which produces a list of data frames. We then use `map_dfr` from the purrr package to handle each of these data frames that are passed as `grp` argument. `grp\$id` contains the node IDs of the members of this group and we use `combn` to create the pair-wise combinations of these IDs. This will create a matrix `id2id`, where the columns represent the node ID pairs. We return a data frame with the from-to ID pairs and a `group` column that denotes the group to which these edges belong. These “within-group edges” are appended to the already created edges using `bind_rows`.

``````> edges

from    to group
<int> <int> <chr>
1     2 NA
1     3 NA
1     4 NA
[...]
23    24 d
23    25 d
24    25 d
``````

### Plotting with ggraph

We have our edges, so now we can create the graph with igraph and plot it using the ggraph package:

``````g <- graph_from_data_frame(edges, directed = FALSE)

ggraph(g) +
geom_edge_link(aes(color = group), alpha = 0.5) +     # different edge color per group
geom_node_point(size = 7, shape = 21, stroke = 1,
fill = 'white', color = 'black') +
geom_node_text(aes(label = name)) +                   # "name" is automatically generated from the node IDs in the edges
theme_void()
`````` Not bad for the first try, but the layout is a bit unfortunate, giving too much space to nodes that don’t belong to any group.

We can tell igraph’s layout algorithm to tighten the non-group connections (the gray lines in the above figure) by giving them a higher weight than the within-group edges:

``````# give weight 10 to non-group edges
edges <- data_frame(from = 1, to = 2:40,
weight = 10, group = NA)

within_group_edges <- members %>%
split(.\$group) %>%
map_dfr(function (grp) {
id2id <- combn(grp\$id, 2)
# weight 1 for within-group edges
data_frame(from = id2id[1,],
to = id2id[2,],
weight = 1,
group = unique(grp\$group))
})
``````

We reconstruct the graph `g` and plot it using the same commands as before and get the following: The nodes within groups are now much less cluttered and the layout is more balanced.

### Plotting with igraph

A problem with this type of plot is that connections within smaller groups are sometimes hardly visible (for example group a in the above figure). The plotting functions of igraph allow an additional method of highlighting groups in graphs: Using the parameter `mark.groups` will construct convex hulls around nodes that belong to a group. These hulls can then be highlighted with respective colors.

At first, we need to create a list that maps each group to a vector of the node IDs that belong to that group:

``````group_ids <- lapply(members %>% split(.\$group), function(grp) { grp\$id })
``````
``````> group_ids
\$a
 1 2 3 4 5
\$b
 1  2  3  4  5  6  7  8  9 10
[...]
``````

Now we can create a color for each group using RColorBrewer:

``````group_color <- brewer.pal(length(group_ids), 'Set1')
# the fill gets an additional alpha value for transparency:
group_color_fill <- paste0(group_color, '20')
``````

We plot it by using the graph object `g` that was generated before with `graph_from_data_frame`:

``````par(mar = rep(0.1, 4))   # reduce margins

plot(g, vertex.color = 'white', vertex.size = 9,
edge.color = rgb(0.5, 0.5, 0.5, 0.2),
mark.groups = group_ids,
mark.col = group_color_fill,
mark.border = group_color)

legend('topright', legend = names(group_ids),
col = group_color,
pch = 15, bty = "n",  pt.cex = 1.5, cex = 0.8,
text.col = "black", horiz = FALSE)
`````` This option usually works well when you have groups that are more or less well separated, i.e. do not overlap too much. However, in our case there is quite some overlap and we can see that the shapes that encompass the groups also sometimes include nodes that do not actually belong to that group (for example node 8 in the above figure that is encompassed by group a although it does not belong to that group).

We can use a trick that leads the layout algorithm to bundle the groups more closely in a different manner: For each group, we introduce a “virtual node” (which will not be drawn during plotting) to which all the normal nodes in the group are tied with more weight than to each other. Nodes that only belong to a single group will be placed farther away from the center than those that belong to several groups, which will reduce clutter and wrongly overlapping group hulls. Furthermore, a virtual group node for nodes that do not belong to any group will make sure that these nodes will be placed more closely to each other.

We start by generating IDs for the virtual nodes:

``````# 4 groups plus one "NA-group"
virt_group_nodes <- max(members\$id) + 1:5
names(virt_group_nodes) <- c(letters[1:4], NA)
``````

This will give us the following IDs:

``````> virt_group_nodes
a    b    c    d   NA
41   42   43   44   45
``````

We start to create the edges again by connecting all nodes to the “super node” with ID 1:

``````edges_virt <- data_frame(from = 1, to = 2:40, weight = 5, group = NA)
``````

Then, the edges within the groups will be generated again, but this time we add additional edges to each group’s virtual node:

``````within_virt <- members %>% split(.\$group) %>% map_dfr(function (grp) {
group_name <- unique(grp\$group)
virt_from <- rep(virt_group_nodes[group_name], length(grp\$id))
id2id <- combn(grp\$id, 2)
data_frame(
from = c(id2id[1,], virt_from),
to = c(id2id[2,], grp\$id),            # also connects from virtual_from node to each group node
weight = c(rep(0.1, ncol(id2id)),     # weight between group nodes
rep(50, length(grp\$id))),  # weight that 'ties together' the group (via the virtual group node)
group = group_name
)
})

edges_virt <- bind_rows(edges_virt, within_virt)
``````

We add edges from all nodes that don’t belong to a group to another virtual node:

``````virt_group_na <- virt_group_nodes[is.na(names(virt_group_nodes))]
non_group_nodes <- (members %>% filter(is.na(group)))\$id
edges_na_group_virt <- data_frame(from = non_group_nodes,
to = rep(virt_group_na,
length(non_group_nodes)),
weight = 10,
group = NA)

edges_virt <- bind_rows(edges_virt, edges_na_group_virt)
``````

This time, we also create a data frame for the nodes, because we want to add an additional property `is_virt` to each node that denotes if that node is virtual:

``````nodes_virt <- data_frame(id = 1:max(virt_group_nodes),
is_virt = c(rep(FALSE, max(members\$id)),
rep(TRUE, length(virt_group_nodes))))
``````

We’re ready to create the graph now:

``````g_virt <- graph_from_data_frame(edges_virt, directed = FALSE,
vertices = nodes_virt)
``````

To illustrate the effect of the virtual nodes, we can plot the graph directly and get a figure like this (virtual nodes highlighted in turquois): We now want to plot the graph without the virtual nodes, but the layout should nevertheless be calculated with the virtual nodes. We can achieve that by running the layout algorithm first and then removing the virtual nodes from both the graph and the generated layout matrix:

``````# use "auto layout"
lay <- layout_nicely(g_virt)
# remove virtual group nodes from graph
g_virt <- g_virt - vertices(virt_group_nodes)
# remove virtual group nodes' positions from the layout matrix
lay <- lay[-virt_group_nodes, ]
``````

It’s important to pass the layout matrix now with the `layout` parameter to produce the final figure:

``````plot(g_virt, layout = lay, vertex.color = 'white', vertex.size = 9,
edge.color = rgb(0.5, 0.5, 0.5, 0.2),
mark.groups = group_ids, mark.col = group_color_fill,
mark.border = group_color)

legend('topright', legend = names(group_ids), col = group_color,
pch = 15, bty = "n",  pt.cex = 1.5, cex = 0.8,
text.col = "black", horiz = FALSE)
`````` We can see that output is less cluttered and nodes that belong to the same groups are bundled nicely while nodes that do not share the same groups are well separated. Note that the respective edge weights were found empirically and you will probably need to adjust them to achieve a good graph layout for your data.