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

Icon Area Project Language One‑liner
bioRC Reservoir Computing bioRC R & Python Bio-inspired reservoir computing on empirical & synthetic connectomes.
connectome-dimension Brain Network Analysis connectome-dimension Python Load, preprocess, threshold, and analyze human connectome data across parcellations and subject groups for dimension-based analysis.
embedding_dim Symbolic Dynamics & Dimensionality embedding-dim Python Estimate embedding dimension via symbolic entropy, redundancy, and predictability analysis of time series.
FERM Migration Modeling FERM Python A modular framework for simulating agent-based migration flows using niche-population maps and spatial constraints.
forecasting Time Series Forecasting & Entropy forecasting Python Modular toolkit for SARIMAX forecasting with exogenous/endogenous drivers and entropy rate estimation using Lempel-Ziv methods.
functional_robustness Robustness & Resilience functional-robustness Python Simulates network dismantling via classical and entropy-based centralities to quantify functional resilience under targeted attacks.
geopandas_mapping Infodemic Mapping infodemap Python Visualizes Infodemic Risk Index (IRI) across World, USA, and EU/Italy regions using geospatial data and COVID-era misinformation metrics
jacobian_geometry Mesoscale Network Dynamics jacobian_geometry Python Modular library to extract functional mesoscale structure from dynamics on networks using Jacobian-based distance metrics
MuxVizPy Multilayer Network Analysis MuxVizPy Python Modular Python port of MuxViz for building, analyzing, and visualizing edge-colored multilayer networks with centrality, percolation, and SBM community detection.
NDM Network Thermodynamics NDM Python Simulates diffusion processes on networks and extracts thermodynamic observables like entropy and free energy from density matrices.
OAD Systemic risk & cascades OAD Python Gillespie-simulated Operational–Affected–Disrupted cascades with local and global-field spreading on networks; outputs survivors and GCC fraction.
perturbNet Dynamical Systems on Networks perturbNet Python Analyze perturbation propagation in steady-state ODE models on networks using correlation matrices, temporal distances, and concentric visualizations.
SEIR Epidemic Modeling SEIR-deniers Python SEIR-deniers simulates epidemic spreading with behavioral heterogeneity, modeling Deniers and Cooperators in a compartmental SEIR framework.
structural_robustness Network Robustness structural-robustness Python Analyze how different centrality-based node removal strategies impact the structural robustness of complex networks using spectral entropy and entanglement.
CollectiveDynLib Collective Dynamics collectiveDyn R Simulation and analysis of coupled dynamical systems on networks, with map- and ODE-based models, adaptive rewiring, and multi-time-series utilities.
MultiNetLib Multilayer Networks MultiNetLib R Modular tools for multilayer/multiplex analysis—supra-adjacency builders, spectral geometry & entropy, random walks, and robustness profiles.
NetGrowLib Network Growth Models NetGrowLib R Library of generative network models (BA, CHKNS, age-biased, clustered) with tools for degree distributions and growth analysis.
robustnessRepo Network Robustness RobustnessProfiles R Tools to simulate node removals, build robustness profiles, and visualize critical resilience thresholds of complex networks under targeted and random attacks.
SpectralEntropyLib Network Information Theory SpectralEntropyLib R Tools for quantifying and comparing complex networks using spectral entropies, divergences, and information-theoretic distances.
SpectralGeometryLib Diffusion Geometry SpectralGeometry R Spectral-geometry tools for graphs—Laplacians, spectra, heat kernels, diffusion distances, and embeddings to reveal functional clusters.
StochasticDynamics Epidemic & Opinion Dynamics StochasticDynamics R Simulates 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

Area Project One‑liner
Social-Ecological Networks Alaska Multiplex, 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 Networks MultiplexDiseasome Two-layer map of human diseases linking disorders by shared genes and symptoms (GWAS/OMIM), enabling multiplex disease–disease analysis and molecular reclassification.
Computational Social Science SocialBurst Multiplex Twitter networks (retweet/mention/reply) from major events, capturing bursty collective attention with anonymized users and temporal interactions.
Bibliometrics sciMAG2015 Linked MAG–SciMAGO journal-classified corpus of 35M+ papers and 324M citations across 27 macro-areas and 306 topics.
COVID-19 Interactome & Drug Repurposing CovMulNet19 Heterogeneous network linking SARS-CoV-2 proteins, human interactors, symptoms, diseases, and compounds to map pathology and prioritize similar diseases and repurposable drugs.
COVID19 Infodemics Observatory Twitter Infodemic Results 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.
Social NYClimateMarch2014 Twitter retweet/mention/reply multiplex around the 2014 People’s Climate March.
Social Cannes2013 Twitter retweet/mention/reply multiplex during the 2013 Cannes Film Festival.
Social MoscowAthletics2013 Twitter retweet/mention/reply multiplex for the 2013 World Championships in Athletics.
Social MLKing2013 Twitter retweet/mention/reply multiplex for the 50th anniversary of MLK’s “I Have a Dream” (2013).
Social ObamaInIsrael2013 Twitter retweet/mention/reply multiplex around President Obama’s 2013 visit to Israel.
Social UCLFinal2016 Twitter retweet/mention/reply multiplex during the 2016 UEFA Champions League Final.
Social NBA Finals 2015 Twitter retweet/mention/reply multiplex during the 2015 NBA Finals.
Social Gravitational Waves 2016 Twitter retweet/mention/reply multiplex around the 2016 gravitational-wave discovery.
Social Sanremo2016_final Twitter retweet/mention/reply multiplex for the 2016 Sanremo Music Festival final.
Social ParisAttack2015 Twitter retweet/mention/reply multiplex during the November 2015 Paris attacks.
Social PopeElection2013 Twitter retweet/mention/reply multiplex spanning the 2013 papal conclave (Pope Francis).
Social BostonBomb2013 Twitter retweet/mention/reply multiplex during the 2013 Boston Marathon bombing.
Social Higgs Twitter — Friends/Followers Graph Directed follower network around the July 2012 Higgs boson announcement on Twitter.
Social Higgs Twitter — Retweet Network Directed weighted retweet network during the 2012 Higgs boson announcement on Twitter.
Social Higgs Twitter — Reply Network Directed weighted reply network during the 2012 Higgs boson announcement on Twitter.
Social Higgs Twitter — Mention Network Directed weighted mention network during the 2012 Higgs boson announcement on Twitter.
Social Higgs Multiplex — 2 Layers Two-layer multiplex (friendship + aggregated interactions) for the 2012 Higgs Twitter dataset.
Social Higgs Multiplex — 4 Layers Four-layer multiplex (friendship + replies + mentions + retweets) for the 2012 Higgs Twitter dataset.
Transport London Multiplex Transport Network Multiplex of London stations with layers for Underground (by line), Overground, and DLR; includes disruption scenarios.
Transport EU Air Transportation Multiplex 37-layer European air transport multiplex, each layer an airline’s route network.
Social CS Aarhus Five-layer multiplex of CS department employees (Facebook, leisure, work, co-authorship, lunch).
Social CKM Physicians Innovation Three-layer directed network of physicians’ advice, discussion, and friendship ties during tetracycline adoption.
Social Kapferer Tailor Shop Four-layer directed social/working interaction networks in a Zambian tailor shop across two time periods.
Social Krackhardt High Tech Three-layer directed network of managers (advice, friendship, reports-to) in a high-tech firm.
Social Lazega Law Firm Three-layer directed network of co-work, friendship, and advice among law firm partners/associates.
Social Padgett Florentine Families Two-layer undirected multiplex of Renaissance Florentine families (marriage and business ties).
Social Vickers–Chan 7th Graders Three-layer directed multiplex of classroom relations among 7th graders (get-on-with, best friends, prefer-to-work-with).
Neuronal C. elegans Multiplex Connectome Three-layer neuronal connectome (electric, monadic chemical, polyadic chemical synapses) of C. elegans.
Genetic Arabidopsis Multiplex GPI Network Seven-layer BioGRID genetic/protein interaction multiplex for Arabidopsis thaliana.
Genetic Bos Multiplex GPI Network Four-layer BioGRID genetic/protein interaction multiplex for Bos.
Genetic Candida Multiplex GPI Network Seven-layer BioGRID genetic/protein interaction multiplex for Candida albicans.
Genetic C. elegans Multiplex GPI Network Six-layer BioGRID genetic/protein interaction multiplex for Caenorhabditis elegans.
Genetic Danio rerio Multiplex GPI Network Five-layer BioGRID genetic/protein interaction multiplex for Danio rerio.
Genetic Drosophila Multiplex GPI Network Seven-layer BioGRID genetic/protein interaction multiplex for Drosophila melanogaster.
Genetic Gallus Multiplex GPI Network Six-layer BioGRID genetic/protein interaction multiplex for Gallus gallus.
Genetic Hepatitis C Multiplex GPI Network Three-layer BioGRID host–pathogen interaction multiplex for Hepatitis C.
Genetic Homo sapiens Multiplex GPI Network Seven-layer BioGRID genetic/protein interaction multiplex for Homo sapiens.
Genetic Human–Herpesvirus 4 Multiplex GPI Network Four-layer BioGRID host–pathogen interaction multiplex for human herpesvirus 4 (EBV).
Genetic Human–HIV-1 Multiplex GPI Network Five-layer BioGRID host–pathogen interaction multiplex for HIV-1.
Genetic Mus musculus Multiplex GPI Network Seven-layer BioGRID genetic/protein interaction multiplex for Mus musculus.
Genetic Oryctolagus Multiplex GPI Network Three-layer BioGRID genetic/protein interaction multiplex for Oryctolagus.
Genetic Plasmodium Multiplex GPI Network Three-layer BioGRID genetic/protein interaction multiplex for Plasmodium falciparum.
Genetic Rattus Multiplex GPI Network Six-layer BioGRID genetic/protein interaction multiplex for Rattus norvegicus.
Genetic Saccharomyces cerevisiae Multiplex GPI Network Seven-layer BioGRID genetic/protein interaction multiplex for S. cerevisiae.
Genetic Schizosaccharomyces pombe Multiplex GPI Network Seven-layer BioGRID genetic/protein interaction multiplex for S. pombe.
Genetic Xenopus Multiplex GPI Network Five-layer BioGRID genetic/protein interaction multiplex for Xenopus laevis.
Genetic Yeast Landscape Multiplex Network Four-layer multiplex combining genetic interactions and correlation-based profiles in S. cerevisiae.
Coauthorship arXiv Network Science Multiplex 13-layer undirected weighted coauthorship multiplex for arXiv papers on “networks” across subfields.
Coauthorship Pierre Auger Multiplex 16-layer undirected weighted coauthorship multiplex within the Pierre Auger Collaboration (2010–2012).
Financial FAO Multiplex Trade Network 364-layer directed weighted food trade multiplex among countries (each layer a product; year 2010).
Biological Human Microbiome Multiplex Network 18-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 + NAMESPACE
devtools::install()   # install locally
devtools::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. jacobian_geometry jacobian_geometry Public

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

    Python 2

  2. perturbnet perturbnet Public

    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

  3. functional_robustness functional_robustness Public

    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

  4. forecasting forecasting Public

    A modular Python library for time series forecasting with SARIMAX, symbolic entropy rate estimation via Lempel-Ziv methods, and geospatial analysis using the haversine distance. Includes support fo…

    Python

  5. MuxVizPy MuxVizPy Public

    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 1

  6. FERM_python FERM_python Public

    Code to run the Feature-Enriched Radiation Model (FERM) on Python, including parallel computing

    HTML

Repositories

Showing 10 of 67 repositories
  • MuxVizPy Public

    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.

    CoMuNeLab/MuxVizPy’s past year of commit activity
    Python 0 MIT 1 0 0 Updated Oct 14, 2025
  • .github Public
    CoMuNeLab/.github’s past year of commit activity
    0 0 0 0 Updated Oct 6, 2025
  • structural_robustness Public

    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 dismantling while tracking the largest connected component. Includes correlation analysis, examples, and pytest tests.

    CoMuNeLab/structural_robustness’s past year of commit activity
    Python 0 MIT 1 0 0 Updated Oct 6, 2025
  • bioRC Public Forked from zapatigna/bioRC

    Synthetic network model and Reservoir Computing codes used in d'Andrea, Puppin, De Domenico "Complex topological features of reservoirs shape learning performances in bio-inspired recurrent neural networks"

    CoMuNeLab/bioRC’s past year of commit activity
    Python 0 MIT 1 0 0 Updated Sep 30, 2025
  • StochasticDynamics Public

    StochasticDynamics is an R package for simulating and visualizing stochastic processes on networks, including epidemic (SIR, SEIR, SIRS), opinion, and reaction–diffusion models. Provides incidence analysis, interactive 3D visualization with rgl, and video export tools.

    CoMuNeLab/StochasticDynamics’s past year of commit activity
    R 0 0 0 0 Updated Sep 25, 2025
  • collectivedyn Public

    R package for simulating and analyzing collective dynamics of coupled systems on networks. Includes continuous-time ODEs (Lorenz, Rössler, Chua, Duffing, etc.), discrete maps (Logistic, Hénon, ARMA, Harmonic), Kuramoto and double-well models, with adaptive rewiring and visualization tools.

    CoMuNeLab/collectivedyn’s past year of commit activity
    R 0 0 0 0 Updated Sep 25, 2025
  • RobustnessProfiles Public

    Simulation and analysis of network robustness under node removal strategies. Includes standard centrality-based attacks and entanglement-based robustness using mutual information profiles. Provides tools to generate synthetic networks, compute robustness curves, and visualize critical thresholds.

    CoMuNeLab/RobustnessProfiles’s past year of commit activity
    R 0 0 0 0 Updated Sep 24, 2025
  • LLM-Agents Public
    CoMuNeLab/LLM-Agents’s past year of commit activity
    0 0 0 0 Updated Sep 24, 2025
  • SpectralEntropyLib Public

    R package providing information-theoretic tools for complex networks via spectral entropies and divergences. Implements von Neumann and Rényi entropies, Jensen–Shannon and Kullback–Leibler divergences, spectral gap and density-matrix based measures, enabling network comparison, profiling, and inference.

    CoMuNeLab/SpectralEntropyLib’s past year of commit activity
    R 0 MIT 0 0 0 Updated Sep 24, 2025
  • SpectralGeometryLib Public

    SpectralGeometry is an R package for spectral analysis of complex networks. It computes Laplacians (combinatorial, random-walk, symmetric), eigen-spectra, heat kernels, diffusion distances, and low-dimensional embeddings, plus metrics for partitions and multilayer graphs.

    CoMuNeLab/SpectralGeometryLib’s past year of commit activity
    R 0 MIT 0 0 0 Updated Sep 24, 2025

Top languages

Loading…

Most used topics

Loading…