Gexf library for JavaScript
JavaScript CSS HTML
Clone or download
Yomguithereal Merge pull request #43 from guoguo12/patch-1
Fix link to gexf format spec
Latest commit c3276cd May 3, 2016
Failed to load latest commit information.
build Bump 0.2.5 Mar 27, 2015
src Bump 0.2.5 Mar 27, 2015
test Fixing writer for node Nov 12, 2014
.gitignore Adding bower support Nov 14, 2014
.npmignore Fixing npmignore Nov 12, 2014
.travis.yml Starting tests Nov 12, 2014
LICENSE.txt Adding bower support Nov 14, 2014 Fix link to gexf format spec May 1, 2016
bower.json Bump 0.2.5 Mar 27, 2015
gulpfile.js Build task Nov 12, 2014
index.js Bump 0.2.5 Mar 27, 2015
package.json Bump 0.2.5 Mar 27, 2015

Build Status

GEXF JavaScript Library


This gexf library is designed to parse and write gexf files. It can be used either client-side or with node.

It was originally developed to be used with sigma and can be compiled as a sigma plugin.




The gexf can either be used to fetch and parse the .gexf file or just to parse it if you want to fetch it by your own means. The parser adds a gexf variable to your global scope so you can use it.

Fetching and parsing

// Synchronously fetch the gexf file and parse it
var graph = gexf.fetch('/url/to/file.gexf');

// Asynchronously fetch the gexf file and parse it
gexf.fetch('/url/to/file.gexf', function(graph) {

Parsing only

If you want to fetch the gexf yourself, you can still parse the graph by providing a javascript DOM object to the parser (an ajax XML response or a parsed string, for instance).

// Converting a string to a DOM object
var gexf_dom = new DOMParser().parseFromString(gexf_string, "application/xml");

// Parsing the gexf
var graph = gexf.parse(gexf_dom);


For more precisions, refer to the writer section of the current documentation.

var myGexf = gexf.create([params]);



# For the latest released version
npm install gexf

# For the development version
npm install git+


var fs = require('fs'),
    gexf = require('gexf');

// Reading your gexf file
var gexf_file = fs.readFileSync('/path/to/your.gexf', 'utf-8');

// Parsing it
var graph = gexf.parse(gexf_file);


For more precisions, refer to the writer section of the current documentation.

var gexf = require('gexf');

var myGexf = gexf.create([params]);


If you want to build the minified client version, clone this repo and launch the build task.

git clone
cd gexf
npm install
gulp build

Output Data

The following example shows what the parser is able to output given a gexf file.

  version: "1.0.1",
  meta: {
    creator: "Yomguithereal",
    lastmodifieddate: "2010-05-29+01:27",
    title: "A random graph"
  defaultEdgeType: "directed",
  model: {
    node: [
        id: "authority",
        type: "float",
        title: "Authority"
        id: "name",
        type: "string",
        title: "Author's name"
  nodes: [
      id: "0",
      label: "Myriel",
      attributes: {
        authority: 10.43,
        name: "Myriel Dafault"
      viz: {
        color: "rgb(216,72,45)",
        size: 22.4,
        position: {
          x: 234,
          y: 23,
          z: 0
      id: "1",
      label: "Jean",
      attributes: {
        authority: 2.43,
        name: "Jean Daguerre"
      viz: {
        color: "rgb(255,72,45)",
        size: 21.4,
        position: {
          x: 34,
          y: 23,
          z: 0
  edges: [
      id: "0",
      source: "0",
      target: "1",
      type: "directed",
      weight: 1,
      viz: {
        shape: "dotted"


Note that the data format expected by the writer is exactly the same as the one outputted by the parser.

This means that theoritically - i.e. "if I did my job correctly" - you can give the result graph from parsing a gexf file and give it to the writer to create an identical file.


To create a writer instance, just do the following:

var myGexf = gexf.create([params]);


Possible parameters are:

  • meta ?object: an object of metadata for the graph.
  • defaultEdgeType ?string ['undirected']: default edge type.
  • encoding ?string ['UTF-8']: encoding of the XML file.
  • mode ?string: mode of the graph. static or dynamic for instance.
  • model ?object: an object containing the models of the nodes and/or edges.
    • node ?array: array of node possible attributes. see output data for precisions.
    • edge ?array: array of edge possible attributes. see output data for precisions.
  • nodes ?array: array of nodes to pass at instantiation time.
  • edges ?array: array of edges to pass at instantiation time.
  • implementation ?DOMImplementation: the DOM implementation to build the XML document. Will take the browser's one by default of xmldom's one in node.
  • serializer ?XMLSerializer: the XMLSerializer class to serialize the XML document. Will default to the browser's one or xmldom's one in node.
  • namespace ?string ['']: gexf XML namespace to use.
  • vizNamespace ?string ['http:///']: gexf viz XML namespace to use.
  • version ?string ['1.2']: version of gexf to produce.



Adding a single node to the gexf document.

  id: 'n01',
  label: 'myFirstNode',
  attributes: {
    name: 'John',
    surname: 'Silver'
  viz: {
    color: 'rgb(255, 234, 45)'


Adding a single edge to the gexf document.

  id: 'e01',
  source: 'n01',
  target: 'n02',
  attributes: {
    predicate: 'LIKES'
  viz: {
    thickness: 34


Same as passing a meta parameter at instantiation.


Same as passing a models.node parameter at instantiation.


Same as passing a models.edge parameter at instantiation.


Add a single node attribute definition to the node model.


Add a single edge attribute definition to the edge model.


Produce the string representation of the gexf document.

Retrieving the gexf

// As a document
var doc = myGexf.document;

// As a string
var string = myGexf.serialize();


Please feel free to contribute. To set up the dev environment you should have nodejs, npm and gulp installed.

git clone
cd gexf
npm install

Be sure to add relevant unit tests and pass the linter before submitting any change to the library.

npm test