# NDlib - Network Diffusion Library
[![pyversions](https://img.shields.io/pypi/pyversions/ndlib.svg)](https://badge.fury.io/py/ndlib)
[![Build Status](https://travis-ci.org/GiulioRossetti/ndlib.svg?branch=master)](https://travis-ci.org/GiulioRossetti/ndlib)
[![Coverage Status](https://coveralls.io/repos/github/GiulioRossetti/ndlib/badge.svg?branch=master)](https://coveralls.io/github/GiulioRossetti/ndlib?branch=master)
[![Documentation Status](https://readthedocs.org/projects/ndlib/badge/?version=latest)](http://ndlib.readthedocs.io/en/latest/?badge=latest)
[![Updates](https://pyup.io/repos/github/GiulioRossetti/ndlib/shield.svg)](https://pyup.io/repos/github/GiulioRossetti/ndlib/)
[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/GiulioRossetti/ndlib.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/GiulioRossetti/ndlib/context:python)
[![DOI](https://zenodo.org/badge/59556819.svg)](https://zenodo.org/badge/latestdoi/59556819)
[![Downloads](https://pepy.tech/badge/ndlib)](https://pepy.tech/project/ndlib)
[![Downloads](https://pepy.tech/badge/ndlib/month)](https://pepy.tech/project/ndlib)
[![SBD++](https://img.shields.io/badge/Available%20on-SoBigData%2B%2B-green)](https://sobigdata.d4science.org/group/sobigdata-gateway/explore?siteId=20371853)
![NDlib logo](https://github.com/GiulioRossetti/ndlib/blob/master/docs/ndlogo2.png)
NDlib provides implementations of several spreading and opinion dynamics models.
The project documentation can be found on [ReadTheDocs](http://ndlib.readthedocs.io).
If you use ``NDlib`` as support to your research consider citing:
> G. Rossetti, L. Milli, S. Rinzivillo, A. Sirbu, D. Pedreschi, F. Giannotti.
> **NDlib: a Python Library to Model and Analyze Diffusion Processes Over Complex Networks.**
> Journal of Data Science and Analytics. 2017.
> [DOI:0.1007/s41060-017-0086-6](https://doi.org/10.1007/s41060-017-0086-6) (pre-print available on [arXiv](https://arxiv.org/abs/1801.05854))
> G. Rossetti, L. Milli, S. Rinzivillo, A. Sirbu, D. Pedreschi, F. Giannotti.
> "**NDlib: Studying Network Diffusion Dynamics**",
> IEEE International Conference on Data Science and Advanced Analytics, DSAA. 2017.
## Promo Video
[![Promo](https://img.youtube.com/vi/tYHNOuKJwbE/0.jpg)](https://www.youtube.com/watch?v=tYHNOuKJwbEE)
## Installation
To install the library just download (or clone) the current project and copy the ndlib folder in the root of your application.
Alternatively use pip:
```bash
sudo pip install ndlib
```
## Documentation, Tutorials and Online Environments
For examples, tutorials and a complete reference visit the project documentation website on [ReadTheDocs](http://ndlib.readthedocs.io).
If you would like to test ``NDlib`` functionalities withouth installing anything on your machine consider using the preconfigured Jupyter Hub instances offered by [SoBigData++](https://sobigdata.d4science.org/group/sobigdata-gateway/explore?siteId=20371853).
## Jupyter Notebook Tutorial
Interested in an extensive tutorial on NDlib? Check out the official Jupyter Notebooks!
[NDlib Overview](https://colab.research.google.com/github/KDDComplexNetworkAnalysis/CNA_Tutorials/blob/master/NDlib.ipynb#scrollTo=d80DUNRkKIn4)
[NDlib-Rest](https://colab.research.google.com/github/KDDComplexNetworkAnalysis/CNA_Tutorials/blob/master/NDlib-REST.ipynb)
## Collaborate with us!
``NDlib`` is an active project, any contribution is welcome!
If you like to include your model in NDlib (as well as in [NDlib-REST](https://github.com/GiulioRossetti/ndlib-rest)) 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 our [rules](https://github.com/GiulioRossetti/ndlib/blob/master/.github/CONTRIBUTING.md), issue a proper [pull request](https://github.com/GiulioRossetti/ndlib/blob/master/.github/PULL_REQUEST_TEMPLATE.md) /[bug report](https://github.com/GiulioRossetti/ndlib/blob/master/.github/ISSUE_TEMPLATE/bug_report.md) / [feature request](https://github.com/GiulioRossetti/ndlib/blob/master/.github/ISSUE_TEMPLATE/feature_request.md).
Do you want to be part of the NDlib community to discuss enhancements, desiderata, bug fix? Join us on **Slack**!
[<img align="middle" width="150" src="docs/join-slack-team.png">](https://join.slack.com/t/ndlib/shared_invite/enQtNTA2ODk1MzQzODE0LTU2YWEzZjAzNDFiNTBlY2QxN2IyODAwMjgyMDBmYjQ2NzhjZjA4NzA1M2U0ZmZlN2I1NGM5OTI2N2I4ZTFmMzQ)
We are a welcoming community... just follow the [Code of Conduct](https://github.com/GiulioRossetti/ndlib/blob/master/.github/CODE_OF_CONDUCT.md).
Raw data
{
"_id": null,
"home_page": "https://github.com/GiulioRossetti/ndlib",
"name": "ndlib",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "epidemics opinion-dynamics simulator complex-networks",
"author": "Giulio Rossetti",
"author_email": "giulio.rossetti@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fe/9c/7a6e116912b564d3d9c2b4071ca8ef1c1789ca2ba810249af3a10304afa3/ndlib-5.1.1.tar.gz",
"platform": "",
"description": "# NDlib - Network Diffusion Library\n\n[![pyversions](https://img.shields.io/pypi/pyversions/ndlib.svg)](https://badge.fury.io/py/ndlib)\n[![Build Status](https://travis-ci.org/GiulioRossetti/ndlib.svg?branch=master)](https://travis-ci.org/GiulioRossetti/ndlib)\n[![Coverage Status](https://coveralls.io/repos/github/GiulioRossetti/ndlib/badge.svg?branch=master)](https://coveralls.io/github/GiulioRossetti/ndlib?branch=master)\n[![Documentation Status](https://readthedocs.org/projects/ndlib/badge/?version=latest)](http://ndlib.readthedocs.io/en/latest/?badge=latest)\n[![Updates](https://pyup.io/repos/github/GiulioRossetti/ndlib/shield.svg)](https://pyup.io/repos/github/GiulioRossetti/ndlib/)\n[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/GiulioRossetti/ndlib.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/GiulioRossetti/ndlib/context:python)\n[![DOI](https://zenodo.org/badge/59556819.svg)](https://zenodo.org/badge/latestdoi/59556819)\n[![Downloads](https://pepy.tech/badge/ndlib)](https://pepy.tech/project/ndlib)\n[![Downloads](https://pepy.tech/badge/ndlib/month)](https://pepy.tech/project/ndlib)\n[![SBD++](https://img.shields.io/badge/Available%20on-SoBigData%2B%2B-green)](https://sobigdata.d4science.org/group/sobigdata-gateway/explore?siteId=20371853)\n\n\n![NDlib logo](https://github.com/GiulioRossetti/ndlib/blob/master/docs/ndlogo2.png)\n\nNDlib provides implementations of several spreading and opinion dynamics models.\n\nThe project documentation can be found on [ReadTheDocs](http://ndlib.readthedocs.io).\n\nIf you use ``NDlib`` as support to your research consider citing:\n\n> G. Rossetti, L. Milli, S. Rinzivillo, A. Sirbu, D. Pedreschi, F. Giannotti.\n> **NDlib: a Python Library to Model and Analyze Diffusion Processes Over Complex Networks.**\n> Journal of Data Science and Analytics. 2017. \n> [DOI:0.1007/s41060-017-0086-6](https://doi.org/10.1007/s41060-017-0086-6) (pre-print available on [arXiv](https://arxiv.org/abs/1801.05854))\n\n> G. Rossetti, L. Milli, S. Rinzivillo, A. Sirbu, D. Pedreschi, F. Giannotti.\n> \"**NDlib: Studying Network Diffusion Dynamics**\", \n> IEEE International Conference on Data Science and Advanced Analytics, DSAA. 2017.\n\n## Promo Video\n\n[![Promo](https://img.youtube.com/vi/tYHNOuKJwbE/0.jpg)](https://www.youtube.com/watch?v=tYHNOuKJwbEE)\n\n## Installation\n\nTo install the library just download (or clone) the current project and copy the ndlib folder in the root of your application.\n\nAlternatively use pip:\n```bash\nsudo pip install ndlib\n```\n\n## Documentation, Tutorials and Online Environments\n\nFor examples, tutorials and a complete reference visit the project documentation website on [ReadTheDocs](http://ndlib.readthedocs.io).\n\nIf you would like to test ``NDlib`` functionalities withouth installing anything on your machine consider using the preconfigured Jupyter Hub instances offered by [SoBigData++](https://sobigdata.d4science.org/group/sobigdata-gateway/explore?siteId=20371853).\n\n\n## Jupyter Notebook Tutorial\n\nInterested in an extensive tutorial on NDlib? Check out the official Jupyter Notebooks!\n\n[NDlib Overview](https://colab.research.google.com/github/KDDComplexNetworkAnalysis/CNA_Tutorials/blob/master/NDlib.ipynb#scrollTo=d80DUNRkKIn4)\n\n[NDlib-Rest](https://colab.research.google.com/github/KDDComplexNetworkAnalysis/CNA_Tutorials/blob/master/NDlib-REST.ipynb)\n\n## Collaborate with us!\n\n``NDlib`` is an active project, any contribution is welcome!\n\nIf you like to include your model in NDlib (as well as in [NDlib-REST](https://github.com/GiulioRossetti/ndlib-rest)) feel free to fork the project, open an issue and contact us.\n\n### How to contribute to this project?\n\nContributing is good, doing it correctly is better! Check out our [rules](https://github.com/GiulioRossetti/ndlib/blob/master/.github/CONTRIBUTING.md), issue a proper [pull request](https://github.com/GiulioRossetti/ndlib/blob/master/.github/PULL_REQUEST_TEMPLATE.md) /[bug report](https://github.com/GiulioRossetti/ndlib/blob/master/.github/ISSUE_TEMPLATE/bug_report.md) / [feature request](https://github.com/GiulioRossetti/ndlib/blob/master/.github/ISSUE_TEMPLATE/feature_request.md).\n\nDo you want to be part of the NDlib community to discuss enhancements, desiderata, bug fix? Join us on **Slack**!\n\n[<img align=\"middle\" width=\"150\" src=\"docs/join-slack-team.png\">](https://join.slack.com/t/ndlib/shared_invite/enQtNTA2ODk1MzQzODE0LTU2YWEzZjAzNDFiNTBlY2QxN2IyODAwMjgyMDBmYjQ2NzhjZjA4NzA1M2U0ZmZlN2I1NGM5OTI2N2I4ZTFmMzQ)\n\nWe are a welcoming community... just follow the [Code of Conduct](https://github.com/GiulioRossetti/ndlib/blob/master/.github/CODE_OF_CONDUCT.md).\n\n\n\n",
"bugtrack_url": null,
"license": "BSD-Clause-2",
"summary": "Network Diffusion Library",
"version": "5.1.1",
"split_keywords": [
"epidemics",
"opinion-dynamics",
"simulator",
"complex-networks"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "f9fa2587d8e466abd8f7bf5e55571d0f",
"sha256": "06623493e9e5e077759da9c16923ccf4309c61460c972f921d66164d75f474e4"
},
"downloads": -1,
"filename": "ndlib-5.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f9fa2587d8e466abd8f7bf5e55571d0f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 110245,
"upload_time": "2021-09-27T09:18:03",
"upload_time_iso_8601": "2021-09-27T09:18:03.296883Z",
"url": "https://files.pythonhosted.org/packages/15/dc/1d7fd0b5a0917a8f27ae2d7fa6009857991ed05a89f65b352d937439f9ab/ndlib-5.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "15f5e84ae2c037463528ad05314c48b8",
"sha256": "a8ab2ce7ae3ce2f4116476da6a7d24b34a8b64a78af167a4f7d986153b49fc3c"
},
"downloads": -1,
"filename": "ndlib-5.1.1.tar.gz",
"has_sig": false,
"md5_digest": "15f5e84ae2c037463528ad05314c48b8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 49999,
"upload_time": "2021-09-27T09:18:05",
"upload_time_iso_8601": "2021-09-27T09:18:05.129165Z",
"url": "https://files.pythonhosted.org/packages/fe/9c/7a6e116912b564d3d9c2b4071ca8ef1c1789ca2ba810249af3a10304afa3/ndlib-5.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2021-09-27 09:18:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "GiulioRossetti",
"github_project": "ndlib",
"travis_ci": true,
"coveralls": true,
"github_actions": false,
"requirements": [
{
"name": "python-igraph",
"specs": []
},
{
"name": "netdispatch",
"specs": [
[
">=",
"0.0.7"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.17.*"
]
]
},
{
"name": "networkx",
"specs": [
[
">=",
"2.4"
]
]
},
{
"name": "bokeh",
"specs": [
[
">=",
"1.3.4"
]
]
},
{
"name": "matplotlib",
"specs": [
[
">=",
"3.0.*"
]
]
},
{
"name": "pandas",
"specs": []
},
{
"name": "tqdm",
"specs": []
},
{
"name": "salib",
"specs": [
[
">=",
"1.3"
]
]
},
{
"name": "pillow",
"specs": []
},
{
"name": "pyintergraph",
"specs": []
},
{
"name": "six",
"specs": []
},
{
"name": "tqdm",
"specs": []
},
{
"name": "sklearn",
"specs": []
},
{
"name": "docutils",
"specs": [
[
"==",
"0.15.2"
]
]
}
],
"lcname": "ndlib"
}