1 nv.models.multiBarTimeSeries = function() {
3 //============================================================
4 // Public Variables with Default Settings
5 //------------------------------------------------------------
7 var margin = {top: 0, right: 0, bottom: 0, left: 0}
11 , y = d3.scale.linear()
12 , id = Math.floor(Math.random() * 10000) //Create semi-unique ID in case user doesn't select one
13 , getX = function(d) { return d.x }
14 , getY = function(d) { return d.y }
15 , forceY = [0] // 0 is forced by default.. this makes sense for the majority of bar graphs... user can always do chart.forceY([]) to remove
18 , color = nv.utils.defaultColor()
24 , dispatch = d3.dispatch('chartClick', 'elementClick', 'elementDblClick', 'elementMouseover', 'elementMouseout')
27 //============================================================
30 //============================================================
32 //------------------------------------------------------------
34 var x0, y0 //used to store previous scales
37 //============================================================
40 function chart(selection) {
41 selection.each(function(data) {
42 var availableWidth = width - margin.left - margin.right,
43 availableHeight = height - margin.top - margin.bottom,
44 container = d3.select(this);
47 data = d3.layout.stack()
49 .values(function(d){ return d.values })
54 //add series index to each data point for reference
55 data.forEach(function(series, i) {
56 series.values.forEach(function(point) {
61 //------------------------------------------------------------
64 // remap and flatten the data for use in calculating the scales' domains
65 var seriesData = (xDomain && yDomain) ? [] : // if we know xDomain and yDomain, no need to calculate
66 data.map(function(d) {
67 return d.values.map(function(d,i) {
68 return { x: getX(d,i), y: getY(d,i), y0: d.y0 }
72 x .domain(xDomain || d3.extent(d3.merge(seriesData).map(function(d) { return d.x })))
73 .range(xRange || [0, availableWidth]);
75 y .domain(yDomain || d3.extent(d3.merge(seriesData).map(function(d) { return d.y + (stacked ? d.y0 : 0) }).concat(forceY)))
76 .range(yRange || [availableHeight, 0]);
79 // If scale's domain don't have a range, slightly adjust to make one... so a chart can show a single data point
80 if (x.domain()[0] === x.domain()[1])
82 x.domain([x.domain()[0] - x.domain()[0] * 0.01, x.domain()[1] + x.domain()[1] * 0.01])
85 if (y.domain()[0] === y.domain()[1])
87 y.domain([y.domain()[0] + y.domain()[0] * 0.01, y.domain()[1] - y.domain()[1] * 0.01])
94 //------------------------------------------------------------
97 //------------------------------------------------------------
98 // Setup containers and skeleton of chart
100 var wrap = container.selectAll('g.nv-wrap.nv-multibar').data([data]);
101 var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-multibar');
102 var defsEnter = wrapEnter.append('defs');
103 var gEnter = wrapEnter.append('g');
104 var g = wrap.select('g')
106 gEnter.append('g').attr('class', 'nv-groups');
108 wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
110 //------------------------------------------------------------
114 defsEnter.append('clipPath')
115 .attr('id', 'nv-edge-clip-' + id)
117 wrap.select('#nv-edge-clip-' + id + ' rect')
118 .attr('width', availableWidth)
119 .attr('height', availableHeight);
121 g .attr('clip-path', clipEdge ? 'url(#nv-edge-clip-' + id + ')' : '');
125 var groups = wrap.select('.nv-groups').selectAll('.nv-group')
126 .data(function(d) { return d }, function(d) { return d.key });
127 groups.enter().append('g')
128 .style('stroke-opacity', 1e-6)
129 .style('fill-opacity', 1e-6);
130 d3.transition(groups.exit())
131 //.style('stroke-opacity', 1e-6)
132 //.style('fill-opacity', 1e-6)
133 .selectAll('rect.nv-bar')
134 .delay(function(d,i) { return i * delay/ data[0].values.length })
135 .attr('y', function(d) { return stacked ? y0(d.y0) : y0(0) })
139 .attr('class', function(d,i) { return 'nv-group nv-series-' + i })
140 .classed('hover', function(d) { return d.hover })
141 .style('fill', function(d,i){ return color(d, i) })
142 .style('stroke', function(d,i){ return color(d, i) });
143 d3.transition(groups)
144 .style('stroke-opacity', 1)
145 .style('fill-opacity', .75);
148 var bars = groups.selectAll('rect.nv-bar')
149 .data(function(d) { return d.values });
151 bars.exit().remove();
154 for(var ei=0; ei<seriesData.length; ei+=1) {
155 maxElements = Math.max(seriesData[ei].length, maxElements);
158 var bandWidth = (availableWidth / maxElements)-0.1;
159 var barWidth = bandWidth / data.length;
161 var barsEnter = bars.enter().append('rect')
162 .attr('class', function(d,i) { return getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive'})
163 .attr('x', function(d,i,j) {
164 return stacked ? 0 : (i * bandWidth) + ( j * barWidth )
166 .attr('y', function(d) { return y0(stacked ? d.y0 : 0) })
168 .attr('width', stacked ? bandWidth : barWidth );
170 .on('mouseover', function(d,i) { //TODO: figure out why j works above, but not here
171 d3.select(this).classed('hover', true);
172 dispatch.elementMouseover({
175 series: data[d.series],
176 pos: [x(getX(d,i)) + (barWidth * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))], // TODO: Figure out why the value appears to be shifted
178 seriesIndex: d.series,
182 .on('mouseout', function(d,i) {
183 d3.select(this).classed('hover', false);
184 dispatch.elementMouseout({
187 series: data[d.series],
189 seriesIndex: d.series,
193 .on('click', function(d,i) {
194 dispatch.elementClick({
197 series: data[d.series],
198 pos: [x(getX(d,i)) + (barWidth * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))], // TODO: Figure out why the value appears to be shifted
200 seriesIndex: d.series,
203 d3.event.stopPropagation();
205 .on('dblclick', function(d,i) {
206 dispatch.elementDblClick({
209 series: data[d.series],
210 pos: [x(getX(d,i)) + (barWidth * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))], // TODO: Figure out why the value appears to be shifted
212 seriesIndex: d.series,
215 d3.event.stopPropagation();
218 .attr('class', function(d,i) { return getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive'})
219 .attr('transform', function(d,i) { return 'translate(' + x(getX(d,i)) + ',0)'; })
222 .delay(function(d,i) { return i * delay / data[0].values.length })
223 .attr('y', function(d,i) {
224 return y(getY(d,i) + (stacked ? d.y0 : 0));
226 .attr('height', function(d,i) {
227 return Math.abs(y(d.y + (stacked ? d.y0 : 0)) - y((stacked ? d.y0 : 0)))
229 .each('end', function() {
230 d3.transition(d3.select(this))
231 .attr('x', function(d,i) {
232 return stacked ? 0 : (i * bandWidth) + ( j * barWidth )
234 .attr('width', stacked ? bandWidth : barWidth );
238 .delay(function(d,i) { return i * delay/ data[0].values.length })
239 .attr('x', function(d,i) {
240 return d.series * barWidth
242 .attr('width', barWidth)
243 .each('end', function() {
244 d3.transition(d3.select(this))
245 .attr('y', function(d,i) {
246 return getY(d,i) < 0 ?
250 .attr('height', function(d,i) {
251 return Math.abs(y(getY(d,i)) - y(0))
256 //store old scales for use in transitions on update
266 //============================================================
267 // Expose Public Variables
268 //------------------------------------------------------------
270 chart.dispatch = dispatch;
272 chart.options = nv.utils.optionsFunc.bind(chart);
274 chart.x = function(_) {
275 if (!arguments.length) return getX;
280 chart.y = function(_) {
281 if (!arguments.length) return getY;
286 chart.margin = function(_) {
287 if (!arguments.length) return margin;
288 margin.top = typeof _.top != 'undefined' ? _.top : margin.top;
289 margin.right = typeof _.right != 'undefined' ? _.right : margin.right;
290 margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
291 margin.left = typeof _.left != 'undefined' ? _.left : margin.left;
295 chart.width = function(_) {
296 if (!arguments.length) return width;
301 chart.height = function(_) {
302 if (!arguments.length) return height;
307 chart.xScale = function(_) {
308 if (!arguments.length) return x;
313 chart.yScale = function(_) {
314 if (!arguments.length) return y;
319 chart.xDomain = function(_) {
320 if (!arguments.length) return xDomain;
325 chart.yDomain = function(_) {
326 if (!arguments.length) return yDomain;
331 chart.xRange = function(_) {
332 if (!arguments.length) return xRange;
337 chart.yRange = function(_) {
338 if (!arguments.length) return yRange;
343 chart.forceY = function(_) {
344 if (!arguments.length) return forceY;
349 chart.stacked = function(_) {
350 if (!arguments.length) return stacked;
355 chart.clipEdge = function(_) {
356 if (!arguments.length) return clipEdge;
361 chart.color = function(_) {
362 if (!arguments.length) return color;
363 color = nv.utils.getColor(_);
367 chart.id = function(_) {
368 if (!arguments.length) return id;
373 chart.delay = function(_) {
374 if (!arguments.length) return delay;
379 //============================================================