python-louvain

Louvain Community Detection

https://github.com/taynaud/python-louvain

Science Score: 41.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    2 of 26 committers (7.7%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.3%) to scientific vocabulary

Keywords

community-detection louvain-method networkx
Last synced: 6 months ago · JSON representation ·

Repository

Louvain Community Detection

Basic Info
  • Host: GitHub
  • Owner: taynaud
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: master
  • Size: 226 KB
Statistics
  • Stars: 1,014
  • Watchers: 22
  • Forks: 201
  • Open Issues: 14
  • Releases: 0
Topics
community-detection louvain-method networkx
Created over 9 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License Citation

README.rst

Louvain Community Detection
===========================

.. image:: https://travis-ci.org/taynaud/python-louvain.svg?branch=master
    :target: https://travis-ci.org/taynaud/python-louvain

.. image:: https://readthedocs.org/projects/python-louvain/badge/?version=latest
    :target: http://python-louvain.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

Installing
----------

To build and install from source, run

.. code-block:: shell

    python setup.py install

You can also install from pip with

.. code-block:: shell

    pip install python-louvain


The package name on pip is :code:`python-louvain` 
but it is imported as :code:`community` in python. 
More documentation for this module can be found at
`http://python-louvain.readthedocs.io/ `_


Usage
-----

To use as a Python library

.. code-block:: python

    from community import community_louvain
    import matplotlib.cm as cm
    import matplotlib.pyplot as plt
    import networkx as nx

    # load the karate club graph
    G = nx.karate_club_graph()

    # compute the best partition
    partition = community_louvain.best_partition(G)

    # draw the graph
    pos = nx.spring_layout(G)
    # color the nodes according to their partition
    cmap = cm.get_cmap('viridis', max(partition.values()) + 1)
    nx.draw_networkx_nodes(G, pos, partition.keys(), node_size=40, 
                           cmap=cmap, node_color=list(partition.values()))
    nx.draw_networkx_edges(G, pos, alpha=0.5)
    plt.show()



It can also be run on the command line

.. code-block:: bash

     $ community 

where :code:`filename` is a binary file as generated by the
convert utility distributed with the C implementation at 
`https://sites.google.com/site/findcommunities/ `_
However as this is mostly for debugging purposes its use should be avoided.
Instead importing this library for use in Python is recommended.


Documentation
-------------

You can find documentation at `https://python-louvain.readthedocs.io/ `_

To generate documentation, run

.. code-block:: shell

     pip install numpydoc sphinx
     cd docs
     make

Tests
-----

To run tests, run

.. code-block:: shell

     pip install nose
     python setup.py test

Owner

  • Name: Thomas Aynaud
  • Login: taynaud
  • Kind: user
  • Location: Paris

Citation (CITATION)

Please use one of the following sample to cite python-louvain
(change x.y to the version you are using).

For text:

T. Aynaud. python-louvain x.y: Louvain algorithm for community detection. 2020. https://github.com/taynaud/python-louvain

A BibTeX entry for LaTeX users is:

@misc{python_louvain,
   title = {python-louvain x.y: Louvain algorithm for community detection},
   author = {Thomas Aynaud},
   year = {2020},
   howpublished = {\href{https://github.com/taynaud/python-louvain}{\texttt{https://github.com/taynaud/python-louvain}}},
 }

 If you are unsure about which version of python-louvain you are using run:
 `pip show python-louvain`.

GitHub Events

Total
  • Watch event: 63
  • Fork event: 3
Last Year
  • Watch event: 63
  • Fork event: 3

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 110
  • Total Committers: 26
  • Avg Commits per committer: 4.231
  • Development Distribution Score (DDS): 0.682
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Thomas Aynaud t****s@c****m 35
Thomas Aynaud t****d 27
Thomas Aynaud t****d@q****m 16
Richard Millson 8****n 5
Todd t****8@g****m 4
TheSkunkMan T****n@l****t 2
Pavlin Poličar p****p@g****m 2
villanuevab v****b 1
user-vi 5****i 1
asellappenIBM 3****n 1
Avril Kenney a****y 1
Benjamin Ricaud b****d@g****m 1
Dalwar Hossain 5****3 1
Domi W d****h@g****e 1
Juang, Yi-Lin f****g 1
Kathy Fan k****n@g****m 1
Kerstin k****n@e****e 1
Lizhi Zhang 4****e 1
Luke Cyca me@l****m 1
Mahdi Salehi m****4@y****m 1
MeggyCal M****l 1
Mridul Seth s****l@g****m 1
Nikoleta Glynatsi g****e@c****k 1
Patrick Bourke p****e@g****m 1
Zhouhan Chen z****5@n****u 1
altsoph a****h@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 77
  • Total pull requests: 27
  • Average time to close issues: 7 months
  • Average time to close pull requests: 3 months
  • Total issue authors: 67
  • Total pull request authors: 25
  • Average comments per issue: 1.95
  • Average comments per pull request: 1.11
  • Merged pull requests: 24
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • taynaud (7)
  • seralouk (2)
  • yuxuanChen777 (2)
  • jb110 (2)
  • jolespin (2)
  • jmmcd (1)
  • aafshinfard (1)
  • dalwar23 (1)
  • gebaltso (1)
  • andreacortis (1)
  • Mataivic (1)
  • zhqu1148980644 (1)
  • newbie2k20 (1)
  • GillesVandewiele (1)
  • yaya159456 (1)
Pull Request Authors
  • pavlin-policar (2)
  • richardmillson (2)
  • MeggyCal (2)
  • kathyfan (1)
  • dalwar23 (1)
  • taynaud (1)
  • user-vi (1)
  • Nikoleta-v3 (1)
  • ComplexLychee (1)
  • zhouhanc (1)
  • jaaufauvre (1)
  • thedomdom (1)
  • mahdi5534 (1)
  • erictapen (1)
  • pbourke (1)
Top Labels
Issue Labels
enhancement (3) question (1)
Pull Request Labels

Packages

  • Total packages: 17
  • Total downloads:
    • pypi 165,681 last-month
  • Total docker downloads: 138,298
  • Total dependent packages: 68
    (may contain duplicates)
  • Total dependent repositories: 965
    (may contain duplicates)
  • Total versions: 45
  • Total maintainers: 3
pypi.org: python-louvain

Louvain algorithm for community detection

  • Versions: 16
  • Dependent Packages: 59
  • Dependent Repositories: 889
  • Downloads: 165,681 Last month
  • Docker Downloads: 138,298
Rankings
Dependent packages count: 0.3%
Dependent repos count: 0.4%
Downloads: 0.8%
Docker downloads count: 1.1%
Average: 1.3%
Stargazers count: 2.1%
Forks count: 3.4%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.18: py3-louvain

Louvain community detection method

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 3.9%
Forks count: 7.0%
Stargazers count: 8.6%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.18: py3-louvain-pyc

Precompiled Python bytecode for py3-louvain

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 3.9%
Forks count: 7.0%
Stargazers count: 8.6%
Maintainers (1)
Last synced: 6 months ago
alpine-edge: py3-louvain-pyc

Precompiled Python bytecode for py3-louvain

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Average: 8.2%
Forks count: 8.3%
Stargazers count: 10.4%
Dependent packages count: 14.1%
Maintainers (1)
Last synced: 6 months ago
alpine-edge: py3-louvain

Louvain community detection method

  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 8.2%
Average: 8.2%
Stargazers count: 10.1%
Dependent packages count: 14.6%
Maintainers (1)
Last synced: 6 months ago
conda-forge.org: python-louvain

This module implements community detection. It uses the louvain method described in Fast unfolding of communities in large networks, Vincent D Blondel, Jean-Loup Guillaume, Renaud Lambiotte, Renaud Lefebvre, Journal of Statistical Mechanics: Theory and Experiment 2008(10), P10008 (12pp)

  • Versions: 5
  • Dependent Packages: 6
  • Dependent Repositories: 38
Rankings
Dependent repos count: 5.8%
Dependent packages count: 9.0%
Average: 10.4%
Forks count: 12.9%
Stargazers count: 13.9%
Last synced: 6 months ago
alpine-v3.17: py3-louvain

Louvain community detection method

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 6.9%
Stargazers count: 8.3%
Average: 10.6%
Dependent packages count: 27.3%
Maintainers (1)
Last synced: 6 months ago
spack.io: py-python-louvain

This module implements community detection. It uses the louvain method described in Fast unfolding of communities in large networks, Vincent D Blondel, Jean-Loup Guillaume, Renaud Lambiotte, Renaud Lefebvre, Journal of Statistical Mechanics: Theory and Experiment 2008(10), P10008 (12pp)

  • Versions: 1
  • Dependent Packages: 2
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 7.2%
Stargazers count: 7.9%
Average: 10.8%
Dependent packages count: 28.1%
Maintainers (1)
Last synced: 6 months ago
anaconda.org: python-louvain

This module implements community detection. It uses the louvain method described in Fast unfolding of communities in large networks, Vincent D Blondel, Jean-Loup Guillaume, Renaud Lambiotte, Renaud Lefebvre, Journal of Statistical Mechanics: Theory and Experiment 2008(10), P10008 (12pp)

  • Versions: 5
  • Dependent Packages: 1
  • Dependent Repositories: 38
Rankings
Forks count: 23.5%
Stargazers count: 25.1%
Dependent repos count: 26.4%
Average: 29.0%
Dependent packages count: 40.9%
Last synced: 6 months ago
alpine-v3.22: py3-louvain

Louvain community detection method

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.20: py3-louvain-pyc

Precompiled Python bytecode for py3-louvain

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.22: py3-louvain-pyc

Precompiled Python bytecode for py3-louvain

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.20: py3-louvain

Louvain community detection method

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.21: py3-louvain-pyc

Precompiled Python bytecode for py3-louvain

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.19: py3-louvain-pyc

Precompiled Python bytecode for py3-louvain

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Last synced: 6 months ago
alpine-v3.21: py3-louvain

Louvain community detection method

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 6 months ago
alpine-v3.19: py3-louvain

Louvain community detection method

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 6 months ago

Dependencies

.devcontainer/Dockerfile docker
  • mcr.microsoft.com/vscode/devcontainers/python ${VARIANT} build
requirements.txt pypi
  • networkx *
  • numpy *
  • numpydoc *
setup.py pypi
  • networkx *
  • numpy *