# Louvain method

Part of a series on :
Network science :
Theory :
Graph
Complex network
Contagion
Small-world
Scale-free
Community structure
Percolation
Evolution
Controllability
Graph drawing
Social capital
Link analysis
Optimization
Reciprocity
Closure
Homophily
Transitivity
Preferential attachment
Balance theory
Network effect
Social influence :
Network types :
Informational (computing)
Telecommunication
Transport
Social
Scientific collaboration
Biological
Artificial neural
Interdependent
Semantic
Spatial
Dependency
Flow
on-Chip :
Graphs :
MetricsAlgorithms :
Centrality
Degree
Motif
Clustering
Degree distribution
Assortativity
Distance
Modularity
Efficiency :
Models :
ListsCategories :
Topics
Software
Network scientists
Category:Network theory
Category:Graph theory :
vte :
The Louvain method for community detection is a greedy optimization method intended to extract non-overlapping communities from large networks created by Blondel et al. from the University of Louvain (the source of this method's name).

## Modularity optimization

The inspiration for this method of community detection is the optimization of modularity as the algorithm progresses. Modularity is a scale value between −1 (non-modular clustering) and 1 (fully modular clustering) that measures the relative density of edges inside communities with respect to edges outside communities. Optimizing this value theoretically results in the best possible grouping of the nodes of a given network. But because going through all possible configurations of the nodes into groups is impractical, heuristic algorithms are used.
In the Louvain Method of community detection, first small communities are found by optimizing modularity locally on all nodes, then each small community is grouped into one node and the first step is repeated. The method is similar to the earlier method by Clauset, Newman and Moore that connects communities whose amalgamation produces the largest increase in modularity. The Louvain algorithm was shown to correctly identify the community structure when it exists, in particular in the stochastic block model.

## Algorithm Description
### Modularity

The value to be optimized is modularity, defined as a value in the range $[-1,1]$ that measures the density of links inside communities compared to links between communities. For a weighted graph, modularity is defined as:
$Q={\frac {1}{2m}}\sum _{i=1}^{N}\sum _{j=1}^{N}{\biggA_{ij}-{\frac {k_{i}k_{j}}{2m}}{\bigg ]}\delta (c_{i},c_{j}),$
where:
* $A_{ij}$ represents the edge weight between nodes i and j; see Adjacency matrix;
* ⁠$k_{i}$⁠ and ⁠$k_{j}$⁠ are the sum of the weights of the edges attached to nodes i and j, respectively;
* m is the sum of all of the edge weights in the graph;
* N is the total number of nodes in the graph;
* ⁠$c_{i}$⁠ and ⁠$c_{j}$⁠ are the communities to which the nodes i and j belong; and
* $\delta$ is Kronecker delta function:
${\begin{aligned}\delta (c_{i},c_{j})&={\begin{cases}1&{\text{if }}c_{i}{\text{ and }}c_{j}{\text{ are the same cluster}}\\0&{\text{otherwise}}\end{cases}}\end{aligned}}$
Based on the above equation, the modularity of a community c can be calculated as:
${\begin{aligned}Q_{c}&={\dfrac {1}{2m}}\sum _{i}\sum _{j}A_{ij}\mathbf {1} \left\{c_{i}=c_{j}=c\right\}-\left(\sum _{i}{\dfrac {k_{i}}{2m}}\mathbf {1} \left\{c_{i}=c\right\}\right)^{2}\\&={\frac {\Sigma _{in}}{2m}}-\left({\frac {\Sigma _{tot}}{2m}}\right)^{2}\end{aligned}}$
where
* $\Sigma _{in}$ is the sum of edge weights between nodes within the community c (each edge is considered twice); and
* $\Sigma _{tot}$ is the sum of all edge weights for nodes within the community (including edges which link to other communities).
As nodes in different communities do not contribute to the modularity Q, it can be written as:
$Q=\sum _{c}Q_{c}$

### The Louvain Method Algorithm

The Louvain method works by repeating two phases. In phase one, nodes are sorted into communities based on how the modularity of the graph changes when a node moves communities. In phase two, the graph is reinterpreted so that communities are seen as individual nodes. A detailed explanation is provided below.

#### Phase 1
##### Each node in the network is assigned to its own community.

The Louvain method begins by considering each node v in a graph to be its own community. This can be seen in Figure 1, where each dot (representing nodes) is a unique color (representing which community the node belongs to).

##### Nodes are grouped into communities

For each node v, we consider how moving v from its current community C into a neighboring community C' will affect the modularity of the graph partition. In the pseudo-code below, this happens in the for-loop. We select the community C' with the greatest change in modularity, and if the change is positive, we move v into C'; otherwise we leave it where it is. This continues until the modularity stops improving.
This process is applied repeatedly and sequentially to all nodes until no modularity increase can occur. Once this local maximum of modularity is hit, the first phase has ended. Figure 2 shows how the graph in Figure 1 might look after one iteration of phase 1.

#### Phase 2
##### Communities are reduced to a single node

For each community in our graph's partition, the individual nodes making up that community are combined and the community itself becomes a node. The edges connecting distinct communities are used to weight the new edges connecting our aggregate nodes.
This process is modeled in the pseudo-code, where the function aggregateGraph returns a new graph whose vertices are the partition of the old graph, and whose edges are calculated using the old graph. This function does not show the edges being weighted, but a simple modification would allow for that information to be tracked.
Figure 3 shows what the graph from Figure 2 would look like after being aggregated. This graph is analogous to the graph in Figure 1 in the sense that each node is assigned to a single community. From here, the process can be repeated so that more nodes are moved into existing communities until an optimal level of modularity is reached.
The pseudo-code below shows how the previous two functions work together to complete the process.

### Time Complexity

Generally, the Louvain method is assumed to have a time complexity of $O(n\logn)$. Richard Blondel, co-author of the paper that originally published the Louvain method, seems to support this notion, but other sources claim the time complexity is "essentially linear in the number of links in the graph," meaning the time complexity would instead be $O(m)$, where m is the number of edges in the graph. Unfortunately, no source has published an analysis of the Louvain method's time complexity so one is attempted here.
In the pseudo-code above, the function louvain controls the execution of the algorithm. It's clear to see that inside of louvain, moveNodeswill be repeated until it is no longer possible to combine nodes into communities. This depends on two factors: how much the modularity of the graph can improve and, in the worst case, if the modularity can improve with every iteration of louvain, it depends on how quickly aggregateGraph will reduce the graph down to a single node.
If, in each iteration of louvain, moveNodes is only able to move one node into a community, then aggregateGraph will only be able to reduce the size of the graph by one. This would cause louvain to repeat v times. Since moveNodes iterates through all nodes in a graph, this would result in a time complexity of ${\mathcal {O}}(n^{2})$, where n is the number of nodes.
It is unclear if this situation is possible, so the above result should be considered a loose bound. Blondel et al. state in their original publication that most of the run time is spent in the early iterations of the algorithm because "the number of communities decreases drastically after just a few passes." This can be understood by considering a scenario where moveNodes is able to move each node so that every community has two nodes. In this case, aggregateGraph would return a graph half the size of the original. If this continued, then the Louvain method would have a runtime of $n\log _{2}{n}$, although it is unclear if this would be the worst case, best case, average case, or none of those. Additionally, there is no guarantee the size of the graph would be reduced by the same factor with each iteration, and so no single logarithm function can perfectly describe the time complexity.

## Previous uses

* Twitter social Network (2.4 Million nodes, 38 million links) by Josep Pujol, Vijay Erramilli, and Pablo Rodriguez: The authors explore the problem of partitioning Online Social Networks onto different machines.
* Mobile phone Network (4 Million nodes, 100 Million links) by Derek Greene, Donal Doyle, and Padraig Cunningham: Community-tracking strategies for identifying dynamic communities of different dynamic social networks.
* Detecting species in network-based dynamical model.

## Disadvantages

Louvain produces only non-overlapping communities, which means that each node can belong to at most one community. This is highly unrealistic in many real-world applications. For example, in social networks, most people belong to multiple communities: their family, their friends, their co-workers, old school buddies, etc. In biological networks, most genes or proteins belong to more than one pathway or complex. Furthermore, Louvain has been shown to sometimes produce arbitrarily badly connected communities, and has been effectively superseded (at least in the non-overlapping case) by the Leiden algorithm.
A worst case example of an arbitrarily badly connected community is a internally disconnected community. An internally disconnected community arises through the Louvain algorithm when a node that had been acting as a "bridge" between two groups of nodes in its community is moved to a new community, leaving the old one disconnected. The remaining nodes in the old community may also be relocated, but if their connection to the community is strong enough despite the removal of the "bridge" node, they will instead remain in place. For an example of this, see the image to the right; note how the removal of the bridge node, node 0, caused the red community to be split into two disjoint subgroups. While this is the worst-case scenario, there are other, more subtle problems with the Louvain algorithm that can also lead to arbitrarily badly connected communities, such as the formation of communities using nodes that are only weakly connected.
Another common issue with the Louvain algorithm is the resolution limit of modularity - that is, multiple small communities being grouped together into a larger community. This causes the smaller communities to be hidden; for an example of this, see the visual depiction of the resolution limit to the right. Note how, when the green community is absorbed into the blue community to increase the graph's modularity, the smaller group of nodes that it represented is lost. There is no longer a way to differentiate those nodes from the nodes that were already in the blue community. Conversely, the nodes that were already in the blue community no longer appear distinct from those that were in the green community; in other words, whatever difference caused them to initially be placed in separate communities has been obscured.
Both the resolution limit of modularity and the arbitrarily badly connected community problem are further exasperated by each iteration of the algorithm. Ultimately, the only thing the Louvain algorithm guarantees is that the resulting communities cannot be merged further; in other words, they're well-separated. To avoid the problems that arise from arbitrarily badly connected communities and the resolution limit of modularity, it is recommended to use the Leiden algorithm instead, as its refinement phase and other various adjustments have corrected these issues.

## Comparison to other methods of non-overlapping community detection

When comparing modularity optimization methods, the two measures of importance are the speed and the resulting modularity value. A higher speed is better as it shows a method is more efficient than others and a higher modularity value is desirable as it points to having better-defined communities. The compared methods are, the algorithm of Clauset, Newman, and Moore, Pons and Latapy, and Wakita and Tsurumi.
Modularity Optimization Comparison :
| | Karate | Arxiv | Internet | Web nd.edu | Phone | Web uk-2005 | Web WebBase 2001 |
| Nodes/links | 34/77 | 9k/24k | 70k/351k | 325k/1M | 2.6M/6.3M | 39M/783M | 118M/1B |
| Clauset, Newman, and Moore | .38/0s | .772/3.6s | .692/799s | .927/5034s | -/- | -/- | -/- |
| Pons and Latapy | .42/0s | .757/3.3s | .729/575s | .895/6666s | -/- | -/- | -/- |
| Wakita and Tsurumi | .42/0s | .761/0.7s | .667/62s | .898/248s | .56/464s | -/- | -/- |
| Louvain Method | .42/0s | .813/0s | .781/1s | .935/3s | .769/134s | .979/738s | .984/152mn |
-/- in the table refers to a method that took over 24hrs to run. This table (from) shows that the Louvain method outperforms many similar modularity optimization methods in both the modularity and the time categories.