/dc.js

Multi-Dimensional charting built to work natively with crossfilter rendered with d3.js

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Dependency Status Build Status Sauce Status NPM Status Join the chat at https://gitter.im/dc-js/dc.js

dc.js

Dimensional charting built to work natively with crossfilter rendered using d3.js. In dc.js, each chart displays an aggregation of some attributes through the position, size, and color of its elements, and also presents a dimension which can be filtered. When the filter or brush changes, all other charts are updated dynamically, using animated transitions.

Check out the example page and its annotated source for a quick five minute how-to guide. The detailed API reference is here (markdown version). For more examples and hints please visit the Wiki.

Support

Please direct questions and support requests to Stack Overflow or the user group. When posting to Stack Overflow, use the [dc.js] and/or [crossfilter] tags - other tags are likely to draw unwanted attention.

Get help faster with a working example! Fork these to get started:
example jsFiddle - blank jsFiddle - example bl.ock - blank bl.ock

CDN location

For CDN URLs, please visit dc.js on cdnjs.com, select the version you want (2.0 is stable, 2.1 has breaking changes), and copy the URLs from there.

Please do not use github.io as a CDN unless you need the bleeding-edge features.

More info on the Wiki.

Install with npm

npm install dc

Install with bower

bower install dcjs

Install without npm

Download

How to build dc.js locally

Prerequisite modules

Make sure the following packages are installed on your machine

  • node.js
  • npm

Install dependencies

dc.js$ npm install

Build and Test

dc.js$ grunt test

Developing dc.js

Start the development server

dc.js$ grunt server

License

dc.js is an open source javascript library and licensed under Apache License v2.