Cytoscape.js
Graph theory (a.k.a. network) library for analysis and visualisation : http://js.cytoscape.org
Description
Cytoscape.js is a fully featured graph theory library. Do you need to model and/or visualise relational data, like biological data or social networks? If so, Cytoscape.js is just what you need.
Cytoscape.js contains a graph theory model and an optional renderer to display interactive graphs. This library was designed to make it as easy as possible for programmers and scientists to use graph theory in their apps, whether it's for server-side analysis in a Node.js app or for a rich user interface.
You can get started with Cytoscape.js with one line:
var cy = cytoscape({ elements: myElements, container: myDiv });
Learn more about the features of Cytoscape.js by reading its documentation.
Documentation
You can find the documentation and downloads on the project website.
Roadmap
Future versions of Cytoscape.js are planned in the milestones of the Github issue tracker. You can use the milestones to see what's currently planned for future releases.
Contributing to Cytoscape.js
Please refer to CONTRIBUTING.md.
Citation
To cite Cytoscape.js in a paper, please cite the Oxford Bioinformatics issue:
Cytoscape.js: a graph theory library for visualisation and analysis
Franz M, Lopes CT, Huck G, Dong Y, Sumer O, Bader GD
Build dependencies
Install node
, npm
and gulp
. Of course, npm install
before using gulp
.
Build instructions
Run gulp <target>
in the console. The main targets are:
Building:
build
(default) : build the libraryclean
: clean thebuild
directorywatch
: automatically build lib and tests for debuggingzip
: build the release ZIPdist
: update the distribution JS for npm, bower, etc.
Testing:
test
: run the Mocha unit testslint
: lint the JS sources via eslintbenchmark
: run benchmark regression testsbenchmark-single
: run benchmarks only for the suite specified inbenchmark/single
sniper
: runs a BioJS sniper server that hosts demos
Documentation:
docs
: build the documentation templatedocsmin
: build the documentation template with all resources minifieddocspub
: build the documentation for publishing (ZIPs, JS refs, etc.)docspush
: push the built documentation to js.cytoscape.orgunstabledocspush
: push the built documentation to js.cytoscape.org/unstable
Release instructions
- Do each backport patch release before the corresponding current release. This ensures that npm lists the current version as the latest one.
- Make sure the docs are updated with the list of releases in
documentation/md/intro.md
- Update the
VERSION
environment variable, e.g.export VERSION=1.2.3
- Confirm JS files pass linting:
gulp lint
- Confirm all tests passing:
gulp test
- Test the docs and demos with the latest code:
gulp docspub
- Build and publish the release:
gulp publish
Tests
Mocha tests are found in the test directory. The tests can be run in the browser or they can be run via Node.js (gulp test
or mocha
).