d3

• Fix d3.transition(name).
• Include d3.variance and d3.deviation in the default build.

• Fix selection.interrupt to prevent erroneous cancelation of scheduled transitions.
• Fix transition event listeners to see the latest data.
• d3.transition now takes an optional name argument.
• Dispatch interrupt events immediately within the call to selection.interrupt.
• Dispatch interrupt events prior to start events on the interrupting transition.
• Do not dispatch erroneous interrupt events on cancelled transitions.
• Do not allow exceptions within a transition.each callback to prevent future transitions.

• Add named transitions (e.g., 1 2) for concurrent animations on the same element.
• Add “interrupt” events for handling interrupted transitions.
• Add d3.layout.pie padAngle (e.g., 1 2 3), which preserves approximate relative area of arcs.
• Add d3.svg.arc cornerRadius (e.g., 1 2 3 4) for arcs with rounded corners.
• Add double-click and double-tap smooth transitions to d3.behavior.zoom.
• Add d3.behavior.zoom duration for customizing or disabling double-click transitions.
• Add d3.map(array, accessor) for constructing a map by key from an array.
• Add d3.scale.ordinal rangeRoundPoints, a rounded version of rangePoints.
• Add d3.geom.quadtree find for efficient 2D search.
• Add d3.variance and d3.deviation.
• Add locales for Poland and Canada.
• Add d3.shuffle(array, lo, hi) for shuffling a subset of an array.
• d3.svg.arc now generates a counterclockwise arc when startAngle is greater than endAngle.
• Allow a transition’s ease or duration to be changed before the transition starts.
• Fix spurious stroke when rendering Point features on canvas with d3.geo.path.
• Fix memory leak with chained transitions.
• Fix reported "zoomstart" and "zoomend" events for re-entrant zoom gestures.

• Fix invalid transform when switching between linear and log axes.
• Fix number formatting of groups with very small or very large numbers in exponent notation.
• Fix number formatting with explicit minus (“-”) sign.
• Fix loss of precision during linear interpolation.
• Fix crash in d3.layout.stack when passed an empty array.
• Fix for falsey rows when parsing DSV.
• Fix for leaked d3 global in Node.
• Fix conversion from HCL to Lab color.
• Fix for d3.mean, d3.median and d3.scale.quantile to coerce values to numbers.
• Improve performance of d3.map and d3.set by using Object.create(null).
• Improve performance of selection.data.

• Fix uncaught InvalidStateError thrown when using d3.xhr with non-text response types.
• Fix parsing of positive time zone offsets with a non-zero number of minutes.
• Update to JSDOM version 1.0.0.
• Fix selection.size on enter selections.
• Workaround a Chrome touch bug affecting d3.behavior.zoom.

• Fix the reported center of the transverse Mercator projection.

• Expose the d3 global, even on pages with an AMD loader. This is primarily for the benefit of libraries and plugins that depend on the d3 global but that do not support AMD. However, it also has the benefit that you can use D3 from the developer console even on pages that use AMD.
• Fix the zoom focus on d3.behavior.zoom on the start of a mousewheel zoom gesture, rather than continuously, to avoid unintended panning during zoom.

• Using instanceof with d3.rgb, d3.hsl, d3.lab and d3.hcl now works as expected.
• Expose d3.color to allow subclassing of colors with automatic RGB interpolation.
• Prefer element.matches when available for selection.filter.
• Coerce class name passed to selection.classed to a string.
• Restore workaround for Safari SVGLocatable bug, still present in iOS 7 after 4+ years.
• Add support for spm.

• Fix d3.layout.tree RangeError (maximum call stack size exceeded) on particularly deep trees.
• Fix d3.behavior.zoom bug with multiple touchstart targets.

• Fix parsing of time zone offset (%Z).
• Fix d3.scale.quantile to ignore null values in the domain.
• Optimize d3.mean.

• Optimize d3.interpolateString, especially with many shared numbers. (Thank you, @ChALkeR!)
• Avoid spurious closePath ("Z") commands during geographic clipping.

• d3.scale.linear computes a consistent SI-prefix and precision when the "s" tick format is used.
• d3.bisector may take a comparator (in addition to an accessor as before).
• d3.interpolate prefers interpolateNumber when non-array objects (e.g., Date) are coercible to numbers.
• transition.delay and transition.duration may be called in getter mode.
• Faster parsing of hexadecimal colors contributed by @voidstardb.
• Add d3.touch for getting the location of a single touch.
• Fix bug in d3.behavior.drag: when one touch in a multitouch ends, other touches may continue.
• Fix bug in d3.behavior.drag and d3.behavior.zoom when touchstart target is removed.
• Fix bug in d3.geo.conicConformal for points antipodal to the conic origin.
• Fix bug in d3.formatPrefix: SI-prefixes are consistent for small & large numbers.
• Fix bug in d3.scale.ordinal with a singleton domain, a discrete range and an unknown input value.
• Fix bug in d3.svg.axis where the DOM order of tick elements did not match the display.
• Fix bug in d3.time.scale for subsecond tick generation.
• Remove workaround for three-year old WebKit bug in d3.mouse.
• Remove workaround for old Sizzle sorting bug.
• New locales available for ca-ES, en-GB, pt-BR, and zh-CN.

• Avoid asymmetric behavior of Math.sin and Math.cos in Chrome 33 in d3.geo.area and d3.geo.path.

• Fix missing currency symbol when formatting currencies using SI-prefix notation in a locale with a currency suffix (e.g., Russian).

• Fix winding order bug in projection.clipExtent (e.g., Mercator projection; since 3.4.0).

• Add d3.locale for creating new localized number and time formats.
• Add force.chargeDistance for limiting the effect of charge forces.
• Add timeFormat.multi for multi-resolution time formats.
• Add size and empty methods to d3.map and d3.set.
• Faster implementation of d3.geom.hull contributed by @DanGoldbach.
• Built-in support for AMD / RequireJS.

• Fix crash in scale.nice when a time scale has a sub-second domain.

• Fix antimeridian cutting for the transverse Mercator projection.
• Fix selection.classed when the specified class names are empty.
• Fix d3.random.irwinHall, which was actually returning a Bates distribution. The latter is now available as d3.random.bates.

• Fix DSV parsing (d3.tsv, d3.csv) with cross-domain requests in IE9.

• Fix rendering instability in adaptive resampling when points lie on the antimeridian.
• Fix axis rendering when switching between ordinal and quantitative scales.
• Pass the group index j to the filter function in selection.filter and transition.filter.

• Improve performance of d3.geo.projection when adaptive resampling is disabled.
• Improve performance of drag gestures on browsers that support selectstart events.
• Fix automatic precision of scale.tickFormat when using significant digits.

• Fix catastrophic loss of precision when computing Voronoi tessellation.
• Fix Voronoi tessellation when cell does not intersect the clip extent.
• Fix stale children array when recomputing a hierarchical layout.

• Improve transition performance by deferring the first tick until after all tweens are initialized.
• Faster d3.geom.voronoi based on Raymond Hill’s implementation.
• Fix crash when appending into a document different than the one in which D3 was loaded.
• Fix crash in enter.insert in IE9.
• Optimize d3.merge.

• Improve accuracy of winding order determination in d3.geo.projection.
• Fix spherical clipping for complex polygons.
• Fix viewport clipping when a subject polygon completely surrounds the viewport.
• Fix zero-duration transitions to always tick once at t = 1 (and never t = 0).
• Fix d3.svg.axis to not pollute an ordinal scale’s domain when an explicit range is used.
• Minor optimizations.

• Ordinal scales no longer implicitly extend the domain with rangeBands or rangePoints.

• Fix bug in winding order determination in d3.geo.projection.
• Fix bug in tick key function (e.g., subsecond ticks) in d3.svg.axis.
• Fix crash in tick generation when a d3.time.scale’s domain is empty.

• Fix d3.mouse for touch events with no touches (such as touchend).
• Fix d3.behavior.zoom when a secondary touch is started outside the zoomable element.
• Support parsing time zone offsets (%Z) in d3.time.format.

• Fixes crash in d3.transition on IE9 due to lack of ​_​_​​proto​_​_ support.

• Fix obsolete “major” class being inadvertently applied to axis ticks.
• Fix floating point precision bug in d3.geo.circle causing an occasional coincident endpoint.
• Fix d3.time.format parse to ignore optional padding specifiers (e.g., “%-d”).

• Add selection.interrupt for immediately interrupting the current transition.
• Add brush.event for programmatic brushing, including transitions (e.g., 1 2).
• Add zoom.event for programmatic zooming, including transitions (e.g., 1 2 3 4 5).
• Add d3.interpolateZoom for smooth zooming based on van Wijk & Nuij (e.g., 1 2).
• Add zoom.center to control over focal point while mousewheel zooming (e.g., 1).
• Add “zoomstart” and “zoomend” events to zoom.on.
• Add d3.geo.transform to simplify creating custom geometry transforms (e.g., 1 2).
• Add d3.geo.clipExtent for viewport clipping with custom transforms (e.g., 1).
• Allow d3.geo.stream to stream three-dimensional coordinates; useful for dynamic simplification.
• Add “beforesend” event to xhr.on to manipulate the request before sending.
• Add axis.innerTickSize and axis.outerTickSize; deprecates multi-argument axis.tickSize.
• Add d3.pairs for constructing tuples of adjacent elements.
• On quantitative scales, including time scales, scale.ticks() is now equivalent to scale.ticks(10).
• On quantitative scales, including time scales, scale.nice() is now equivalent to scale.nice(10).
• On time scales, scale.nice(count) and scale.nice(interval, skip) are now supported.
• On time scales, scale.ticks(interval) is now favored over scale.ticks(range).
• Fix transition “end” events such that they are fired before transition cleanup, for easier chaining.
• Fix transition submillisecond timing to improve synchronization of long-running transition chains.
• Fix subpixel-precision brush extent when set programmatically.
• Disable axis.tickSubdivide; use post-selection and multiple axes instead.
• Disable webkit-tap-highlight-color when using the brush.
• Escape non-ascii character in d3.v3.min.js.

• Fix multitouch handling in d3.behavior.zoom and drag-based interaction.
• Fix d3.map copy constructor for objects that implement array.forEach.
• Fix crash in selection.sort when the selection has multiple null nodes.
• Fix crash in tick generation for d3.scale.log with invalid domains that span zero.
• Several micro-optimizations.

• Color interpolators (and by extension, quantitative scales) once again return strings rather than color instances, improving performance and lessening surprise. (Partially reverts 3.2.4.)
• Fix transition chaining such that earlier transitions are guaranteed to end normally (emitting end events) before later transitions start.
• Fix crash in transition.filter with empty transitions.
• Fix zoom behavior on devices that support touch and mouse events simultaneously.

• Fix bug in log.nice introduced in 3.2.5.

• Fix bug with localized decimal point in d3.format.
• Fix default behavior suppression for drag gestures (e.g., d3.behavior.zoom) on touch devices.
• Suppress double-tap default behavior with d3.behavior.zoom on touch devices.
• Improve floating point precision for log.ticks and log.nice.
• Include minified JavaScript for use with Bower.

• Add currency support to d3.format (e.g., "+$,.2f").
• Add missing quantile.invertExtent method.
• Fix enter.insert to preserve order of entering elements relative to updating elements when no before selector is specified. This provides a more efficient alternative to selection.order in cases where the updating selection is not reordered.
• Fix “basis” line interpolation for WebKit marker automatic orientation.
• Fix transition.each to inherit transition.time, precisely synchronizing chained transitions.
• Improve transition performance by lazily constructing "start" and "end" event dispatcher.
• Change d3.interpolateRgb and related methods (including d3.interpolate and d3.scale.linear) to return color instances (e.g., d3.rgb) rather than hexadecimal strings. Reverted in 3.2.7.

• Allow pack.radius to be specified as a constant.
• Accept a function for selection.append and selection.insert.
• Limit automatic transform interpolation to transition.attr.
• Fix polygon.clip for closed polygons.
• Build fixes for Bower and Component(1).

• Add missing transition.size method.
• Augment adaptive resampling with a 30° angular distance threshold, improving performance.
• Better handling of drag gestures in d3.behavior.drag, d3.behavior.zoom and d3.svg.brush by not preventing default behaviors or stopping propagation. For example, mousedown now changes focus, mouseup outside an iframe works correctly, and touchstart does not stutter.

• Fix d3.behavior.zoom for Android.
• Fix d3.min, d3.max and d3.extent for objects with non-orderable values (e.g., new Number(NaN)).
• Fix d3.bisect for non-orderable search value; now returns NaN.
• Fix d3.scale.threshold for non-orderable input values; now returns undefined.
• Fix transition.selectAll when the specified function returns null nodes.
• Fix brush.clamp when no scales are yet attached to the brush.

• Add d3.dsv to support generic delimiter-separated values (e.g., "|") beyond TSV & CSV.
• Add selection.size to count the number of selected elements.
• Add xhr.responseType.
• Add quadtree.extent; deprecates size.
• Add voronoi.clipExtent; deprecates size.
• Add tree.nodeSize and cluster.nodeSize for fixed-size nodes.
• Add pack.radius for explicit control of circle radius.
• Add count argument to linear.nice and pow.nice to control nicing precision.
• Add threshold.invertExtent and quantize.invertExtent.
• Add "step" to line.interpolate and area.interpolate.
• Add brush.clamp to control extent clamping.
• Add support for parsing day-of-year, week-of-year, etc. in d3.time.format.
• Add missing selection.call on enter selections.
• d3.xhr now prefers XMLHttpRequest to XDomainRequest for cross-origin requests, if supported (IE10).
• More accurate d3.geo.area implementation.
• Improve d3.geo.centroid; now supports area-weighted polygon centroids, zero-extent features and improved handling of ambiguous centroids.
• Improve accuracy of geographic clipping and detection of polygon winding order.
• Improve accuracy of geographic adaptive resampling by enforcing a linear minimum sampling distance.
• Improve performance of d3.geo.path by caching projection streams.
• Fix d3.mouse when stylesheets apply padding, margin or borders to all SVG elements.
• Fix d3.behavior.zoom and d3.behavior.drag in regards to canceling mousedown. Zooming and dragging now play nicely with iframes on bl.ocks.org!
• Fix d3.geom.voronoi with custom accessors.
• Fix d3.layout.pack with small-radius circles.
• Fix log.tickFormat; now accepts a string as the format argument.
• Fix time intervals in Firefox when using British Summer Time.

• Fix xhr.response such that if the function errors, it is reported as an error rather than crashing. For example, if d3.json attempts to parse invalid JSON, the callback is now invoked with a ParseError.
• Fix IE9 race condition when a synchronous error invokes xhr.response before it is set.
• Fix d3.timer such that timers are called back in the order they are registered. This guarantees that chained transitions are allowed to end before the next transition in the chain starts.
• Fix d3.timer.flush such that all active timers are ticked once, not just timers with zero delay.
• Optimize timer run loop.

• Revert change to ordinal.rangeBand introduced in 3.1.8.

• Redesign d3.geo.albersUsa. Adopted more standard projections for the contiguous United States, Alaska and Hawaii, and removed Puerto Rico. Now applies clipping, enabling the use of graticules and robust inversion. Note: the projection will now return null when applied to points outside of the visible area. (If you require a similar projection that includes Puerto Rico, see this example.)
• Change default settings of d3.geo.albers to match the new albersUsa projection.
• Optimize d3.geo.path rendering by caching projection streams.
• Define ordinal.rangeBand when ordinal.rangePoints is used. Reverted in 3.1.9.

• Fix pow, sqrt and log scales to preserve set domains exactly.
• Fix d3.interpolate when start and end values are different types; an interpolator is now chosen solely based on the end value. For example, when interpolating from the empty string to a number, d3.interpolateNumber is now used instead of d3.interpolateString, producing the desired intermediate interpolation from zero.
• Fix d3.interpolateString such that the return value is always a string, even if both the start and end value are coercible to numbers.
• Fix d3.interpolateTransform and d3.transform for the identity transform in Firefox.
• Fix regression in projection.clipExtent.
• Improve d3.geo.bounds implementation to handle inflection points and the antimeridian.

• Allow hue, chroma or saturation to be undefined in d3.hsl and d3.hcl.
• When one of the two color’s hue, chroma or saturation is undefined in d3.interpolateHsl or d3.interpolateHcl, use the other color’s value. For example, when interpolating from black to blue in HCL, the intermediate colors are now dark blues (#241178) rather than dark purples (#600054).
• Fix d3.selection and d3.transition to select the document element rather than the document.
• Fix d3.select to not propagate data bound to the document element (if any).
• Fix d3.select and d3.selectAll such that the parent node is the document element.
• Fix d3.geom.hull such that the returned polygon is counterclockwise, consistent with polygon.clip.

• Fix click suppression following a zoom or drag.
• Fix d3.geo.stream for null geometries.
• Fix d3.interpolateNumber and d3.interpolateString to always coerce input values to the appropriate type.
• Fix d3.interpolate such that objects that are coercible to numbers (such as [0]) are still interpolated using d3.interpolateArray or d3.interpolateObject as appropriate.

• Fix projection.clipExtent to remove the redundant closing point when no clipping is performed.

• Fix d3.geo.mercator such that the clip extent is determined automatically by default.

• Fix regression in d3.geom.quadtree introduced in 3.1.0.

• Fix projection.clipExtent for very large coordinates (e.g., satellite projection).

Geo

• Major and minor step to graticule. Default graticule step is now 10°.
• Add d3.geo.distance; deprecate d3.geo.greatArc.
• Add d3.geo.length.
• Add d3.geo.albersUsa invert.
• Add d3.geo.rotation.
• Add d3.geo.projection clipExtent for viewport clipping.
• Add d3.geo.transverseMercator. Useful for state plane projections, for example.
• Add d3.geo.conicConformal, conicEquidistant, conicEqualArea.

Mercator Projection

The Mercator projection now uses viewport clipping rather than clamping latitudes. The viewport is automatically determined by the projection’s scale and translate, but can be set explicitly using projection.clipExtent. Note that only d3.geo.mercator uses viewport clipping; d3.geo.mercator.raw does no clipping or clamping.

D3 3.1 changes the scale of d3.geo.mercator, increasing the effective scale factor by 2π. When upgrading to 3.1, divide your previous scale by 2π when setting, or multiply by 2π when getting. See the d3.geo.tile example for sample usage.

Selections

• Add selection.on("mouseenter") and selection.on("mouseleave") polyfill; see mouseenter <i>vs.</i> mouseover example.
• Add selection.on(".name", null).
• Add selection.insert(name, function).
• Fix for selection.classed in Safari 5.

Scales and Data

• Allow row conversion for d3.csv.parse and d3.tsv.parse.
• Add d3.csv.format and d3.tsv.format.
• Add d3.set.
• Allow d3.map to be used with d3.nest.
• Add d3.scale.log base.
• Add optional format specifier for d3.scale.{linear,pow,sqrt,identity} tickFormat.

Geometry

• Add accessors for d3.geom.{voronoi,quadtree,hull}.
• Add d3.geom.voronoi links, triangles; deprecate d3.geom.delaunay.

And one more thing…

Thanks to SMASH, you can now build a minimal version of D3 that has just the parts you need, reducing the size of your JavaScript assets. For example, if you need d3.geo.mercator and d3.geo.path to render some stuff to Canvas, you could build a minimal bundle that’s only 24K:

smash src/start.js src/geo/path.js src/geo/mercator.js src/end.js > lib.js

See the SMASH wiki for a more detailed example including an example Makefile.

• Fix d3.time.format.iso for Safari 5.

• Fix d3.geo.interpolate for coincident points.
• Improve accuracy of d3.geo.interpolate for small distances using the haversine formula.
• Fix polygon rendering when using projection.clipAngle or projection.clipExtent and multiple points are coincident with the clip boundary.
• Fix d3.rebind such that it returns the target object if the rebound source method returns the source object, rather than checking argument length.

• Fix d3.svg.axis such that: the “tick” class is applied to the g element, rather than the line; the domain path is properly entered when called via transition; and an invalid orientation is treated as "bottom".
• Fix selection.sort such that null nodes are placed at the end, rather than passing undefined to the comparator.
• Fix force.linkDistance and force.linkStrength such that they return a constant value if the link distance or strength is specified as a constant value, rather than returning a function; fix force.drag such that a drag behavior is properly instantiated when called with no arguments, and any additional set fixed bits are preserved on mouseup or mouseout.
• Fix d3.geom.voronoi to workaround Prototype’s broken implementation of array.filter.
• Fix d3.format and d3.formatPrefix to use MICRO SIGN (µ) rather than GREEK SMALL LETTER MU (μ), and fix the rounding specifiers "p" and "r".
• Fix d3.behavior.zoom’s detection of wheel event support, and increase speed for browsers that do not support wheel events.
• Optimize d3.random.logNormal.
• Optimize d3.geo.area.
• Capture references to the d3 namespace, the current document and the current window, rather than rely on globals; allows multiple versions of D3 to be loaded independently.

• Update JSDOM dependency (when using D3 within Node), and remove Sizzle dependency.

• Fix greatArc.target when the specified target is a constant. (Note: greatArc was deprecated in 3.1.0.)

• Fix selection.data when duplicate keys are specified; only the first datum or element is considered and subsequent data or elements are ignored.
• Allow projection to return null if the specified location is clipped.
• Fix localization when building on Linux.