novus/nvd3 is a JavaScript project with 7.2k stars. A reusable charting library written in d3.js
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
NVD3 is recommended to go with d3.js version 3.5.3 and later, but NOT d3 4.x yet. version 3.5.17 is the most recent d3 v3 release.
Minimum D3 version required: 3.4.4
For a D3v4 Version, see the work in progress at the nvd3 organization
Along with pieChart options padAngle and cornerRadius, the interactive guideline tooltip now requires these later versions of D3 (3.4.4+, specifically, to get interactive tooltips). The interactive guide lines rely on the more recent d3.bisector() method which treats accessors taking two parameters (the second being the element index) as comparators (see d3.bisector()).
Supported Browsers
NVD3 runs best on WebKit based browsers.
Google Chrome: latest version
Opera 15+ (i.e. webkit version)
Safari: latest version
Firefox: latest version
Internet Explorer: 10+
Do we support D3 v4.x?
No, we do not... we are very interested in taking this on but could use some help. Please let us know if you'd like to help make this a reality! :)
Changelog
1.8.6 Changes:
Community bugfixes
1.8.5 Changes:
Community bugfixes
New force-directed graph
1.8.4 Changes:
Community bugfixes including tooltip fixes.
1.8.3 Changes:
Lots of community bugfixes
Added force-directed chart
1.8.2 Changes:
Lots of community bugfixes and a few extra minor features
1.8.1 Changes:
Tooltips were refactored - If you have customized your tooltips, note that you may need to adjust your custom functions as the data passed has changed format. See the new tooltip options for more details.
Added boxplot charts | example
Added candlestick charts | example
Added extra donut chart abilities | examples
Added sunburst Charts | example
Time Series | example
Another legend format available | example
Lots of bug fixes (see closed issues)
(for all examples, see here)
1.7.1 Changes:
Fixed axis.staggerLabels bug.
Fixed Karma unit tests.
Fixed chart test pages.
Merged in nvd3-community changes and development branch.
1.7.0 Changes:
Fixes around 20 small bugs.
Fixed the notorious slowness of line charts and scatter plots on chrome
Combined the scatterChart and scatterChartWithLines models
Combined the linePlusBarChart and linePlusBarChartWithFocus models.
renamed some of the options (see the new documentation for what options are available for each chart)
Completed the migration of the option functions to an object format which allows the generation of
the documentation in an automated way. Not everything has a description yet, but check it out!
Added extra options to the donut charts based on features that will be in d3 3.5. The donut example page
loads the latest d3 from their 3.5 branch so keep that in mind.
Added an example of the parallelCoordinates chart.
Fixed up the half-done OHLC bar chart, and made an example for it as well.
1.6.0 Changes:
includes about a dozen bug fixes and pull requests I fixed and merged in
from the issues/pulls from the original project.
It also standardized all indention
Current development focus
Review outstanding pull requests and issues.
Try to find an easy way to actually document usage and all chart options.
Improve the testing framework.
Setup continuous integration.
Bugs
Found a bug? Check out the latest from the master branch and make sure it's not already fixed first! If you don't see a related fix, please open an issue.
Optional dependencies
Including Fastdom in your project can greatly increase the performance of the line chart (particularly in Firefox and Internet Explorer) by batching DOM read and write operations to avoid layout thrashing. NVD3 will take advantage of Fastdom if present.
Contributing
If one of the existing models
doesn't meet your needs, fork the project, implement the model and an example using it,
send us a pull request, for consideration for inclusion in the project.
If you'd like to contribute consistently, show me what you've got with some good pull requests and you may get added to the nvd3-community org!
A few rules for pull requests
Please commit to the master branch
Do NOT check in anything under the build directory, it clutters up the commit and just gets overwritten later.
All new features must come with unit test coverage
Bug fixes should come with unit tests that prove their fix
If you want to test your changes using the example pages,
you'll have to run grunt production to build the items into the build directory.
You must do this before your changes show up in the examples, as they link to the build directory
in order to properly show off the finished product.
Please remember to NOT include the build files in your commit though,
only include the source files you changed!
Tips for Testing
Unit tests were written in Karma and Mocha. Follow instructions in Building Latest to get npm packages setup. This may not work on Windows machines.
Run bower install to get bower dependencies.
Run grunt to start the unit tests.
Also visually inspect the HTML pages in the examples/ and test/ folders. Make sure there are no glaring errors.
Novus now uses Travis CI for continuous integration. Visit our travis build page to see the latest status.
Meteor Tinytests
Any Meteor-specific features can be tested from the command line using tinytest and Spacejam
spacejam can be installed by running npm install -g spacejam.
Tinytests can then be executed by running spacejam test-packages ./ from this project's root.
Building latest
First clone the repository and checkout the master branch
make sure nodejs is installed via your system's package manager.
TopGit's last sync did not record any GitHub topics for novus/nvd3. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on novus/nvd3?
The most recent commit recorded on novus/nvd3 was 3.2 years ago, based on the GitHub push timestamp. The repository has 2.1k forks — one of the better signals of community interest.
How many stars does novus/nvd3 have?
novus/nvd3 has 7.2k GitHub stars — refresh the page for the live number, or check github.com/novus/nvd3. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is novus/nvd3 written in?
novus/nvd3 is written primarily in JavaScript. GitHub's language field is based on the largest share of bytes in the default branch.
Where do I read more about novus/nvd3?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/novus/nvd3 is the definitive source.
Read full README in the tab above.
Want a second opinion on nvd3?
Ask an AI that can read this page — one click and you get its take on nvd3.