Differential D20497 Diff 48998 webroot/rsrc/externals/d3/README.md

Changeset View

Standalone View

webroot/rsrc/externals/d3/README.md

	# Data-Driven Documents			# D3: Data-Driven Documents

	<a href="http://d3js.org"><img src="http://d3js.org/logo.svg" align="left" hspace="10" vspace="6"></a>			<a href="https://d3js.org"><img src="https://d3js.org/logo.svg" align="left" hspace="10" vspace="6"></a>

	D3.js is a JavaScript library for manipulating documents based on data. D3 helps you bring data to life using HTML, SVG and CSS. D3’s emphasis on web standards gives you the full capabilities of modern browsers without tying yourself to a proprietary framework, combining powerful visualization components and a data-driven approach to DOM manipulation.			D3 (or D3.js) is a JavaScript library for visualizing data using web standards. D3 helps you bring data to life using SVG, Canvas and HTML. D3 combines powerful visualization and interaction techniques with a data-driven approach to DOM manipulation, giving you the full capabilities of modern browsers and the freedom to design the right visual interface for your data.

	Want to learn more? [See the wiki.](https://github.com/mbostock/d3/wiki)			## Resources

	For examples, [see the gallery](https://github.com/mbostock/d3/wiki/Gallery) and [mbostock’s bl.ocks](http://bl.ocks.org/mbostock).			* [API Reference](https://github.com/d3/d3/blob/master/API.md)
				* [Release Notes](https://github.com/d3/d3/releases)
				* [Gallery](https://github.com/d3/d3/wiki/Gallery)
				* [Examples](https://bl.ocks.org/mbostock)
				* [Wiki](https://github.com/d3/d3/wiki)

				## Installing

				If you use npm, `npm install d3`. Otherwise, download the [latest release](https://github.com/d3/d3/releases/latest). The released bundle supports anonymous AMD, CommonJS, and vanilla environments. You can load directly from [d3js.org](https://d3js.org), [CDNJS](https://cdnjs.com/libraries/d3), or [unpkg](https://unpkg.com/d3/). For example:

				```html
				<script src="https://d3js.org/d3.v5.js"></script>
				```

				For the minified version:

				```html
				<script src="https://d3js.org/d3.v5.min.js"></script>
				```

				You can also use the standalone D3 microlibraries. For example, [d3-selection](https://github.com/d3/d3-selection):

				```html
				<script src="https://d3js.org/d3-selection.v1.js"></script>
				```

				D3 is written using [ES2015 modules](http://www.2ality.com/2014/09/es6-modules-final.html). Create a [custom bundle using Rollup](https://bl.ocks.org/mbostock/bb09af4c39c79cffcde4), Webpack, or your preferred bundler. To import D3 into an ES2015 application, either import specific symbols from specific D3 modules:

				```js
				import {scaleLinear} from "d3-scale";
				```

				Or import everything into a namespace (here, `d3`):

				```js
				import * as d3 from "d3";
				```

				In Node:

				```js
				var d3 = require("d3");
				```

				You can also require individual modules and combine them into a `d3` object using [Object.assign](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign):

				```js
				var d3 = Object.assign({}, require("d3-format"), require("d3-geo"), require("d3-geo-projection"));
				```