BarChart¶

A bar chart. The x field should contain a distinct value for each bar, while the y field will correspond to the height of each bar. The color field may be used to color each bar. In the case where there are multiple records for a single x value, aggregate may be used to combine values into a single bar.

This component can be found in the candela/plugins/vega plugin.

Example¶

JavaScript

<body>
<script src="//unpkg.com/candela/dist/candela.min.js"></script>
<script>
  var el = document.createElement('div')
  document.body.appendChild(el);

  var data = [];
  for (var d = 0; d < 10; d += 1) {
    data.push({
      a: d,
      b: d
    });
  }

  var vis = new candela.components.BarChart(el, {
    data: data,
    x: 'a',
    y: 'b'
  });
  vis.render();
</script>
</body>

Python

import pycandela

data = [{'a': d, 'b': d} for d in range(10)]

pycandela.components.BarChart(data=data, x='a', y='b')

R

library(candela)

candela('BarChart', data=mtcars, x='mpg', y='wt', color='disp')

Options¶

data (Table): The data table.
x (String): The x axis (bar position) field. Must contain numeric data. See Axis scales.
xType (String): The data type for the x field. The default is "nominal".
y (String): The y axis (bar height) field. Must contain numeric data. See Axis scales.
yType (String): The data type for the y field. The default is "quantitative".
color (String): The field used to color the bars.
colorType (String): The data type for the color field. The default is "nominal".
aggregate (String): The aggregation mode for y values when the x value is the same in multiple records. The default is "sum".
width (Number): Width of the chart in pixels. See Sizing.
height (Number): Height of the chart in pixels. See Sizing.
renderer (String): Whether to render in "svg" or "canvas" mode (default "canvas").