Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Network Diffusion - spreading models in networks

License: GPL PyPI version

Tests Builds Docs codecov FOSSA Status

This Python library provides a versatile toolkit for simulating diffusion processes in complex networks. It offers support for various types of models, including temporal models, multilayer models, and combinations of both.

Documentation is available here!

Key Features

  • Complex Network Simulation: The library enables users to simulate diffusion processes in complex networks with ease. Whether you are studying information spread, disease propagation, or any other diffusion phenomena, this library has you covered.

  • Temporal Models: You can work with temporal models, allowing you to capture the dynamics of processes over time. These temporal models can be created using regular time windows or leverage CogSnet.

  • Multilayer Networks: The library supports multilayer networks, which are essential for modelling real-world systems with interconnected layers of complexity.

  • Predefined Models: You have the option to use predefined diffusion models such as the Linear Threshold Model, Independent Cascade Model, and more. These models simplify the simulation process, allowing you to focus on your specific research questions.

  • Custom Models: Additionally, Network Diffusion allows you to define your own diffusion models using open interfaces, providing flexibility for researchers to tailor simulations to their unique requirements.

  • Centrality Measures: The library provides a wide range of centrality measures specifically designed for multilayer networks. These measures can be valuable for selecting influential seed nodes in diffusion processes.

  • NetworkX Compatible: Last but not least, the package is built on top of NetworkX, ensuring seamless compatibility with this popular Python library for network analysis. You can easily integrate it into your existing NetworkX-based workflows.

How to install this package

To install package, run this command: pip install network_diffusion. Please note that we currently support Linux, MacOS, and Windows only.

To contribute, please clone the repo, switch to a new feature-branch, and install the environment:

conda env create -f requirements/environment.yml
conda activate network-diffusion

Citing us

If you used the package, please cite us as:

@article{czuba2024networkdiffusion,
  title={Network Diffusion – Framework to Simulate Spreading Processes in Complex Networks},
  author={
    Czuba, Micha{\l} and Nurek, Mateusz and Serwata, Damian and Qi, Yu-Xuan and
    Jia, Mingshan and Musial, Katarzyna and Michalski, Rados{\l}aw and Br{\'o}dka, Piotr
  },
  journal={Big Data Mining And Analytics},
  volume={},
  number={},
  pages={1-13},
  year={2024},
  publisher={IEEE},
  doi = {10.26599/BDMA.2024.9020010},
  url={https://doi.org/10.26599/BDMA.2024.9020010},
}

Particularly if you used the functionality of simulating coexisting phenomena in complex networks, please add the following work:

@inproceedings{czuba2022coexisting,
    author={Czuba, Micha\l{} and Br\'{o}dka, Piotr},
    booktitle={2022 IEEE 9th International Conference on Data Science and Advanced Analytics (DSAA)},
    title={Simulating Spreading of Multiple Interacting Processes in Complex Networks},
    volume={},
    number={},
    pages={1-10},
    year={2022},
    month={oct},
    publisher={IEEE},
    address={Shenzhen, China},
    doi={10.1109/DSAA54385.2022.10032425},
    url={https://ieeexplore.ieee.org/abstract/document/10032425},
}

Bugs reporting

Please report bugs on this board or by sending a direct e-mail to the main author.

About us

This library is developed and maintained by Network Science Lab at WUST and external partners. For more information and updates, please visit our website.

Metadata

Release files for network-diffusion 0.14.1rc20240531185053

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

Source distribution (sdist)

Source distribution for network-diffusion 0.14.1rc20240531185053
File Size Uploaded Provenance Actions
network_diffusion-0.14.1rc20240531185053.tar.gz 66.5 kB Without provenance Details for network_diffusion-0.14.1rc20240531185053.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for network-diffusion 0.14.1rc20240531185053
File Interpreter ABI Platform Actions
network_diffusion-0.14.1rc20240531185053-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details for network_diffusion-0.14.1rc20240531185053-cp310-cp310-win_amd64.whl
network_diffusion-0.14.1rc20240531185053-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.5+ x86-64 Details for network_diffusion-0.14.1rc20240531185053-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.whl
network_diffusion-0.14.1rc20240531185053-cp310-cp310-macosx_10_9_universal2.whl CPython 3.10 CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64) Details for network_diffusion-0.14.1rc20240531185053-cp310-cp310-macosx_10_9_universal2.whl

Total release size: 397.8 kB

Release files / network_diffusion-0.14.1rc20240531185053.tar.gz

Download URL network_diffusion-0.14.1rc20240531185053.tar.gz
Size 66.5 kB
Tags Source
SHA-256 checksum
How to use checksums
ef6a0a96993d83ed164aafba82685ebbcba2b517333a33a8c9f56076b6bb1c49
BLAKE2b-256 checksum
How to use checksums
31563dd339f8bdd2d013817a0677389a24ecec72869f7fdf1bf9c9e70feaa492
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / network_diffusion-0.14.1rc20240531185053-cp310-cp310-win_amd64.whl

Download URL network_diffusion-0.14.1rc20240531185053-cp310-cp310-win_amd64.whl
Size 104.2 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
05968e031646f6dc3ce8635064669ce3711fa7cdef9cb22e31c670243940e512
BLAKE2b-256 checksum
How to use checksums
1429785bf4cfba87b14b6b1a03910df93a6051c295002ac6990f308cd6f04203
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / network_diffusion-0.14.1rc20240531185053-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.whl

Download URL network_diffusion-0.14.1rc20240531185053-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Size 119.6 kB
Tags CPython 3.10 Linux glibc 2.5+ x86-64
SHA-256 checksum
How to use checksums
68fd11c3fb90ea105051edff808a177bf1a938ce58246ca3d5d0c625905a84cb
BLAKE2b-256 checksum
How to use checksums
66eef52ae0f0525ed5d4281ef90d4f898c830c605a37797c612d9a86a44bd813
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / network_diffusion-0.14.1rc20240531185053-cp310-cp310-macosx_10_9_universal2.whl

Download URL network_diffusion-0.14.1rc20240531185053-cp310-cp310-macosx_10_9_universal2.whl
Size 107.5 kB
Tags CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
f3a81db7ba1130665f8e650c48100c7a9eef4d7b716f661e806d03e64875c348
BLAKE2b-256 checksum
How to use checksums
ce7fb5462111fad3d3b35f66a8242e0dee13e7107da4e30344da21ee88054164
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.3

Security for network-diffusion 0.14.1rc20240531185053

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

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