Skip to main content

Simple and flexible graph database analysis

Project description


Grandas as a library that allows simplified, flexible analysis of the nodes and relationships stored in a graph database. It allows a user to search for and filter information and connections contained in a subgraph of a graph database.

Data Structures


A Node object is the basic entity object and identifies any noun in your graph dataset.


A Relationship stores the way that any two nodes in your dataset are related. Bi-directional relationships here are stored as two independent relationships.


Nodeframes allow users to see the nodes in their graph databases, and further enable them to filter and resolve redundant nodes.


The RelationshipFrame object stores a series of Relationship objects as a pandas DataFrame, using the hashed value of the full node to identify where the start and ending points for each relationship are.


A GraphFrame is comprised of a NodeFrame (attribute: nodes) and a RelationshipFrame (attribute: rels).

Getting Started

To get started using grandas, you can install it using pip:

pip install grandas

From there, load in nodes and relationships to a GraphFrame object, similar to how you would use a pandas DataFrame.

import grandas as gd

nodes = [
alice, bob = nodes
rels = [
  Relationship(start=alice, end=bob, label='owes_money_to',amount=10)
gf = GraphFrame(nodes=nodes, relationships=rels)

node_frame = gf.nodes
relationship_frame =  gf.rels


Contributions are more than welcome! Please just submit a pull request to the develop branch.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

grandas-0.0.1.tar.gz (4.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page