dc.js

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

ChartingD3
dc-js/dc.jsdc

README

Build Status Sauce Status NPM Status cdnjs 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
Example Site
Changelog
Frequently Asked Questions and Wiki
* [v4.0 API Reference](http://dc-js.github.io/dc.js/docs/html/) ([markdown](https://github.com/dc-js/dc.js/blob/master/docs/api-latest.md)) ([last - v3.1.9](https://github.com/dc-js/dc.js/blob/master/docs/old-api-docs/api-3.1.9.md))
dc.js on StackOverflow - ask questions and get help
User Group ("mailing list") - discussion and longer topics
GitHub Issues - bug reports and feature requests

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:
blank jsFiddle - example jsFiddle - blank bl.ock - example bl.ock

Versioning

Version 4. is compatible with d3 versions 4 and 5. It is not compatible with IE. Use dc.js 3. if you need IE support, or use dc.js 2.* if you need compatibility with d3 version 3.

CDN location


  1. ```
  2. https://unpkg.com/dc@4/dist/dc.js
  3. https://unpkg.com/dc@4/dist/style/dc.css
  4. ```

or copy the latest links from CDNJS


Install with npm
  1. ```
  2. npm install dc
  3. ```


Install without npm
Download
d3.js
crossfilter.js
dc.js - stable
dc.js - bleeding edge (develop)


How to build dc.js locally

Prerequisite modules


Make sure the following packages are installed on your machine
node.js
npm

Install dependencies

  1. ```
  2. $ npm install
  3. ```

Build and Test

  1. ```
  2. $ grunt test
  3. ```

Developing dc.js

Start the development server

  1. ```
  2. $ grunt server
  3. ```

Jasmine specs are hosted at http://localhost:8888/spec
The stock example is at http://localhost:8888/web
More examples are at http://localhost:8888/web/examples

License

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