Package: cdlib
CDlib - Community Detection LibraryCDlibis a meta-library for community detection in complex networks: it implements algorithms, clustering fitness functions as well as visualization facilities.CDlibis designed around thenetworkxpython library: however, when needed, it takes care to automatically convert (from and to)igraphobject so to provide an abstraction on specific algorithm implementations to the final user.CDlibprovides a standardized input/output facilities for several Community Discovery algorithms: whenever possible, to guarantee literature coherent results, implementations of CD algorithms are inherited from their original projects (acknowledged on thedocumentation).If you useCDlibas support to your research consider citing:G. Rossetti, L. Milli, R. Cazabet.CDlib: a Python Library to Extract, Compare and Evaluate Communities from Complex Networks.Applied Network Science Journal. 2019.DOI:10.1007/s41109-019-0165-9Tutorial and Online EnvironmentsCheck out the officialtutorialto get started!If you would like to testCDlibfunctionalities without installing anything on your machine consider using the preconfigured Jupyter Hub instances offered bySoBigData++.InstallationCDlibrequirespython>=3.8.To install the latest version of our library just download (or clone) the current project, open a terminal and run the following commands:pipinstall-rrequirements.txt
pipinstall-rrequirements_optional.txt# (Optional) this might not work in Windows systems due to C-based dependencies.pipinstall.Alternatively use pippipinstallcdlibor condacondacreate-ncdlibpython=3.9
condaconfig--addchannelsgiuliorossetti
condaconfig--addchannelsconda-forge
condainstallcdlibOptional Dependencies (pip package)To simplify the installation process, the default installation does not include optional dependencies (e.g.,graph-tool). If you need them, you can install them manually or run the following command:pipinstallcdlib[C]This option, safe for *nix users, will install all those optional dependencies that require C code compilation.pipinstallcdlib[pypi]This option will install all those optional dependencies that are not available on conda/conda-forge.pipinstallcdlib[all]This option will install all optional dependencies accessible with the flagCandpypi.(Advanced)Due to some strict requirements, the installation of a subset of optional dependencies is left outside the previous procedures.graph-toolCDlibintegrates the support for SBM models offered bygraph-tool.
To install it refer to the officialdocumentationand install the conda-forge version of the package (or the deb version if in a *nix system).ASLPAwSince its 2.1.0 releaseASLPAwrelies ongmpy2whose installation through pip is not easy to automatize due to some C dependencies.
To address such issue test the following recipe:condainstallgmpy2pipinstallshuffle_graph>=2.1.0similarity-index-of-label-graph>=2.0.1ASLPAw>=2.1.0In case this does not solve the issue, please refer to the officialgmpy2installationinstructions.Optional Dependencies (Conda package)CDlibrelies on a few packages not available through conda: to install them please use pip.pipinstallpycombo
pipinstallGraphRicciCurvature

condainstallgmpy2pipinstallshuffle_graph>=2.1.0similarity-index-of-label-graph>=2.0.1ASLPAw>=2.1.0In case ASLPAw installation fails, please refer to the officialgmpy2installationinstructions.Collaborate with us!CDlibis an active project, any contribution is welcome!If you like to include your model in CDlib feel free to fork the project, open an issue and contact us.How to contribute to this project?Contributing is good, doing it correctly is better! Check out ourrules, issue a properpull request/bug report/feature request.We are a welcoming community... just follow theCode of Conduct.