1 | <img style="width: 200px; height: 200px;" src="https://raw.githubusercontent.com/cytoscape/cytoscape.js/unstable/documentation/img/cytoscape-logo.png" width="200" height="200"></img>
|
2 |
|
3 | [![GitHub repo](https://img.shields.io/badge/Repo-GitHub-yellow.svg)](https://github.com/cytoscape/cytoscape.js)
|
4 | [![Twitter updates](https://img.shields.io/badge/Updates-Twitter-yellow.svg)](https://twitter.com/cytoscapejs)
|
5 | [![News and tutorials](https://img.shields.io/badge/News%20and%20tutorials-Blog-yellow.svg)](https://blog.js.cytoscape.org)
|
6 | [![Questions at StackOverflow](https://img.shields.io/badge/Questions-StackOverflow-yellow.svg)](https://stackoverflow.com/questions/tagged/cytoscape.js)
|
7 | [![Ask a question at StackOverflow](https://img.shields.io/badge/Ask%20a%20question-StackOverflow-yellow.svg)](https://stackoverflow.com/questions/ask?tags=cytoscape.js,javascript)
|
8 | [![GitHub license](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/cytoscape/cytoscape.js/master/LICENSE)
|
9 | [![DOI](https://zenodo.org/badge/2255947.svg)](https://zenodo.org/badge/latestdoi/2255947)
|
10 | [![Cite](https://img.shields.io/badge/Cite-Oxford%20Bioinformatics%20Article-blue.svg)](https://js.cytoscape.org/#introduction/citation)
|
11 | [![npm](https://img.shields.io/npm/v/cytoscape.svg)](https://www.npmjs.com/package/cytoscape)
|
12 | [![Download](https://img.shields.io/npm/v/cytoscape.svg?label=Download)](https://github.com/cytoscape/cytoscape.js/tree/master/dist)
|
13 | [![Extensions](https://img.shields.io/badge/Extensions-52-blue.svg)](https://js.cytoscape.org/#extensions)
|
14 | [![npm installs](https://img.shields.io/npm/dm/cytoscape.svg?label=npm%20installs)](https://www.npmjs.com/package/cytoscape)
|
15 | [![master branch tests](https://img.shields.io/travis/cytoscape/cytoscape.js/master.svg?label=master%20branch)](https://travis-ci.org/cytoscape/cytoscape.js)
|
16 | [![unstable branch tests](https://img.shields.io/travis/cytoscape/cytoscape.js/unstable.svg?label=unstable%20branch)](https://travis-ci.org/cytoscape/cytoscape.js)
|
17 | [![Greenkeeper badge](https://badges.greenkeeper.io/cytoscape/cytoscape.js.svg)](https://greenkeeper.io/)
|
18 |
|
19 | # Cytoscape.js
|
20 |
|
21 | Graph theory (network) library for visualisation and analysis : [https://js.cytoscape.org](https://js.cytoscape.org)
|
22 |
|
23 | ## Description
|
24 |
|
25 | Cytoscape.js is a fully featured [graph theory](https://en.wikipedia.org/wiki/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.
|
26 |
|
27 | 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.
|
28 |
|
29 | You can get started with Cytoscape.js with one line:
|
30 |
|
31 | ```js
|
32 | var cy = cytoscape({ elements: myElements, container: myDiv });
|
33 | ```
|
34 |
|
35 | Learn more about the features of Cytoscape.js by reading [its documentation](https://js.cytoscape.org).
|
36 |
|
37 |
|
38 |
|
39 |
|
40 |
|
41 | ## Documentation
|
42 |
|
43 | You can find the documentation and downloads on the [project website](https://js.cytoscape.org).
|
44 |
|
45 |
|
46 |
|
47 | ## Roadmap
|
48 |
|
49 | Future versions of Cytoscape.js are planned in the [milestones of the Github issue tracker](https://github.com/cytoscape/cytoscape.js/milestones). You can use the milestones to see what's currently planned for future releases.
|
50 |
|
51 |
|
52 |
|
53 |
|
54 | ## Contributing to Cytoscape.js
|
55 |
|
56 | Please refer to [CONTRIBUTING.md](.github/CONTRIBUTING.md).
|
57 |
|
58 | Feature releases are made at the start of each month, while patch releases are made at the start of each week. This allows for rapid releases of first- and third-party contributions.
|
59 |
|
60 |
|
61 |
|
62 | ## Citation
|
63 |
|
64 | To cite Cytoscape.js in a paper, please cite the Oxford Bioinformatics issue:
|
65 |
|
66 | *Cytoscape.js: a graph theory library for visualisation and analysis*
|
67 |
|
68 | Franz M, Lopes CT, Huck G, Dong Y, Sumer O, Bader GD
|
69 |
|
70 | [Bioinformatics (2016) 32 (2): 309-311 first published online September 28, 2015 doi:10.1093/bioinformatics/btv557 (PDF)](https://bioinformatics.oxfordjournals.org/content/32/2/309)
|
71 |
|
72 | [PubMed Abstract](https://www.ncbi.nlm.nih.gov/pubmed/26415722)
|
73 |
|
74 |
|
75 |
|
76 |
|
77 | ## Build dependencies
|
78 |
|
79 | Install `node` and `npm`. Run `npm install` before using `npm run`.
|
80 |
|
81 |
|
82 |
|
83 |
|
84 | ## Build instructions
|
85 |
|
86 | Run `npm run <target>` in the console. The main targets are:
|
87 |
|
88 | **Building:**
|
89 |
|
90 | * `build`: do all builds of the library (unmin, min, umd)
|
91 | * `build:unmin` : do the unminified build with bundled dependencies (for simple html pages, good for novices)
|
92 | * `build:min` : do the unminified build with bundled dependencies (for simple html pages, good for novices)
|
93 | * `build:umd` : do the umd (cjs/amd/globals) build
|
94 | * `clean` : clean the `build` directory
|
95 | * `docs` : build the docs into `documentation`
|
96 | * `release` : build all release artifacts
|
97 | * `watch` : automatically build lib for debugging (with sourcemap, no babel, very quick)
|
98 | * good for general testing on `debug/index.html`
|
99 | * served on `http://localhost:8080` or the first available port thereafter, with livereload on `debug/index.html`
|
100 | * `watch:babel` : automatically build lib for debugging (with sourcemap, with babel, a bit slower)
|
101 | * good for testing performance or for testing out of date browsers
|
102 | * served on `http://localhost:8080` or the first available port thereafter, with livereload on `debug/index.html`
|
103 | * `watch:umd` : automatically build prod umd bundle (no sourcemap, with babel)
|
104 | * good for testing cytoscape in another project (with a `"cytoscape": "file:./path/to/cytoscape"` reference in your project's `package.json`)
|
105 | * no http server
|
106 | * `dist` : update the distribution js for npm etc.
|
107 |
|
108 | **Testing:**
|
109 |
|
110 | If the `TRAVIS` or `TEST_BUILD` environment variables are defined, then `mocha` or `npm 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`.
|
111 |
|
112 | * `test` : run the Mocha unit tests
|
113 | * `test:build` : run the Mocha unit tests (on a built bundle)
|
114 | * `lint` : lint the js sources via eslint
|
115 | * `ci` : run tests and linting
|
116 | * `ci:build` : run tests and linting (on a built bundle)
|
117 | * `benchmark` : run all benchmarks
|
118 | * `benchmark:single` : run benchmarks only for the suite specified in `benchmark/single`
|
119 | * `sniper` : runs a biojs sniper server that hosts demos
|
120 |
|
121 |
|
122 |
|
123 | ## Release instructions
|
124 |
|
125 | 1. Do each backport patch release before the corresponding current release. This ensures that npm lists the current version as the latest one.
|
126 | 1. Make sure the docs are updated with the list of releases in `documentation/md/intro.md`
|
127 | 1. Update the `VERSION` environment variable, e.g. `export VERSION=1.2.3`
|
128 | 1. Confirm all the tests are passing: `npm run test` (see also `test/index.html` for browser testing)
|
129 | 1. Confirm all the tests are passing in IE9:
|
130 | 1. `npm run watch:umd`
|
131 | 1. Open an [IE9 VM](https://developer.microsoft.com/en-us/microsoft-edge/tools/vms/)
|
132 | 1. Open `http://yourip:8081/test/ie.html` in IE
|
133 | 1. Prepare a release: `npm run release`
|
134 | 1. Review the files that were just built in the previous step. Try out the newly-built docs and demos.
|
135 | 1. Add the the release to git: `git add . && git commit -m "Build $VERSION"`
|
136 | 1. Update the package version: `npm version $VERSION`
|
137 | 1. Push the release changes: `git push && git push --tags`
|
138 | 1. Publish the release to npm: `npm publish .`
|
139 | 1. [Create a release](https://github.com/cytoscape/cytoscape.js/releases/new) for Zenodo from the latest tag
|
140 | 1. For feature releases: Create a release announcement on the [blog](https://github.com/cytoscape/cytoscape.js-blog). Share the announcement on mailing lists and social media.
|
141 |
|
142 |
|
143 |
|
144 | ## Tests
|
145 |
|
146 | Mocha tests are found in the [test directory](https://github.com/cytoscape/cytoscape.js/tree/master/test). The tests can be run in the browser or they can be run via Node.js (`npm test` or `mocha`).
|