Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 0.9.0 instead.

Chinese Whispers for Python

This is an implementation of the Chinese Whispers clustering algorithm in Python. Since this library is based on NetworkX, it is simple to use.

Unit Tests Read the Docs PyPI Version Conda Version

Given a NetworkX graph G, this library can cluster it using the following code:

from chinese_whispers import chinese_whispers
chinese_whispers(G, weighting='top', iterations=20)

As the result, each node of the input graph is provided with the label attribute that stores the cluster label.

The library also offers a convenient command-line interface (CLI) for clustering graphs represented in the ABC tab-separated format (source\ttarget\tweight).

# Write karate_club.tsv (just as example)
python3 -c 'import networkx as nx; nx.write_weighted_edgelist(nx.karate_club_graph(), "karate_club.tsv", delimiter="\t")'

# Using as CLI
chinese-whispers karate_club.tsv

# Using as module (same CLI as above)
python3 -mchinese_whispers karate_club.tsv

A more complete usage example is available in the example notebook and at https://nlpub.github.io/chinese-whispers-python/.

In case you require higher performance, please consider our Java implementation that also includes other graph clustering algorithms: https://github.com/nlpub/watset-java.

Citation

@article{Ustalov:19:cl,
  author    = {Ustalov, Dmitry and Panchenko, Alexander and Biemann, Chris and Ponzetto, Simone Paolo},
  title     = {{Watset: Local-Global Graph Clustering with Applications in Sense and Frame Induction}},
  journal   = {Computational Linguistics},
  year      = {2019},
  volume    = {45},
  number    = {3},
  pages     = {423--479},
  doi       = {10.1162/COLI_a_00354},
  publisher = {MIT Press},
  issn      = {0891-2017},
  language  = {english},
}

Copyright (c) 2018–2023 Dmitry Ustalov. See LICENSE for details.

Metadata

Release files for chinese-whispers 0.8.2rc1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chinese-whispers 0.8.2rc1
File Size Uploaded
chinese_whispers-0.8.2rc1.tar.gz 6.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for chinese-whispers 0.8.2rc1
File Interpreter ABI Platform
chinese_whispers-0.8.2rc1-py3-none-any.whl Python 3 none any Details

Total release size: 14.5 kB

Release files / chinese_whispers-0.8.2rc1.tar.gz

Download URL chinese_whispers-0.8.2rc1.tar.gz
Size 6.5 kB
Tags Source
SHA-256 checksum
How to use checksums
dfe4c17352cbd27165881ac42269d56f4bae8f8929d43237c0519d01c2c4e914
BLAKE2b-256 checksum
How to use checksums
998c34a511b92bc1fd1d309844308c5ed97a8f8163a8ecaa96ffc76ccb68dff4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.1 CPython/3.11.3

Release files / chinese_whispers-0.8.2rc1-py3-none-any.whl

Download URL chinese_whispers-0.8.2rc1-py3-none-any.whl
Size 8.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c6819fb10697bd31401eb2376cb93f3a64c1ae03dd12755c134a96026b246629
BLAKE2b-256 checksum
How to use checksums
117f6dad8384b9746be51881e0ba8109f521b258915942a526434033a1cc6e91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.1 CPython/3.11.3
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page