{ "info": { "author": "Grzegorz Chilczuk", "author_email": "chgrzegorz@pm.me", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "License :: OSI Approved :: GNU General Public License v2 (GPLv2)", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "# Influ\n[![pipeline status](https://gitlab.com/chgrzegorz/dyplom-code/badges/develop/pipeline.svg)](https://gitlab.com/chgrzegorz/dyplom-code/commits/develop)\nFinding influencers in social network\n\nAn application created as part of the project\n#### Kto na kogo wp\u0142ywa w sieci spo\u0142ecznej - aplikacja do wyszukiwania kluczowych w\u0119z\u0142\u00f3w\n#### Who influences whom in social network - an application for finding key nodes\nAuthor: **Grzegorz Chilczuk**\n\nSupervisor: **dr in\u017c. Rados\u0142aw Michalski**\n\n## Installation\nOnly Python 3.6 or higher are supported.\n\nIf you have satisfied dependencies the installation should be as simple as \n```bash\npip install influ\n```\n\n### Dependencies\nAll dependencies will be installed automatically.\nHowever one of most important dependencies is cool python library called [igraph](https://github.com/igraph/python-igraph/) which core is written in C.\nSometimes it may cause some problem, [igraph documentation](https://igraph.org/python/#pyinstall) should help.\n\nAnother problematic dependency is `pycairo`, here you can find precise [documentation](https://pycairo.readthedocs.io/en/latest/).\n##### Debian / Ubuntu and derivatives\nInstalling those dependencies should help with both igraph and pycairo:\n```bash\n sudo apt install build-essential python-dev libxml2 libxml2-dev zlib1g-dev \n sudo apt install libcairo2-dev pkg-config\n```\n##### Windows\nIf you are using Windows you have to download unofficial installer of igraph [here](https://www.lfd.uci.edu/~gohlke/pythonlibs/#python-igraph)\nand install it by executing:\n```bash\npip install .whl\n```\nDespite that's unofficial it's recommended by maintainers of igraph library. \n\nThe `pycairo` library on Windows need `Microsoft Visual C++ 14.0` to be installed.\n\n#### MacOS\nThere were no attempts to install `influ` on MacOS. Any information about it will be appreciated.\n\n## Konect Reader\nIn order to test your concepts quickly there is a `KonectReader` which simplifies downloading and extracting datasets and loading them into Graph object. \n```python\nfrom influ import reader\n\nkr = reader.KonectReader()\nprint(kr.list) # list available datasets\ngraph = kr.load('manufacturing_emails') # load dataset\n```\nCurrently there is only few datasets available but you can provide your own config file with other datasets specified. Currently only datasets from [Konect](http://konect.uni-koblenz.de) are supported.\n\n#### Your own config file\n```yaml\n# Content of my_custom_config.yaml\nexample_dataset: # name that will be used to access dataset\n name: Example Dataset 1\n url: http://konect.uni-koblenz.de/networks/dataset_examle # url where dataset is described [optional]\n download: http://konect.uni-koblenz.de/downloads/tsv/dataset_examle.tar.bz2 # url where dataset can be downloaded directly\n file: out.dataset_example_example # name of file with \n directed: False # does graph should be considered as directed?\n edge_attributes: # list of names attributes\n - distance # if this list will be empty or there will be more attributes\n - another_attr # it will be named `attrX` where X is index counted from 0\n vertex_attributes: # list of vertex attributes with files where they are stored\n - name: alias # name of attribute\n file: ent.vertex_alias_name # file with attribute\n```\n\nLoading your custom config extends (does not override) those previously loaded.\n```python\nfrom influ import reader\n\nkr = reader.KonectReader('./my_custom_config.yaml') # loading at creation time\nkr.add_config('./my_custom_config.yaml') # adding config after creation\n```\n\n## Working example\n```python\nfrom influ import reader, finder\n\nkr = reader.KonectReader()\ngraph = kr.load('manufacturing_emails')\n\nsfinder = finder.SeedFinder(graph)\nsfinder.configure(number=5, unit='number')\nresult = sfinder.greedy(model=finder.Model.IndependentCascade, depth=1)\nsfinder.plot_influence(result, model=finder.Model.IndependentCascade, depth=1)\n```\n\n# \u2014\u2014\u2014\u2014\u2014\u2014\n# Change log\n\n## [0.3.0]\n### Added\n- User documentation\n\n### Changed\n- Changed License to GNU GPLv2\n\n## [0.2.0] - 2018-12-14\n\n### Added\n- Model enum\n- plot_influence function\n- Windows installation documentation\n\n### Changed\n- Fix influence models evaluation with seed of random function\n- Few minor fixes\n\n## [0.1.0] - 2018-12-01\n\n### Added\n- Loading graph from file\n- Finding key nodes in graph (SeedFinder)\n- Loading example datasets from http://konect.uni-koblenz.de\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://gitlab.com/chgrzegorz/dyplom-code", "keywords": "graph social network influence", "license": "GPLv2", "maintainer": "", "maintainer_email": "", "name": "influ", "package_url": "https://pypi.org/project/influ/", "platform": "", "project_url": "https://pypi.org/project/influ/", "project_urls": { "Documentation": "https://influ.readthedocs.io", "Homepage": "https://gitlab.com/chgrzegorz/dyplom-code" }, "release_url": "https://pypi.org/project/influ/0.3.0/", "requires_dist": [ "python-igraph (<1.0.0,>=0.7.1.post6)", "numpy (<2.0.0,>=1.15.2)", "pandas (<1.0.0,>=0.23.4)", "PyYAML (<4.0.0,>=3.13.0)", "requests (<3.0.0,>=2.20.1)", "matplotlib (<4.0.0,>=3.0.0)", "pycairo (<2.0.0,>=1.17.1)" ], "requires_python": "", "summary": "Who influences whom in social network - an application for finding key nodes", "version": "0.3.0" }, "last_serial": 4667043, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "628de7983ade32533dc76edadba42409", "sha256": "c58639874a900efd79f5e2479feaf4e69efa5a7441c20ee578ee708cef6dc0cc" }, "downloads": -1, "filename": "influ-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "628de7983ade32533dc76edadba42409", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 11679, "upload_time": "2018-12-01T21:50:49", "url": "https://files.pythonhosted.org/packages/6a/6a/c3ee36c31355ee044e9870499b34b544dab2b4be80d2a6369d8f9adbbe0f/influ-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "78442df3f22949bd9dbc12cc0d4660e0", "sha256": "383118d5e10d6b1910648efa9ce6b4e7ea90e0625fc157d28cd18fdc23e2334b" }, "downloads": -1, "filename": "influ-0.1.0.tar.gz", "has_sig": false, "md5_digest": "78442df3f22949bd9dbc12cc0d4660e0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11557, "upload_time": "2018-12-01T21:50:50", "url": "https://files.pythonhosted.org/packages/90/0a/141163945c1bbf817bb9afbe0b67dfed8b3b047653ae4c3605634fd9e4a1/influ-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "8967e5fe894bcecfdea63f43585fadc4", "sha256": "907c6ee93943df8db5de507ccabc53f659ca757c9554bec8341b102c0f973f55" }, "downloads": -1, "filename": "influ-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8967e5fe894bcecfdea63f43585fadc4", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 13186, "upload_time": "2018-12-17T01:54:27", "url": "https://files.pythonhosted.org/packages/b9/1b/969a8341e6cbeeb20a799166b6a192fa42cfc22cbd304a4fe78b227446cd/influ-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "dfee68ae3d33dce2cc61707b2e5e7d87", "sha256": "1f43ab44e1e66501cf0ffa172d363ea81c3169fea9578c689f4bc3a35c672eb5" }, "downloads": -1, "filename": "influ-0.2.0.tar.gz", "has_sig": false, "md5_digest": "dfee68ae3d33dce2cc61707b2e5e7d87", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13199, "upload_time": "2018-12-17T01:54:29", "url": "https://files.pythonhosted.org/packages/27/ab/7b2081761a9afe7fad9a66f639e7d89f44044c370573c3f62b19aa816f69/influ-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "2b188b0084599b113835fe33f63d4b3f", "sha256": "cc0c09a4d9d6db39ba1b91544f1519ec7d8318b2ca559f2f7e1e4e403f0ff167" }, "downloads": -1, "filename": "influ-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "2b188b0084599b113835fe33f63d4b3f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 19622, "upload_time": "2019-01-07T01:15:58", "url": "https://files.pythonhosted.org/packages/19/4c/e5ca7eb1e8d4c3a288aa8d4137dbbb34ce19552f407e098cf6f9ff26ebf1/influ-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "130536e29a8ba6ea2357295e0190880f", "sha256": "b1af8620dca9a842cbc9215ab9020dc619fb1c74b05e8500ccbc5b6d17d49463" }, "downloads": -1, "filename": "influ-0.3.0.tar.gz", "has_sig": false, "md5_digest": "130536e29a8ba6ea2357295e0190880f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19771, "upload_time": "2019-01-07T01:16:00", "url": "https://files.pythonhosted.org/packages/f3/fe/8916c86a8c95f6ceabbef8c17be95ea734ef55bedf2a27e17c0d9ba53023/influ-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "2b188b0084599b113835fe33f63d4b3f", "sha256": "cc0c09a4d9d6db39ba1b91544f1519ec7d8318b2ca559f2f7e1e4e403f0ff167" }, "downloads": -1, "filename": "influ-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "2b188b0084599b113835fe33f63d4b3f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 19622, "upload_time": "2019-01-07T01:15:58", "url": "https://files.pythonhosted.org/packages/19/4c/e5ca7eb1e8d4c3a288aa8d4137dbbb34ce19552f407e098cf6f9ff26ebf1/influ-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "130536e29a8ba6ea2357295e0190880f", "sha256": "b1af8620dca9a842cbc9215ab9020dc619fb1c74b05e8500ccbc5b6d17d49463" }, "downloads": -1, "filename": "influ-0.3.0.tar.gz", "has_sig": false, "md5_digest": "130536e29a8ba6ea2357295e0190880f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19771, "upload_time": "2019-01-07T01:16:00", "url": "https://files.pythonhosted.org/packages/f3/fe/8916c86a8c95f6ceabbef8c17be95ea734ef55bedf2a27e17c0d9ba53023/influ-0.3.0.tar.gz" } ] }