Home

D3.js is a small, free JavaScript library for manipulating HTML documents based on data. D3 can help you quickly visualize your data as HTML or SVG, handle interactivity, and incorporate smooth transitions and staged animations into your pages. You can use D3 as a visualization framework, or you can use it to build dynamic pages (like jQuery).

Resources

• Introduction
• API Reference
• Release Notes
• Tutorials and Talks
• Examples Gallery
• d3.js on Stack Overflow
• d3-js Google Group

Browser Support

D3 supports so-called “modern” browsers, which generally means everything except IE8 and below. D3 is tested against Firefox, Chrome (Chromium), Safari (WebKit), Opera and IE9. Parts of D3 may work in older browsers, as the core D3 library has minimal requirements: JavaScript and the W3C DOM API. D3 uses the Selectors API Level 1, but you can preload Sizzle for compatibility. You'll need a modern browser to use SVG and CSS3 Transitions. D3 is not a compatibility layer, so if your browser doesn't support standards, you're out of luck. Sorry!

Installing

If you just want the latest release of D3 as a JavaScript file, you can download them here:

• http://mbostock.github.com/d3/d3.v2.js - development
• http://mbostock.github.com/d3/d3.v2.min.js - production

To get the lastest release and all the examples, you can find a tarball here:

• https://github.com/mbostock/d3/tags

Or, from the command line:

git clone git://github.com/mbostock/d3.git

When running the examples locally, note that your browser may enforce strict permissions for reading files out of the local file system. Some examples use AJAX which works differently via HTTP instead of local files. To view the examples locally, you must have a local web server. Any web server will work; for example you can run Python's built-in server:

python -m SimpleHTTPServer 8888 &

Once this is running, go to http://localhost:8888/examples/.

The D3 repository should work out of the box if you just want to create new visualizations using D3. On the other hand, if you want to extend D3 with new features, fix bugs, or run tests, you should fork the D3 repository, and install a few more things. D3's test framework uses Vows, which depends on Node.js and NPM. If you are developing on Mac OS X, an easy way to install Node and NPM is using Homebrew:

brew install node
brew install npm

Next, from the root directory of this repository, install D3's dependencies:

npm install

To run the tests, use:

make test