https://github.com/pcbje/ggraph

Graph visualization of big messy data
https://github.com/pcbje/ggraph

graph-visualization messy-data

Last synced: about 2 months ago
JSON representation

Graph visualization of big messy data

• Host: GitHub
• URL: https://github.com/pcbje/ggraph
• Owner: pcbje
• License: apache-2.0
• Created: 2016-12-30T11:08:59.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-01-30T18:19:50.000Z (over 7 years ago)
• Last Synced: 2024-04-16T23:10:32.005Z (5 months ago)
• Topics: graph-visualization, messy-data
• Language: JavaScript
• Homepage: https://gransk.com/ggraph.html
• Size: 42 KB
• Stars: 800
• Watchers: 23
• Forks: 62
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - pcbje/ggraph - Graph visualization of big messy data (others)

README

        
# ggraph - Graph visualization for messy data

[![Build Status](https://travis-ci.org/pcbje/ggraph.svg?branch=master)](https://travis-ci.org/pcbje/ggraph)

 [![Coverage Status](https://coveralls.io/repos/github/pcbje/ggraph/badge.svg?branch=master)](https://coveralls.io/github/pcbje/ggraph?branch=master)

![](https://gransk.com/ggraph/ggraph.gif)

This is a library built on top D3 with the goal of improving how we work with large and messy graphs. It extends the notion of nodes and links with groups of nodes. This is useful when multiple nodes are in fact the same thing or belong to the same group.

Live demo: https://gransk.com/ggraph.html

Some examples of nodes that may belong together:

- IPs in the same subnet

- Emails / monikers

- File fingerprints

- Bitcoin addresses in same wallet

- Alternative spellings and typos

## Data model

The easiest apporach is to call ```ggraph.convert``` with a valid D3 object:

```javascript

var graph = {

  nodes:[

    {id: "Maria West", type: "female"},

    {id: "Hazel Santiago", type: "male"},

    {id: "Sheldon Roy", type: "male"}    

  ],

  links: [

    {source: "Maria West", target: "Hazel Santiago", value:100},

    {source: "Maria West", target: "Sheldon Roy"}    

  ]

}

converted = ggraph.convert(graph);

```

## Usage

Initialization:

```javascript

ggraph.init('container', 25); // Marker timeout

ggraph.draw(converted);

```

Merge nodes into groups:

```javascript

// Merge selected

ggraph.merge(selection.all());

// Into single group

ggraph.merge(['Maria West', 'Sheldon Roy']);

// Into several groups

ggraph.merge([

  ['A', 'B'],

  ['C', 'D']

]);

```

Split and remove:

```javascript

ggraph.split(['Maria West', 'Sheldon Roy']);

ggraph.remove(['Maria West', 'Hazel Santiago']);

```

## Building

```bash

git clone https://github.com/pcbje/ggraph && cd ggraph

npm install

node_modules/.bin/karma start tests/cover.conf.js

node_modules/.bin/karma start tests/watch.conf.js

node_modules/.bin/grunt min

```

## Disclaimer

This is a work in progress. Contributions are very much welcome!