Skip to content
Graph theory (network) library for visualisation and analysis
Branch: unstable
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
benchmark
debug When a bundled bezier edge is moved or removed, its parallel edges in… Mar 4, 2019
dist Build 3.5.0 Mar 6, 2019
documentation Add 3.4.3 to the list of releases in the docs Mar 6, 2019
snippets Initial improvements to the docs for v3.3.0 Oct 29, 2018
src Bounding box of parent fails if child is hidden #2339 Mar 22, 2019
test Bounding box of parent fails if child is hidden #2339 Mar 22, 2019
.babelrc Fix rollup build & mocha tests with updated packages by greenkeeper Oct 30, 2018
.eslintrc.json
.gitignore
.npmignore
.size-snapshot.json
.travis.yml
CONTRIBUTING.md Merge pull request #2214 from balupton/patch-1 Nov 6, 2018
ISSUE_TEMPLATE.md Update jsbin link in issue template Feb 8, 2019
LICENSE
README.md Update the extension count to 42 #2323 Mar 5, 2019
bower.json
package-lock.json
package.json Update package files to 3.6.0-unstable Mar 6, 2019
rollup.config.js Replace uglify with terser for minified builds Jan 15, 2019

README.md

GitHub repo Twitter updates News and tutorials Questions at StackOverflow Ask a question at StackOverflow GitHub license DOI npm Download Extensions npm installs master branch tests unstable branch tests Greenkeeper badge

Cytoscape.js

Graph theory (network) library for visualisation and analysis : 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

Bioinformatics (2016) 32 (2): 309-311 first published online September 28, 2015 doi:10.1093/bioinformatics/btv557 (PDF)

PubMed Abstract

Build dependencies

Install node, npm and gulp (optional). Of course, npm install before using gulp or npm run.

Build instructions

Run npm run <target> in the console. The main targets are:

Building:

  • build: do all builds of the library (unmin, min, umd)
  • build:unmin : do the unminified build with bundled dependencies (for simple html pages, good for novices)
  • build:min : do the unminified build with bundled dependencies (for simple html pages, good for novices)
  • build:umd : do the umd (cjs/amd/globals) build
  • clean : clean the build directory
  • docs : build the docs into documentation
  • release : build all release artefacts
  • watch : automatically build lib for debugging (with sourcemap, no babel, very quick)
    • good for general testing on debug/index.html
    • served on http://localhost:8080 or the first available port thereafter, with livereload on debug/index.html
  • watch:babel : automatically build lib for debugging (with sourcemap, with babel, a bit slower)
    • good for testing performance or for testing out of date browsers
    • served on http://localhost:8080 or the first available port thereafter, with livereload on debug/index.html
  • watch:umd : automatically build prod umd bundle (no sourcemap, with babel)
    • good for testing cytoscape in another project (with a "cytoscape": "file:./path/to/cytoscape" reference in your project's package.json)
    • no http server
  • dist : update the distribution js for npm etc.

Testing:

If the TRAVIS or TEST_BUILD environment variables are defined, then mocha or gulp test will test build/cytoscape.umd.js. Otherwise, the unbundled, unbabelified, raw source is tested. This keeps local tests very quick to run on modern versions of node while ensuring we can test old versions of node as well. The library can be built on node>=6, but it can be tested on node>=0.10.

  • test : run the Mocha unit tests
  • test:build : run the Mocha unit tests (on a built bundle)
  • lint : lint the js sources via eslint
  • ci : run tests and linting
  • ci:build : run tests and linting (on a built bundle)
  • benchmark : run all benchmarks
  • benchmark:single : run benchmarks only for the suite specified in benchmark/single
  • sniper : runs a biojs sniper server that hosts demos

Release instructions

  1. Do each backport patch release before the corresponding current release. This ensures that npm lists the current version as the latest one.
  2. Make sure the docs are updated with the list of releases in documentation/md/intro.md
  3. Update the VERSION environment variable, e.g. export VERSION=1.2.3
  4. Confirm all the tests are passing: npm run test (see also test/index.html for browser testing)
  5. Prepare a release: npm run release
  6. Review the files that were just built in the previous step. Try out the newly-built docs and demos.
  7. Add the the release to git: git add . && git commit -m "Build $VERSION"
  8. Update the package version: npm version $VERSION
  9. Push the release changes: git push && git push --tags
  10. Publish the release to npm: npm publish .
  11. Create a release for Zenodo from the latest tag

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 (npm test or mocha).

You can’t perform that action at this time.