Skip to main content

Vienna Graph Clustering -- VieClus

Project description

VieClus v1.1 License: MIT

The graph clustering framework VieClus -- Vienna Graph Clustering.

Graph clustering is the problem of detecting tightly connected regions of a graph. Depending on the task, knowledge about the structure of the graph can reveal information such as voter behavior, the formation of new trends, existing terrorist groups and recruitment or a natural partitioning of data records onto pages. Further application areas include the study of protein interaction, gene expression networks, fraud detection, program optimization and the spread of epidemics---possible applications are plentiful, as almost all systems containing interacting or coexisting entities can be modeled as a graph.

This is the release of our memetic algorithm, VieClus (Vienna Graph Clustering), to tackle the graph clustering problem. A key component of our contribution are natural recombine operators that employ ensemble clusterings as well as multi-level techniques. In our experimental evaluation, we show that our algorithm successfully improves or reproduces all entries of the 10th DIMACS implementation challenge under consideration in a small amount of time. In fact, for most of the small instances, we can improve the old benchmark result in less than a minute. Moreover, while the previous best result for different instances has been computed by a variety of solvers, our algorithm can now be used as a single tool to compute the result. In short our solver is the currently best modularity based clustering algorithm available.

example clustering

Main project site:

http://vieclus.taa.univie.ac.at

Installation Notes

Before you can start you need to install the following software packages:

Once you installed the packages, just type ./compile_withcmake.sh

To compile without MPI support (using pseudo_mpi.h), use: ./compile_withcmake.sh NOMPI

Note: MPI support is preferred as it enables the parallel algorithm which typically yields better solutions.

Once you did that you can try to run the following command:

With MPI support: mpirun -n 2 ./deploy/vieclus examples/astro-ph.graph --time_limit=60

Without MPI support: ./deploy/vieclus examples/astro-ph.graph --time_limit=60

For a description of the graph format please have a look into the manual.

Licence

The program is licenced under MIT licence. If you publish results using our algorithms, please acknowledge our work by quoting the following paper:

@inproceedings{BiedermannHSS18,
             AUTHOR = {Biedermann, Sonja and Henzinger, Monika and Schulz, Christian and Schuster, Bernhard},
             TITLE = {{Memetic Graph Clustering}},
             BOOKTITLE = {{Proceedings of the 17th International Symposium on Experimental Algorithms (SEA'18)}},
             SERIES = {{LIPIcs}},
             PUBLISHER = {Dagstuhl},
             NOTE = {Technical Report, arXiv:1802.07034},
             YEAR = {2018}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vieclus-1.2.0.tar.gz (4.0 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

vieclus-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (684.3 kB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

vieclus-1.2.0-cp312-cp312-macosx_11_0_arm64.whl (270.7 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

vieclus-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (682.9 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

vieclus-1.2.0-cp311-cp311-macosx_11_0_arm64.whl (270.3 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

vieclus-1.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (680.7 kB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

vieclus-1.2.0-cp310-cp310-macosx_11_0_arm64.whl (269.0 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

vieclus-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (681.0 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

vieclus-1.2.0-cp39-cp39-macosx_11_0_arm64.whl (269.1 kB view details)

Uploaded CPython 3.9macOS 11.0+ ARM64

vieclus-1.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (680.9 kB view details)

Uploaded CPython 3.8manylinux: glibc 2.17+ x86-64

vieclus-1.2.0-cp38-cp38-macosx_11_0_arm64.whl (268.9 kB view details)

Uploaded CPython 3.8macOS 11.0+ ARM64

File details

Details for the file vieclus-1.2.0.tar.gz.

File metadata

  • Download URL: vieclus-1.2.0.tar.gz
  • Upload date:
  • Size: 4.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for vieclus-1.2.0.tar.gz
Algorithm Hash digest
SHA256 b333cba3217ae0346eac949c82cc1b398e83e79246f912a11b93caede49805d2
MD5 ca160e384d2ee309860a2196b26fec7c
BLAKE2b-256 8772bebec24be170783d8f7a36752c4733b010b968069785a700a0783d4c65a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0.tar.gz:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 f0554245391949fb1fa775ab052ab5ba70da267224b39d9693c7db08fc7cb88d
MD5 998592352254f21908a44bfc41d0b41e
BLAKE2b-256 9d871ceec0474d1f01476f0433da6210f0dc63dd0a04c28c3fd51ff5d7a4b59a

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 887773f8b6687fb8221e24439902b6d64431dee61905c9670bcb0729e96d02d4
MD5 94ff310878e107c9bab41b5e07962371
BLAKE2b-256 330018b8dfdb18dd6eac05891e1d83fa9f5281bc972022ac0a8b4c3130eea987

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 11dd46eb5bbfb9e633b5ae5f3ca7f3784d4e4ac5e81c9b6694e987350844702d
MD5 d5beb1d46f33e1539a98679cff2eb808
BLAKE2b-256 60082046dec7fe96e399faef16fa3ba577e41638007e6f557eae63f1ef514e03

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 314a5115d8fd9436cfe55cd65e4d91e07f6e58ca51ed839a9502cc8b07220451
MD5 bc1515e3b198220d0c5c77634f635214
BLAKE2b-256 45eebdb9388d2fc9fe5fc0ad973d0f86867f9e6cb5d3326ab82b238406e03393

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 dbfed6aaa0b187da9e2998e02e77e58f2de23d0691d94eebe0abe62f7a539cc3
MD5 1ba7db3e1a4f110e1e0f23ad847c62a6
BLAKE2b-256 d4db44e2b45c923a95bcdaa3796b30a9a3bd0a08353a8b5caaac0043ae55bf53

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d9bda6e3c6df86f841cdcd1abeb1486a6bd37039c7852cf4682af5bafff9d4ce
MD5 582e0f1e9d7927438093e3f544a44875
BLAKE2b-256 e629634c274eec80209ae982cb702cd63c38a23fdd2d5089c30b495ea0a5fdb1

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp310-cp310-macosx_11_0_arm64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a9bbdb1327631a36dd6e6ee644637f5cf41cbfb26b757398ca0e3f5327ed67c5
MD5 7a63138573e495a4c236304fbe8276c8
BLAKE2b-256 a88d0ce66c9a2eb420ee3fbd03c3c74f8bc127efeec6594e1716d08ce401a908

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ee07aa78905fc798e9e485d7550d48edf11ed30532aac71a943f17151016789d
MD5 a7274d27792f33bd3f35743b5ce5c7ca
BLAKE2b-256 2298ea616d754de04d38f24e57642321b7759ca6ec34c2212fb68f319bb94c11

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp39-cp39-macosx_11_0_arm64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 83dfe492238dbb95241916cdd74ea2f3e85c2ae7ff2697ecf5aa8573feb687ea
MD5 5645bf45a564e5ece15afbd0dd332e88
BLAKE2b-256 3436d181ef7d59de8329005174a290a84dac886f97dc5a903311f8590e25018b

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vieclus-1.2.0-cp38-cp38-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for vieclus-1.2.0-cp38-cp38-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 9331b42a9fabb68d6c9c45f8aa9bdccd2b664ce846f3fe233c0b94813f91c6f4
MD5 335a428680fbbae8b078369e1c9a016f
BLAKE2b-256 41dd3b5ab35c63b80320ff92968ee1e766e84e5072018e1a7405e30d600aefb0

See more details on using hashes here.

Provenance

The following attestation bundles were made for vieclus-1.2.0-cp38-cp38-macosx_11_0_arm64.whl:

Publisher: publish-to-pypi.yml on VieClus/VieClus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page