Skip to content
@CoMuNeLab

CoMuNe Lab

Research unit for multilayer modeling and analysis of complex systems
comunelab_github_repo 001

CoMuNeLab CoMuNeLab – Network Science Toolkit


Table of Contents


Code

Highlights Code

  • Dynamical models on networks: SIS/MM/POP ODEs, logistic/Hénon/Lorenz/Rössler maps, Motter–Lai cascading failures, diffusion processes, potential-driven random walks.
  • Spectral & diffusion geometry: spectral entropies, Jensen–Shannon distances, diffusion distances, random-walk geometry for functional clustering.
  • Information flow & inference: transfer entropy, correlation & temporal distance matrices.
  • Robustness & dismantling: static/targeted attacks, OAD model for local/nonlocal failure propagation, functional robustness metrics.
  • Multilayer: multilayer centralities, supra-adjacency, random walks.
  • Production-friendly packaging: modern pyproject.toml, CLI entry points, Roxygen2 docs, unit tests, and reproducible examples.

Project Map

IconAreaProjectLanguageOne‑liner
bioRCReservoir ComputingbioRCR & PythonBio-inspired reservoir computing on empirical & synthetic connectomes.
connectome-dimensionBrain Network Analysisconnectome-dimensionPythonLoad, preprocess, threshold, and analyze human connectome data across parcellations and subject groups for dimension-based analysis.
embedding_dimSymbolic Dynamics & Dimensionalityembedding-dimPythonEstimate embedding dimension via symbolic entropy, redundancy, and predictability analysis of time series.
FERMMigration ModelingFERMPythonA modular framework for simulating agent-based migration flows using niche-population maps and spatial constraints.
forecastingTime Series Forecasting & EntropyforecastingPythonModular toolkit for SARIMAX forecasting with exogenous/endogenous drivers and entropy rate estimation using Lempel-Ziv methods.
functional_robustnessRobustness & Resiliencefunctional-robustnessPythonSimulates network dismantling via classical and entropy-based centralities to quantify functional resilience under targeted attacks.
geopandas_mappingInfodemic MappinginfodemapPythonVisualizes Infodemic Risk Index (IRI) across World, USA, and EU/Italy regions using geospatial data and COVID-era misinformation metrics
jacobian_geometryMesoscale Network Dynamicsjacobian_geometryPythonModular library to extract functional mesoscale structure from dynamics on networks using Jacobian-based distance metrics
MuxVizPyMultilayer Network AnalysisMuxVizPyPythonModular Python port of MuxViz for building, analyzing, and visualizing edge-colored multilayer networks with centrality, percolation, and SBM community detection.
NDMNetwork ThermodynamicsNDMPythonSimulates diffusion processes on networks and extracts thermodynamic observables like entropy and free energy from density matrices.
OADSystemic risk & cascadesOADPythonGillespie-simulated Operational–Affected–Disrupted cascades with local and global-field spreading on networks; outputs survivors and GCC fraction.
perturbNetDynamical Systems on NetworksperturbNetPythonAnalyze perturbation propagation in steady-state ODE models on networks using correlation matrices, temporal distances, and concentric visualizations.
SEIREpidemic ModelingSEIR-deniersPythonSEIR-deniers simulates epidemic spreading with behavioral heterogeneity, modeling Deniers and Cooperators in a compartmental SEIR framework.
structural_robustnessNetwork Robustnessstructural-robustnessPythonAnalyze how different centrality-based node removal strategies impact the structural robustness of complex networks using spectral entropy and entanglement.
CollectiveDynLibCollective DynamicscollectiveDynRSimulation and analysis of coupled dynamical systems on networks, with map- and ODE-based models, adaptive rewiring, and multi-time-series utilities.
MultiNetLibMultilayer NetworksMultiNetLibRModular tools for multilayer/multiplex analysis—supra-adjacency builders, spectral geometry & entropy, random walks, and robustness profiles.
NetGrowLibNetwork Growth ModelsNetGrowLibRLibrary of generative network models (BA, CHKNS, age-biased, clustered) with tools for degree distributions and growth analysis.
robustnessRepoNetwork RobustnessRobustnessProfilesRTools to simulate node removals, build robustness profiles, and visualize critical resilience thresholds of complex networks under targeted and random attacks.
SpectralEntropyLibNetwork Information TheorySpectralEntropyLibRTools for quantifying and comparing complex networks using spectral entropies, divergences, and information-theoretic distances.
SpectralGeometryLibDiffusion GeometrySpectralGeometryRSpectral-geometry tools for graphs—Laplacians, spectra, heat kernels, diffusion distances, and embeddings to reveal functional clusters.
StochasticDynamicsEpidemic & Opinion DynamicsStochasticDynamicsRSimulates and visualizes stochastic spreading, opinion, and reaction–diffusion processes on networks with 3D rendering and video export.

Datasets

Highlights Datasets

  • Breadth and scope: Curated, domain-spanning collection covering social–ecological exchanges, biomedical interactomes, neuronal connectomes, genetic/protein systems, coauthorship, transport, trade, and microbiomes.
  • Multiplex structure and dynamics: Explicit layer semantics (2–364+ layers), directed/weighted edges, and temporal annotations where available—suited to multilayer centralities, diffusion models, and time-resolved analyses.
  • Standardized, interoperable formats: Extended edgelists with layer indices and consistent naming; readily ingestible in Python/R/graph-tool/Gephi pipelines, with repository and DOI links per entry.
  • Benchmarking across domains: Event-centric Twitter multiplexes and canonical social networks enable comparable tests for attention dynamics and information diffusion; other domains support cross-domain benchmarking.
  • Analysis coverage: Supports disease reclassification (gene–symptom multiplexes), transport resilience and disruption modeling, trade flow analysis, coauthorship structure, and microbiome network inference.
  • Provenance and compliance: Each dataset traces to maintained sources or peer-reviewed publications for transparent citation and reproducibility; social data use anonymized identifiers and adhere to platform/data-use policies.

Catalog

AreaProjectOne‑liner
Social-Ecological NetworksAlaskaMultiplex, directed, weighted household exchange networks (37–43 layers; 164–218 nodes) for three remote Alaska communities, capturing subsistence flows of goods/services in extended-edgelist format.
Biomedical Multiplex NetworksMultiplexDiseasomeTwo-layer map of human diseases linking disorders by shared genes and symptoms (GWAS/OMIM), enabling multiplex disease–disease analysis and molecular reclassification.
Computational Social ScienceSocialBurstMultiplex Twitter networks (retweet/mention/reply) from major events, capturing bursty collective attention with anonymized users and temporal interactions.
BibliometricssciMAG2015Linked MAG–SciMAGO journal-classified corpus of 35M+ papers and 324M citations across 27 macro-areas and 306 topics.
COVID-19 Interactome & Drug RepurposingCovMulNet19Heterogeneous network linking SARS-CoV-2 proteins, human interactors, symptoms, diseases, and compounds to map pathology and prioritize similar diseases and repurposable drugs.
COVID19 Infodemics ObservatoryTwitter InfodemicResults from the analysis of COVID19 infodemics due to unreliable content in online social media. Specifically, here we consider public posts on Twitter, analyzed with state-of-the-art machine learning techniques for: (1) population emotional state; (2) bot/human classification; (3) news reliability.
SocialNYClimateMarch2014Twitter retweet/mention/reply multiplex around the 2014 People’s Climate March.
SocialCannes2013Twitter retweet/mention/reply multiplex during the 2013 Cannes Film Festival.
SocialMoscowAthletics2013Twitter retweet/mention/reply multiplex for the 2013 World Championships in Athletics.
SocialMLKing2013Twitter retweet/mention/reply multiplex for the 50th anniversary of MLK’s “I Have a Dream” (2013).
SocialObamaInIsrael2013Twitter retweet/mention/reply multiplex around President Obama’s 2013 visit to Israel.
SocialUCLFinal2016Twitter retweet/mention/reply multiplex during the 2016 UEFA Champions League Final.
SocialNBA Finals 2015Twitter retweet/mention/reply multiplex during the 2015 NBA Finals.
SocialGravitational Waves 2016Twitter retweet/mention/reply multiplex around the 2016 gravitational-wave discovery.
SocialSanremo2016_finalTwitter retweet/mention/reply multiplex for the 2016 Sanremo Music Festival final.
SocialParisAttack2015Twitter retweet/mention/reply multiplex during the November 2015 Paris attacks.
SocialPopeElection2013Twitter retweet/mention/reply multiplex spanning the 2013 papal conclave (Pope Francis).
SocialBostonBomb2013Twitter retweet/mention/reply multiplex during the 2013 Boston Marathon bombing.
SocialHiggs Twitter — Friends/Followers GraphDirected follower network around the July 2012 Higgs boson announcement on Twitter.
SocialHiggs Twitter — Retweet NetworkDirected weighted retweet network during the 2012 Higgs boson announcement on Twitter.
SocialHiggs Twitter — Reply NetworkDirected weighted reply network during the 2012 Higgs boson announcement on Twitter.
SocialHiggs Twitter — Mention NetworkDirected weighted mention network during the 2012 Higgs boson announcement on Twitter.
SocialHiggs Multiplex — 2 LayersTwo-layer multiplex (friendship + aggregated interactions) for the 2012 Higgs Twitter dataset.
SocialHiggs Multiplex — 4 LayersFour-layer multiplex (friendship + replies + mentions + retweets) for the 2012 Higgs Twitter dataset.
TransportLondon Multiplex Transport NetworkMultiplex of London stations with layers for Underground (by line), Overground, and DLR; includes disruption scenarios.
TransportEU Air Transportation Multiplex37-layer European air transport multiplex, each layer an airline’s route network.
SocialCS AarhusFive-layer multiplex of CS department employees (Facebook, leisure, work, co-authorship, lunch).
SocialCKM Physicians InnovationThree-layer directed network of physicians’ advice, discussion, and friendship ties during tetracycline adoption.
SocialKapferer Tailor ShopFour-layer directed social/working interaction networks in a Zambian tailor shop across two time periods.
SocialKrackhardt High TechThree-layer directed network of managers (advice, friendship, reports-to) in a high-tech firm.
SocialLazega Law FirmThree-layer directed network of co-work, friendship, and advice among law firm partners/associates.
SocialPadgett Florentine FamiliesTwo-layer undirected multiplex of Renaissance Florentine families (marriage and business ties).
SocialVickers–Chan 7th GradersThree-layer directed multiplex of classroom relations among 7th graders (get-on-with, best friends, prefer-to-work-with).
NeuronalC. elegans Multiplex ConnectomeThree-layer neuronal connectome (electric, monadic chemical, polyadic chemical synapses) of C. elegans.
GeneticArabidopsis Multiplex GPI NetworkSeven-layer BioGRID genetic/protein interaction multiplex for Arabidopsis thaliana.
GeneticBos Multiplex GPI NetworkFour-layer BioGRID genetic/protein interaction multiplex for Bos.
GeneticCandida Multiplex GPI NetworkSeven-layer BioGRID genetic/protein interaction multiplex for Candida albicans.
GeneticC. elegans Multiplex GPI NetworkSix-layer BioGRID genetic/protein interaction multiplex for Caenorhabditis elegans.
GeneticDanio rerio Multiplex GPI NetworkFive-layer BioGRID genetic/protein interaction multiplex for Danio rerio.
GeneticDrosophila Multiplex GPI NetworkSeven-layer BioGRID genetic/protein interaction multiplex for Drosophila melanogaster.
GeneticGallus Multiplex GPI NetworkSix-layer BioGRID genetic/protein interaction multiplex for Gallus gallus.
GeneticHepatitis C Multiplex GPI NetworkThree-layer BioGRID host–pathogen interaction multiplex for Hepatitis C.
GeneticHomo sapiens Multiplex GPI NetworkSeven-layer BioGRID genetic/protein interaction multiplex for Homo sapiens.
GeneticHuman–Herpesvirus 4 Multiplex GPI NetworkFour-layer BioGRID host–pathogen interaction multiplex for human herpesvirus 4 (EBV).
GeneticHuman–HIV-1 Multiplex GPI NetworkFive-layer BioGRID host–pathogen interaction multiplex for HIV-1.
GeneticMus musculus Multiplex GPI NetworkSeven-layer BioGRID genetic/protein interaction multiplex for Mus musculus.
GeneticOryctolagus Multiplex GPI NetworkThree-layer BioGRID genetic/protein interaction multiplex for Oryctolagus.
GeneticPlasmodium Multiplex GPI NetworkThree-layer BioGRID genetic/protein interaction multiplex for Plasmodium falciparum.
GeneticRattus Multiplex GPI NetworkSix-layer BioGRID genetic/protein interaction multiplex for Rattus norvegicus.
GeneticSaccharomyces cerevisiae Multiplex GPI NetworkSeven-layer BioGRID genetic/protein interaction multiplex for S. cerevisiae.
GeneticSchizosaccharomyces pombe Multiplex GPI NetworkSeven-layer BioGRID genetic/protein interaction multiplex for S. pombe.
GeneticXenopus Multiplex GPI NetworkFive-layer BioGRID genetic/protein interaction multiplex for Xenopus laevis.
GeneticYeast Landscape Multiplex NetworkFour-layer multiplex combining genetic interactions and correlation-based profiles in S. cerevisiae.
CoauthorshiparXiv Network Science Multiplex13-layer undirected weighted coauthorship multiplex for arXiv papers on “networks” across subfields.
CoauthorshipPierre Auger Multiplex16-layer undirected weighted coauthorship multiplex within the Pierre Auger Collaboration (2010–2012).
FinancialFAO Multiplex Trade Network364-layer directed weighted food trade multiplex among countries (each layer a product; year 2010).
BiologicalHuman Microbiome Multiplex Network18-layer undirected microbial interaction networks across human body sites.

Install & Quickstart

Python (per project)

All Python subprojects follow a modern pyproject.toml layout and can be installed either locally (dev mode) or as a user package.

Local editable install

# inside a given Python project folder
python -m venv .venv &&source .venv/bin/activate # optional but recommended
pip install -U pip
pip install -e .

R (per package)

Each R package is Roxygen2‑documented and devtools‑friendly.

# from inside the R package folder
install.packages(c("devtools","roxygen2","testthat"), dependencies=TRUE)
devtools::document() # generate Rd + NAMESPACEdevtools::install() # install locallydevtools::test() # run unit tests

Development Guide

Python dev setup

  • Structure:src/<package_name>/, tests/, pyproject.toml, README.md.
  • Dependencies: keep runtime deps minimal; move extras to optional-dependencies.
  • Style: NumPy‑style docstrings.
  • Testing: pytest; use small, deterministic fixtures.
  • Docs: pdoc or Sphinx; provide a docs/ quickstart with examples and API references.

R dev setup

  • Structure:R/, man/, tests/testthat/, DESCRIPTION, NAMESPACE, README.md.
  • Documentation: Roxygen2 with @examples, @returns, @seealso.
  • Testing:testthat; keep tests fast and focused.

License

Unless specified otherwise in a subproject, the default license is MIT.
Individual subprojects may differ (e.g., GPL‑3.0 for R packages). See each LICENSE/DESCRIPTION.


Contact

For information, pull requests, and other inquiries, contact Prof. Manlio De Domenico and Andrea Valsecchi:

Popular repositories Loading

  1. MuxVizPy MuxVizPyPublic

    A research toolkit for multiplex networks: build layer tensors & supra-adjacency, analyze topology and mesoscale with SBM, compute multilayer centralities, and visualize layers in 3D.

    Python 4 5

  2. jacobian_geometry jacobian_geometryPublic

    A Python library to explore how network-driven dynamics induce mesoscale organization through Jacobian and diffusion-based functional geometry.

    Python 3

  3. perturbnet perturbnetPublic

    Python library to analyze how perturbations propagate on networks using steady-state ODE models, Local/Global correlation matrices, temporal distances, and clean visuals.

    Python 1

  4. London-Multiplex-Transport-Network London-Multiplex-Transport-NetworkPublic

    Multiplex of London stations with layers for Underground (by line), Overground, and DLR; includes disruption scenarios.

    1

  5. functional_robustness functional_robustnessPublic

    Tools to simulate and compare network dismantling strategies, degree, betweenness, PageRank, and entropy-based entanglement, tracking spectral/Laplacian metrics to quantify functional robustness un…

    Python 1

  6. structural_robustness structural_robustnessPublic

    A modular Python library to study the structural robustness of complex networks. It computes spectral-entropy metrics, entanglement-based node importance, and simulates centrality-driven dismantlin…

    Python 1 1

Repositories

Showing 10 of 72 repositories

Top languages

Loading…

Most used topics

Loading…