DeepGraph


NameDeepGraph JSON
Version 0.2.1 PyPI version JSON
download
home_pagehttps://github.com/deepgraph/deepgraph/
SummaryAnalyze Data with Pandas-based Networks.
upload_time2018-03-13 16:31:43
maintainer
docs_urlNone
authorDominik Traxl
requires_python
licenseBSD
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
|Anaconda Version| |Anaconda Downloads| |Documentation| |PyPi|

DeepGraph
=========

DeepGraph is a scalable, general-purpose data analysis package. It implements a
`network representation <https://en.wikipedia.org/wiki/Network_theory>`_ based
on `pandas <http://pandas.pydata.org/>`_
`DataFrames <http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.html>`_
and provides methods to construct, partition and plot networks, to interface
with popular network packages and more.

It is based on a new network representation introduced
`here <http://arxiv.org/abs/1604.00971>`_. DeepGraph is also capable of
representing
`multilayer networks <http://deepgraph.readthedocs.io/en/latest/tutorials/terrorists.html>`_.


Main Features
-------------

This network package is targeted specifically towards
`Pandas <http://pandas.pydata.org/>`_ users. Utilizing one of Pandas' primary
data structures, the
`DataFrame <http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.html>`_,
we represent the (super)nodes of a graph by one set of tables, and their
pairwise relations (i.e. the (super)edges of a graph) by another set of tables.
DeepGraph's main features are

- `Create edges <https://deepgraph.readthedocs.io/en/latest/api_reference.html#creating-edges>`_:
  Methods that enable an iterative, yet
  vectorized computation of pairwise relations (edges) between nodes using
  arbitrary, user-defined functions on the nodes' properties. The methods
  provide arguments to parallelize the computation and control memory consumption,
  making them suitable for very large data-sets and adjustable to whatever
  hardware you have at hand (from netbooks to cluster architectures).

- `Partition nodes, edges or a graph <https://deepgraph.readthedocs.io/en/latest/api_reference.html#graph-partitioning>`_:
  Methods to partition nodes,
  edges or a graph by the graph’s properties and labels, enabling the
  aggregation, computation and allocation of information on and between
  arbitrary *groups* of nodes. These methods also let you express
  elaborate queries on the information contained in a deep graph.

- `Interfaces to other packages <https://deepgraph.readthedocs.io/en/latest/api_reference.html#graph-interfaces>`_:
  Methods to convert to common
  network representations and graph objects of popular Python network packages
  (e.g., SciPy sparse matrices, NetworkX graphs, graph-tool graphs).

- `Plotting <https://deepgraph.readthedocs.io/en/latest/api_reference.html#plotting-methods>`_:
  A number of useful plotting methods for networks,
  including drawings on geographical map projections.


Quick Start
-----------

DeepGraph can be installed via pip from
`PyPI <https://pypi.python.org/pypi/deepgraph>`_

::

   $ pip install deepgraph

or if you're using `Conda <http://conda.pydata.org/docs/>`_,
install with

::

   $ conda install -c conda-forge deepgraph

Then, import and get started with::

   >>> import deepgraph as dg
   >>> help(dg)


Documentation
-------------

The official documentation is hosted here:
http://deepgraph.readthedocs.io

The documentation provides a good starting point for learning how
to use the library. Expect the docs to continue to expand as time goes on.


Development
-----------

So far the package has only been developed by me, a fact that I would like
to change very much. So if you feel like contributing in any way, shape or
form, please feel free to contact me, report bugs, create pull requestes,
milestones, etc. You can contact me via email: dominik.traxl@posteo.org


Bug Reports
-----------

To search for bugs or report them, please use the bug tracker:
https://github.com/deepgraph/deepgraph/issues


Citing DeepGraph
----------------

Please acknowledge and cite the use of this software and its authors when
results are used in publications or published elsewhere. You can use the
following BibTex entry

::

   @Article{traxl-2016-deep,
       author      = {Dominik Traxl AND Niklas Boers AND J\"urgen Kurths},
       title       = {Deep Graphs - A general framework to represent and analyze
                      heterogeneous complex systems across scales},
       journal     = {Chaos},
       year        = {2016},
       volume      = {26},
       number      = {6},
       eid         = {065303},
       doi         = {http://dx.doi.org/10.1063/1.4952963},
       eprinttype  = {arxiv},
       eprintclass = {physics.data-an, cs.SI, physics.ao-ph, physics.soc-ph},
       eprint      = {http://arxiv.org/abs/1604.00971v1},
       version     = {1},
       date        = {2016-04-04},
       url         = {http://arxiv.org/abs/1604.00971v1}
   }

Licence
-------

Distributed with a `BSD license <LICENSE.txt>`_::

    Copyright (C) 2017 DeepGraph Developers
    Dominik Traxl <dominik.traxl@posteo.org>


.. |Anaconda Version| image:: https://anaconda.org/conda-forge/deepgraph/badges/version.svg
   :target: https://anaconda.org/conda-forge/deepgraph

.. |Anaconda Downloads| image:: https://anaconda.org/conda-forge/deepgraph/badges/downloads.svg
   :target: https://anaconda.org/conda-forge/deepgraph

.. |Anaconda Install| image:: https://anaconda.org/conda-forge/deepgraph/badges/installer/conda.svg
   :target: https://anaconda.org/conda-forge/deepgraph

.. |Documentation| image:: https://readthedocs.org/projects/deepgraph/badge/?version=latest
    :target: http://deepgraph.readthedocs.io/en/latest/?badge=latest

.. |PyPi| image:: https://badge.fury.io/py/DeepGraph.svg
    :target: https://badge.fury.io/py/DeepGraph

            

Raw data

            {
    "maintainer": "", 
    "docs_url": null, 
    "requires_python": "", 
    "maintainer_email": "", 
    "cheesecake_code_kwalitee_id": null, 
    "keywords": "", 
    "upload_time": "2018-03-13 16:31:43", 
    "author": "Dominik Traxl", 
    "home_page": "https://github.com/deepgraph/deepgraph/", 
    "github_user": "deepgraph", 
    "download_url": "https://pypi.python.org/packages/0b/67/6aac591469dc3b70aefd767e13ab6ed2ae93bd0c35f5fa8037a95ec57906/DeepGraph-0.2.1.tar.gz", 
    "platform": "", 
    "version": "0.2.1", 
    "cheesecake_documentation_id": null, 
    "description": "\n|Anaconda Version| |Anaconda Downloads| |Documentation| |PyPi|\n\nDeepGraph\n=========\n\nDeepGraph is a scalable, general-purpose data analysis package. It implements a\n`network representation <https://en.wikipedia.org/wiki/Network_theory>`_ based\non `pandas <http://pandas.pydata.org/>`_\n`DataFrames <http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.html>`_\nand provides methods to construct, partition and plot networks, to interface\nwith popular network packages and more.\n\nIt is based on a new network representation introduced\n`here <http://arxiv.org/abs/1604.00971>`_. DeepGraph is also capable of\nrepresenting\n`multilayer networks <http://deepgraph.readthedocs.io/en/latest/tutorials/terrorists.html>`_.\n\n\nMain Features\n-------------\n\nThis network package is targeted specifically towards\n`Pandas <http://pandas.pydata.org/>`_ users. Utilizing one of Pandas' primary\ndata structures, the\n`DataFrame <http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.html>`_,\nwe represent the (super)nodes of a graph by one set of tables, and their\npairwise relations (i.e. the (super)edges of a graph) by another set of tables.\nDeepGraph's main features are\n\n- `Create edges <https://deepgraph.readthedocs.io/en/latest/api_reference.html#creating-edges>`_:\n  Methods that enable an iterative, yet\n  vectorized computation of pairwise relations (edges) between nodes using\n  arbitrary, user-defined functions on the nodes' properties. The methods\n  provide arguments to parallelize the computation and control memory consumption,\n  making them suitable for very large data-sets and adjustable to whatever\n  hardware you have at hand (from netbooks to cluster architectures).\n\n- `Partition nodes, edges or a graph <https://deepgraph.readthedocs.io/en/latest/api_reference.html#graph-partitioning>`_:\n  Methods to partition nodes,\n  edges or a graph by the graph\u2019s properties and labels, enabling the\n  aggregation, computation and allocation of information on and between\n  arbitrary *groups* of nodes. These methods also let you express\n  elaborate queries on the information contained in a deep graph.\n\n- `Interfaces to other packages <https://deepgraph.readthedocs.io/en/latest/api_reference.html#graph-interfaces>`_:\n  Methods to convert to common\n  network representations and graph objects of popular Python network packages\n  (e.g., SciPy sparse matrices, NetworkX graphs, graph-tool graphs).\n\n- `Plotting <https://deepgraph.readthedocs.io/en/latest/api_reference.html#plotting-methods>`_:\n  A number of useful plotting methods for networks,\n  including drawings on geographical map projections.\n\n\nQuick Start\n-----------\n\nDeepGraph can be installed via pip from\n`PyPI <https://pypi.python.org/pypi/deepgraph>`_\n\n::\n\n   $ pip install deepgraph\n\nor if you're using `Conda <http://conda.pydata.org/docs/>`_,\ninstall with\n\n::\n\n   $ conda install -c conda-forge deepgraph\n\nThen, import and get started with::\n\n   >>> import deepgraph as dg\n   >>> help(dg)\n\n\nDocumentation\n-------------\n\nThe official documentation is hosted here:\nhttp://deepgraph.readthedocs.io\n\nThe documentation provides a good starting point for learning how\nto use the library. Expect the docs to continue to expand as time goes on.\n\n\nDevelopment\n-----------\n\nSo far the package has only been developed by me, a fact that I would like\nto change very much. So if you feel like contributing in any way, shape or\nform, please feel free to contact me, report bugs, create pull requestes,\nmilestones, etc. You can contact me via email: dominik.traxl@posteo.org\n\n\nBug Reports\n-----------\n\nTo search for bugs or report them, please use the bug tracker:\nhttps://github.com/deepgraph/deepgraph/issues\n\n\nCiting DeepGraph\n----------------\n\nPlease acknowledge and cite the use of this software and its authors when\nresults are used in publications or published elsewhere. You can use the\nfollowing BibTex entry\n\n::\n\n   @Article{traxl-2016-deep,\n       author      = {Dominik Traxl AND Niklas Boers AND J\\\"urgen Kurths},\n       title       = {Deep Graphs - A general framework to represent and analyze\n                      heterogeneous complex systems across scales},\n       journal     = {Chaos},\n       year        = {2016},\n       volume      = {26},\n       number      = {6},\n       eid         = {065303},\n       doi         = {http://dx.doi.org/10.1063/1.4952963},\n       eprinttype  = {arxiv},\n       eprintclass = {physics.data-an, cs.SI, physics.ao-ph, physics.soc-ph},\n       eprint      = {http://arxiv.org/abs/1604.00971v1},\n       version     = {1},\n       date        = {2016-04-04},\n       url         = {http://arxiv.org/abs/1604.00971v1}\n   }\n\nLicence\n-------\n\nDistributed with a `BSD license <LICENSE.txt>`_::\n\n    Copyright (C) 2017 DeepGraph Developers\n    Dominik Traxl <dominik.traxl@posteo.org>\n\n\n.. |Anaconda Version| image:: https://anaconda.org/conda-forge/deepgraph/badges/version.svg\n   :target: https://anaconda.org/conda-forge/deepgraph\n\n.. |Anaconda Downloads| image:: https://anaconda.org/conda-forge/deepgraph/badges/downloads.svg\n   :target: https://anaconda.org/conda-forge/deepgraph\n\n.. |Anaconda Install| image:: https://anaconda.org/conda-forge/deepgraph/badges/installer/conda.svg\n   :target: https://anaconda.org/conda-forge/deepgraph\n\n.. |Documentation| image:: https://readthedocs.org/projects/deepgraph/badge/?version=latest\n    :target: http://deepgraph.readthedocs.io/en/latest/?badge=latest\n\n.. |PyPi| image:: https://badge.fury.io/py/DeepGraph.svg\n    :target: https://badge.fury.io/py/DeepGraph\n", 
    "lcname": "deepgraph", 
    "bugtrack_url": "", 
    "github": true, 
    "coveralls": false, 
    "name": "DeepGraph", 
    "license": "BSD", 
    "travis_ci": false, 
    "github_project": "deepgraph", 
    "summary": "Analyze Data with Pandas-based Networks.", 
    "split_keywords": [], 
    "author_email": "dominik.traxl@posteo.org", 
    "urls": [
        {
            "has_sig": false, 
            "upload_time": "2018-03-13T16:31:43", 
            "comment_text": "", 
            "python_version": "source", 
            "url": "https://pypi.python.org/packages/0b/67/6aac591469dc3b70aefd767e13ab6ed2ae93bd0c35f5fa8037a95ec57906/DeepGraph-0.2.1.tar.gz", 
            "md5_digest": "7b0a43285be5a30fe5a851fabf40b78c", 
            "downloads": 0, 
            "filename": "DeepGraph-0.2.1.tar.gz", 
            "packagetype": "sdist", 
            "path": "0b/67/6aac591469dc3b70aefd767e13ab6ed2ae93bd0c35f5fa8037a95ec57906/DeepGraph-0.2.1.tar.gz", 
            "size": 151287
        }
    ], 
    "_id": null, 
    "cheesecake_installability_id": null
}