d3-object-charts v1.2.22

D3 Object Charts

This is a collection of unconventional D3 charts that aren't typically included in D3 graphing libraries such as C3, available as ES6 classes.

D3 visualization components implemented as objects. Available charts:

• Calendar grid chart
• Range slider - slider with two handles and configurable min/max's between the handles.
• Simple slider - slider with single handle that slides continuously.
• Snap slider - slider with one handle that will snap to values provided as labels.
• Comparative pie - Nest a standard pie chart within another circle, whose circumference intersects at bottom left corner of graph.
• Overlap bar - Similar to a stacked bar chart, but bars all start at 0, so you can style some bars to be transparent and provide an overlapped comparative view.

The easiest way get a feel for these charts is to checkout the examples.

• See them in action here.
• Checkout intialization in example entry.js.
• CSS plays a big role in the utility of some of these graphs example style.css.

Installing

Make sure the following packages are installed on your machine

• node.js
• npm

Install dependencies

$ npm install

Minified production build

Compile into a minified bundle with external stylesheets.

$ gulp build

Usage

After the installation of the dependencies the required chart can be instantiated in src/main.js.

Upon completion it has to be compiled using:

$ gulp build

The compiled JS and CSS files can now be referenced to from within an HTML file.

// Minified stylesheets
<link href="dist/style.min.css" rel="stylesheet" type="text/css">

// Minified bundle containing D3 and chart implementation
<script charset="utf-8" src="dist/bundle.js"></script>

API reference

Calendar grid chart

Grid chart showing one month per row. Displays the y values in different opacities of a color tone. Higher values equal a darker color.

This example depicts a calendar grid chart created with the required options using this example data set.

var calendar = new CalendarGridChart({
  container: '#container-calendar',
});
calendar.drawData({
  values: data
});

Options: object instantiation

The following list shows all available options that can be passed to the CalendarGridChart object during the instantiation.

var calendar = new CalendarGridChart({
  container: '#container-calendar',
  // optional properties:
  date_attr: 'date',
  // ...
});

Properties marked in this format are required.

Options: drawData method call

The following list shows all available options that can be passed to the drawData method call.

// previously created variable is referenced
calendar.drawData({
  css_class: "production-value",
  // optional property:
  values: data
});

Properties marked in this format are required.

Range slider

Slider to update the data range (integer or date) dynamically. The range selection (minimum and maximum) is instantly provided as an output.

This example depicts a range slider created with the required options.

var range_slider = new RangeSlider({
  container: '#range-slider-int',
  outer_height: 100,
  delta: {
    'min': 50,
    'max': 100
  },
  onRangeUpdated: function(min, max) {
    console.log('min', min);
    console.log('max', max);
  }
});
range_slider.drawData({
  abs_min: 0,
  abs_max: 1000,
  current_min: 100,
  current_max: 200,
});

Options: object instantiation

The following list shows all available options that can be passed to the RangeSlider object during the instantiation.

var range_slider = new RangeSlider({
  container: '#range-slider',
  delta: {
    'min': 50,
    'max': 100
  },
  onRangeUpdated: function(min, max) {
    // specify what to do with output range
  }
});

Properties marked in this format are required.

Options: drawData method call

The following list shows all available options that can be passed to the drawData method call.

// previously created variable is referenced
range_slider.drawData({
  abs_min: 0,
  abs_max: 1000,
  current_min: 100,
  current_max: 200,
});

Properties marked in this format are required.

Examples

Calendar grid chart

This example depicts a calendar grid chart created with additional non-default options and this example data set.

var calendar1 = new CalendarGridChart({
  container: '#container-calendar1',
  date_attr: 'day_date',
  range_attr: 'production',
  outer_width: 800,
  outer_height: 400,
  color_max: '#0404B4'
});

calendar1.drawData({
  css_class: "prod-value",
  values: data1
});

This example depicts a calendar grid chart created with additional non-default options and this example data set.

var calendar2 = new CalendarGridChart({
  container: '#container-calendar2',
  grid_padding: 0.3,
  margin: {
    top: 50,
    left: 115,
    bottom: 50,
    right: 0
  },
  display_date_format: '%m %Y',
  date_attr: 'date',
  min_range_zero: true,
  range_attr: 'value',
  color_max: '#339900',
  legend: false
});

calendar2.drawData({
  css_class: "value",
  values: data2
});

Range slider

This example depicts a range slider created with additional non-default options.

var range_slider = new RangeSlider({
  container: '#range-slider',
  delta: {
    'min': 3600 * 24 * 1 * 1000,
    'max': 3600 * 24 * 5 * 1000
  },
  date_range: true,
  onRangeUpdated: function(min, max) {
    console.log('min', min);
    console.log('max', max);
  }
});

range_slider.drawData({
  abs_min: new Date(new Date() - 3600 * 24 * 30 * 1000), // 30 days ago
  abs_max: new Date(),
  current_min: new Date(new Date() - 3600 * 24 * 10 * 1000),
  current_max: new Date(new Date() - 3600 * 24 * 6 * 1000)
});

This example depicts a calendar grid chart created with additional non-default options.

var range_slider_int = new RangeSlider({
  container: '#range-slider-int',
  delta: {
    'min': 10,
    'max': 20
  },
  tick_amount: 4,
  onRangeUpdated: function(min, max) {
    console.log('min', min);
    console.log('max', max);
  }
});

range_slider_int.drawData({
  abs_min: 10,
  abs_max: 99,
  current_min: 40,
  current_max: 50,
});

Simple Slider

You can pass a axis_click_handle boolean to move the handle position by clicking on any part of the x axis. This feature is disabled by default.

var simple_slider = new SimpleSlider({
  container: '#simple-slider',
  tick_labels: {
    0: '0%',
    10: '10%',
    20: '20%',
    30: '30%',
    40: '40%',
    50: '50%',
    60: '60%',
    70: '70%',
    80: '80%',
    90: '90%',
    100: '100%'
  },
  axis_click_handle: true,
  onChange: function(new_value) {
    console.log('new_value', new_value);
  }
});

simple_slider.drawData({
  abs_min: 0,
  abs_max: 100,
  current_value: 30
});

Snap Slider

Snap slider is a simple slider that will snap a D3 brush to the nearest tick mark.

You can pass in a snap_debounce time in ms, to make the handler more or less smooth.

Additionally you can pass a axis_click_handle boolean to move the handle position by clicking on any part of the x axis. The handle then smoothly scrolls to the nearest tick mark. This feature is disabled by default.

The onSnap call back is triggered anytime the handle is snapped to a tick mark.

var snap_slider = new SnapSlider({
  container: '#snap-slider',
  tick_labels: {
    0: '0%',
    10: '10%',
    20: '20%',
    30: '30%',
    40: '40%',
    50: '50%',
    60: '60%',
    70: '70%',
    80: '80%',
    90: '90%',
    100: '100%'
  },
  snap_debounce: 100,
  axis_click_handle: true,
  onSnap: function(snap_value) {
    console.log('snap_value', snap_value);
  }
});

snap_slider.drawData({
  abs_min: 0,
  abs_max: 100,
  current_value: 30
});

Developing

Build development files

Compile into a un-minified bundle.

$ gulp dev

Watch mode

Recompile after detected file change.

$ gulp watch

Run Jasmine spec tests

$ gulp test