{ "info": { "author": "Rick Lupton", "author_email": "mail@ricklupton.name", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": ".. image:: docs/_static/logo.png\n :alt: floWeaver\n :align: center\n :width: 697\n :height: 222\n :target: https://github.com/ricklupton/floweaver\n\n|\n\n.. image:: https://badge.fury.io/py/floweaver.svg\n :target: https://badge.fury.io/py/floweaver\n :alt: PyPI Status\n.. image:: https://readthedocs.org/projects/floweaver/badge/?version=latest\n :target: http://floweaver.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n.. image:: https://travis-ci.org/ricklupton/floweaver.svg?branch=master\n :target: https://travis-ci.org/ricklupton/floweaver\n :alt: Test Status\n.. image:: https://codecov.io/gh/ricklupton/floweaver/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/ricklupton/floweaver\n :alt: Coverage Status\n.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.161970.svg\n :target: https://doi.org/10.5281/zenodo.596249\n :alt: DOI\n\nby `Rick Lupton `_ and `Contributors`_\n\nMany kinds of data can be thought of as 'flows': energy and materials moving\nthrough industry, money flowing through the economy, telephone lines moving\nbetween providers, voters moving between parties. **floWeaver** helps you to\nexchange and analyse flow data and visualise it using `Sankey diagrams\n`_.\n\nFor example, here is some data on flows of fruit from farms to customers:\n\n.. image:: docs/demo_table.png\n\nWith floWeaver you can **visualise** this as a variety of **Sankey diagrams**\ndepending on what you want to show:\n\n.. image:: docs/demo_animation/demo.gif\n\nAlthough there are a variety of tools for working with flow data and Sankey\ndiagrams in particular contexts, there are no open data formats for sharing data\nbetween tools and domains. We aim to provide a **common data format and data converters** \nto support interoperability and open data.\n\nYou are free to copy, modify, and distribute floWeaver with attribution\nunder the terms of the MIT license. See the `LICENSE `_ file\nfor details. If you find it useful please acknowledge that by citing floWeaver \n(`see below <#citing-floweaver>`_).\n\nGet started using floWeaver\n---------------------------\n\nfloWeaver is a Python package, but you can successfully use it as a data analysis\ntool even without too much familiarity with Python. The best way to get started is\nto use it in a `Jupyter notebook `_ (more advanced users can\nuse it outside the notebook environment to export JSON/SVG but this is still\nunder development; see `this comment\n`_).\n\n\ud83d\ude80 **Try floWeaver online with no installation:** `Quickstart tutorial\n`__.\n\nTo install floWeaver locally, you need Python 3 installed (you might want to install it \nusing `Anaconda or Miniconda `_); see the `installation page\n`_ for full details.\n\nInstallation using conda\n________________________\n\nYou can install floweaver using conda:\n\n.. code-block:: console\n\n conda install -c conda-forge floweaver\n\nYou likely also want `ipysankeywidget `_ to show Sankey\ndiagrams in the Jupyter notebook. Install it using conda:\n\n.. code-block:: console\n\n conda install -c conda-forge ipysankeywidget\n\n(that's it \u2014 the jupyter nbextensions are enabled automatically when using conda)\n\nInstallation using pip\n______________________\n\nAlternatively, you can install floweaver using pip:\n\n.. code-block:: console\n\n pip install floweaver\n\nYou likely also want `ipysankeywidget `_ to show Sankey\ndiagrams in the Jupyter notebook. Install this using pip and enable:\n\n.. code-block:: console\n\n pip install ipysankeywidget\n jupyter nbextension enable --py --sys-prefix ipysankeywidget\n\nipywidgets also needs to be enabled. You might have already done this, but missing it out is a\ncommon cause of problems so it doesn't hurt to do it again!\n\n.. code-block:: console\n\n jupyter nbextension enable --py --sys-prefix widgetsnbextension\n\nQuickstart tutorial\n___________________\n\nTo get started, open the `quickstart tutorial `__ in\nJupyter notebook and step through the notebook cells to produce the fruit example shown above.\n\nFind out more \ud83d\udcd6\n________________\n\n`Tutorials, cookbook examples, and API documentation are all available on ReadTheDocs\n`_\n\nIf you have a question that isn't answered please `open an issue on GitHub\n`_, if there isn't one there already. You can\nalso use the `Gitter chatroom `_ for discussion and questions.\n\nContributing \ud83c\udf81\n---------------\n\nThanks for your interest in contributing! There are many ways to contribute to floWeaver: \nsharing examples of work done using it, suggestions for improving the documentation, examples\nof things that are more difficult than they should be or don't work, as well as actual fixes to\ncode and documentation. To get started see `CONTRIBUTING.md `_ and our `code of\nconduct `_.\n\nWe have a `detailed Roadmap `_ showing what we\nare working on up to May 2018; beyond that there is the `longer-term Roadmap `_. We also have `good first issues grouped by type of contribution `_.\n\nHow does it work?\n-----------------\n\nfloWeaver builds on the approach described in the paper `Hybrid Sankey diagrams:\nVisual analysis of multidimensional data for understanding resource use\n`_. It uses `ipysankeywidget \n`_ and `d3-sankey-diagram \n`_ for actually drawing the Sankey\ndiagrams.\n\n.. image:: docs/project_components.png\n\nCiting floWeaver\n----------------\n\nIf floweaver has been significant in a project that leads to a publication, please\nacknowledge that by citing the paper linked above:\n\n R. C. Lupton and J. M. Allwood, \u2018Hybrid Sankey diagrams: Visual analysis of multidimensional\n data for understanding resource use\u2019, Resources, Conservation and Recycling, vol. 124, pp.\n 141\u2013151, Sep. 2017. DOI: 10.1016/j.resconrec.2017.05.002\n\nand/or citing the software itself; you can `get a citation of the latest version from Zenodo \n`_.\n\nContributors\n------------\n\n- Leo Paoli (documentation)\n- Konstantin Stadler (issues & use in IOA)\n- Dhanuka Lakshan\n- Andreas Fehlner\n- Elliott Sales de Andrade\n- @abmakko (the logo)\n- Chris Barnes (@clbarnes)\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ricklupton/floweaver", "keywords": "Sankey diagram flow data visualisation", "license": "", "maintainer": "", "maintainer_email": "", "name": "floweaver", "package_url": "https://pypi.org/project/floweaver/", "platform": "", "project_url": "https://pypi.org/project/floweaver/", "project_urls": { "Homepage": "https://github.com/ricklupton/floweaver" }, "release_url": "https://pypi.org/project/floweaver/2.0.0a5/", "requires_dist": [ "numpy", "pandas", "networkx (>=2.0)", "attrs", "palettable", "sphinx ; extra == 'docs'", "nbsphinx ; extra == 'docs'", "jupyter-client ; extra == 'docs'", "ipykernel ; extra == 'docs'", "ipysankeywidget ; extra == 'docs'", "pytest ; extra == 'test'", "matplotlib ; extra == 'test'", "codecov ; extra == 'test'", "pytest-cov ; extra == 'test'" ], "requires_python": ">=3.5", "summary": "View flow data as Sankey diagrams.", "version": "2.0.0a5" }, "last_serial": 5297902, "releases": { "2.0.0a": [ { "comment_text": "", "digests": { "md5": "8d0c664709b9c47cd9737a995f80e17b", "sha256": "536bf1c142f5b675d31bf66698bed69dff40a28c3c896933475a59de8bb7badd" }, "downloads": -1, "filename": "floweaver-2.0.0a-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "8d0c664709b9c47cd9737a995f80e17b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 63237, "upload_time": "2018-01-19T20:29:08", "url": "https://files.pythonhosted.org/packages/af/13/f98cdc65902f6ebdf5ac06631b7adf5f116545a4a933424ac43c06bea2e2/floweaver-2.0.0a-py2.py3-none-any.whl" } ], "2.0.0a2": [ { "comment_text": "", "digests": { "md5": "f5279862553269756bde6261387988d3", "sha256": "41f338d64686a4ee5ee700622ff6494b4dc8268065e2979e29ea5c505d0c7b52" }, "downloads": -1, "filename": "floweaver-2.0.0a2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "f5279862553269756bde6261387988d3", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 63252, "upload_time": "2018-01-22T09:59:06", "url": "https://files.pythonhosted.org/packages/07/74/4f9cdfd4155469bbe1312970409a353033e72cea85aac2c2d34e43a2a95e/floweaver-2.0.0a2-py2.py3-none-any.whl" } ], "2.0.0a3": [ { "comment_text": "", "digests": { "md5": "696cca34b8bb6133871f3905611c9eea", "sha256": "3d50e9d77c0603c2cffb4350f5e847addddd0b2b59bfba78e11d91f79438928f" }, "downloads": -1, "filename": "floweaver-2.0.0a3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "696cca34b8bb6133871f3905611c9eea", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 25630, "upload_time": "2018-02-21T14:58:03", "url": "https://files.pythonhosted.org/packages/e0/21/b90cc46c27b6262573f13a90e73f0acfa8f16fa83d251fe15befd2d085ed/floweaver-2.0.0a3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "979df1406d72ad571794355e0018d5f3", "sha256": "83b3f5f016eee8914739ce03a0d40b8b40e1d85b76dc4bafb366b35731fe423d" }, "downloads": -1, "filename": "floweaver-2.0.0a3.tar.gz", "has_sig": false, "md5_digest": "979df1406d72ad571794355e0018d5f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31126, "upload_time": "2018-02-21T14:58:06", "url": "https://files.pythonhosted.org/packages/11/84/d3b851bb1a7be9d6d6f86d88d36956617cb8029818fba645352da9052b62/floweaver-2.0.0a3.tar.gz" } ], "2.0.0a4": [ { "comment_text": "", "digests": { "md5": "48035a7056eede69676f0f512301aa19", "sha256": "b417916e8d99719f7bd7debe7a95ee4e118e05200ef52991ade086b3626b3b66" }, "downloads": -1, "filename": "floweaver-2.0.0a4.tar.gz", "has_sig": false, "md5_digest": "48035a7056eede69676f0f512301aa19", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 36601, "upload_time": "2018-10-04T13:48:51", "url": "https://files.pythonhosted.org/packages/46/c2/81402b5a9b3babaeaad4fca85a5a8e6776896e847816b8afea01b96e4a05/floweaver-2.0.0a4.tar.gz" } ], "2.0.0a5": [ { "comment_text": "", "digests": { "md5": "b34c7b8dabae8557260cbfe8c7c89c2a", "sha256": "3e66a2c6a4e76d96684fd9f065d43ea757f2b12f722aebe4d378230fa79b9fd0" }, "downloads": -1, "filename": "floweaver-2.0.0a5-py3-none-any.whl", "has_sig": false, "md5_digest": "b34c7b8dabae8557260cbfe8c7c89c2a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 27103, "upload_time": "2019-05-21T13:28:26", "url": "https://files.pythonhosted.org/packages/a7/d1/fb0c5af530a6a79b40a60dbef322ea9aa32e35219b7cfc1c300a29beb96b/floweaver-2.0.0a5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "39fdfa7d90ae03fecc72e50800e1d596", "sha256": "c4e4c13c172a757cca2e09e63c94553b9ccedc7072c97159eb4a7bc3982c316e" }, "downloads": -1, "filename": "floweaver-2.0.0a5.tar.gz", "has_sig": false, "md5_digest": "39fdfa7d90ae03fecc72e50800e1d596", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 1352620, "upload_time": "2019-05-21T13:28:29", "url": "https://files.pythonhosted.org/packages/70/51/bd0c6659825ecf96f539a5c8917c797a8ef7b009e0e587a5fe81b81ff70b/floweaver-2.0.0a5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "b34c7b8dabae8557260cbfe8c7c89c2a", "sha256": "3e66a2c6a4e76d96684fd9f065d43ea757f2b12f722aebe4d378230fa79b9fd0" }, "downloads": -1, "filename": "floweaver-2.0.0a5-py3-none-any.whl", "has_sig": false, "md5_digest": "b34c7b8dabae8557260cbfe8c7c89c2a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 27103, "upload_time": "2019-05-21T13:28:26", "url": "https://files.pythonhosted.org/packages/a7/d1/fb0c5af530a6a79b40a60dbef322ea9aa32e35219b7cfc1c300a29beb96b/floweaver-2.0.0a5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "39fdfa7d90ae03fecc72e50800e1d596", "sha256": "c4e4c13c172a757cca2e09e63c94553b9ccedc7072c97159eb4a7bc3982c316e" }, "downloads": -1, "filename": "floweaver-2.0.0a5.tar.gz", "has_sig": false, "md5_digest": "39fdfa7d90ae03fecc72e50800e1d596", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 1352620, "upload_time": "2019-05-21T13:28:29", "url": "https://files.pythonhosted.org/packages/70/51/bd0c6659825ecf96f539a5c8917c797a8ef7b009e0e587a5fe81b81ff70b/floweaver-2.0.0a5.tar.gz" } ] }