Range Column Chart

• Overview
• Modules
• Quick Start
• General Settings
• Special Settings
  • Appearance
    • All Points
    • Individual Points
  • Padding
    • Single Series
    • Multiple Series
  • Point Size
  • Labels
  • Tooltips
  • Vertical Range Column

Overview

A range column chart displays information as a range of data by plotting two Y-values (low and high) per data point. The vertical axis shows the values, and the horizontal axis shows the categories they belong to; in multiple-series range column charts, values are grouped by categories.

This type is sometimes referred to as the floating column chart since it looks like a set of columns "floating" above the horizontal axis. It is used to show the difference between high and low values while visualizing time-based data or showing comparison among categories.

This article explains how to create a basic Range Column chart as well as configure settings that are specific to the type. You can also see the table below to get a brief overview of the Range Column chart's characteristics:

Modules

The Range Column chart requires adding the Core and Basic Cartesian modules:

<script src="https://cdn.anychart.com/releases/8.13.0/js/anychart-core.min.js"></script>

<script src="https://cdn.anychart.com/releases/8.13.0/js/anychart-cartesian.min.js"></script>

Alternatively, you can use the Base module, which includes, among other things, the two modules mentioned above:

<script src="https://cdn.anychart.com/releases/8.13.0/js/anychart-base.min.js"></script>

Learn more: Modules.

Quick Start

To create a Range Column chart, use the rangeColumn() method (before, of course, you should create a chart by using anychart.column() or any other cartesian chart constructor).

Since range column charts plot two Y-values per data point, you need to specify two values for each category by using the low and high parameters. This is how it looks like in object notation:

var data = [
  {x: "January", low: 0.7, high: 6.1},
  {x: "February", low: 0.6, high: 6.3},
  {x: "March", low: 1.9, high: 8.5},
  {x: "April", low: 3.1, high: 10.8},
  {x: "May", low: 5.7, high: 14.4}
];

The following sample demonstrates how a basic Range Column chart is created:

// create data
var data = [
  ["January", 0.7, 6.1],
  ["February", 0.6, 6.3],
  ["March", 1.9, 8.5],
  ["April", 3.1, 10.8],
  ["May", 5.7, 14.4]
];

// create a chart
chart = anychart.column();

// create a range column series and set the data
var series = chart.rangeColumn(data);

// set the container id
chart.container("container");

// initiate drawing the chart
chart.draw();

General Settings

In AnyChart there are many settings that are configured in the same way for all chart types, including the Range Column chart (for example, legend and interactivity settings).

Read the overview of general settings: General Settings.

Special Settings

Appearance

All Points

The appearance settings of a Range Column can be configured in three states: normal, hover, and selected. Use the normal(), hovered(), and selected() methods.

Combine them with the following methods:

• fill() to set the fill
• hatchFill() to set the hatch fill
• stroke() to set the stroke

Also, you can use some other methods from anychart.core.StateSettings.

In the sample below, there are two Range Column series with appearance settings configured:

// create the first series
var series1 = chart.rangeColumn(seriesData_1);

// configure the visual settings of the first series
series1.normal().fill("#00cc99", 0.3);
series1.hovered().fill("#00cc99", 0.1);
series1.selected().fill("#00cc99", 0.5);
series1.normal().stroke("#00cc99", 1, "10 5", "round");
series1.hovered().stroke("#00cc99", 2, "10 5", "round");
series1.selected().stroke("#00cc99", 4, "10 5", "round");

// create the second series
var series2 = chart.rangeColumn(seriesData_2);

// configure the visual settings of the second series
series2.normal().fill("#0066cc", 0.3);
series2.hovered().fill("#0066cc", 0.1);
series2.selected().fill("#0066cc", 0.5);
series2.normal().hatchFill("forward-diagonal", "#0066cc", 1, 15);
series2.hovered().hatchFill("forward-diagonal", "#0066cc", 1, 15);
series2.selected().hatchFill("forward-diagonal", "#0066cc", 1, 15);
series2.normal().stroke("#0066cc");
series2.hovered().stroke("#0066cc", 2);
series2.selected().stroke("#0066cc", 4);

Individual Points

If you use object notation to set the data, you can change the appearance (and some other settings) of individual columns by adding special fields to your data:

// create data
var data = [
  {x: "January", low: 0.7, high: 6.1},
  {x: "February", low: 0.6, high: 6.3},
  {x: "March", low: 1.9, high: 8.5},
  {x: "April", low: 3.1, high: 10.8},
  {x: "May", low: 5.7, high: 14.4,
   normal:   {
               fill: "#5cd65c",
               stroke: null,
               label: {enabled: true}
             },
   hovered:  {
               fill: "#5cd65c",
               stroke: null,
               label: {enabled: true},
             },
   selected: {
               fill: "#5cd65c",
               stroke: null,
               label: {enabled: true},
             }
  }
];

// create a chart
chart = anychart.column();

// create a range column series and set the data
var series = chart.rangeColumn(data);

If you use an array to set the data, you can also configure the appearance of each column individually, but in a slightly different way. You should first add visual parameters to the data set and then map fields for them so that they can be interpreted by the component:

// create a data set
var data = anychart.data.set([
  ["January", 0.7, 6.1, 8.1, 12.6],
  ["February", 0.6, 6.3, 8.5, 12.2],
  ["March", 1.9, 8.5, 10.3, 13.1],
  ["April", 3.1, 10.8, 13.4, 15.9],
  ["May", 5.7, 14.4, 14.9, 16.4, "#5cd65c", "#009933", null, {enabled: true}]
]);

// map the data
var seriesData_1 = data.mapAs({x: 0, low: 1, high: 2, fill: 5, stroke: 7, label: 8});
var seriesData_2 = data.mapAs({x: 0, low: 3, high: 4, fill: 6, stroke: 7, label: 8});

// create a chart
chart = anychart.column();

// create series and set the data
var series1 = chart.rangeColumn(seriesData_1);
var series2 = chart.rangeColumn(seriesData_2);

Padding

To set the padding between columns and column groups, use these methods:

• barsPadding()
• barGroupsPadding()

Padding is measured as a ratio to the width of columns (the width is calculated automatically). So, if it is < 1, the space between columns or column groups is less than the width of columns, and vice versa. If padding is set to 0, there is no space between columns/groups, and a negative parameter makes columns overlap each other.

Single Series

Please note that in AnyChart single-series range column charts are, technically speaking, composed of one-element column groups, so you should use barGroupsPadding() to configure the padding between columns. In the following sample it is set to 0:

// create a range column series
var series = chart.rangeColumn(data);

// set the padding between column groups
chart.barGroupsPadding(0);

Multiple Series

The barsPadding() method works only with multiple-series charts: it sets the padding between columns within a group. The space between groups is set via barGroupsPadding().

If you set barsPadding() to -1, you can create an imitation of a stacked chart, which is not bound to zero. See the sample below (there is a multiple-series Range Column chart with the padding between columns and between column groups set to -1 and 2):

// create the first series
var series1 = chart.rangeColumn(seriesData_1);

// create the second series
var series2 = chart.rangeColumn(seriesData_2);

// set the padding between columns
chart.barsPadding(-1);

// set the padding between column groups
chart.barGroupsPadding(2);

Point Size

This chart type allows you to set the size of its points. Read more in the Point Size article.

Labels

Labels are text or image elements that can be placed anywhere on any chart (you can enable them on a whole series or in a single point). For text labels, font settings and text formatters are available.

Tooltips

A Tooltip is a text box displayed when a point on a chart is hovered over. There is a number of visual and other settings available: for example, you can edit the text by using font settings and text formatters, change the style of background, adjust the position of a tooltip, and so on.

Vertical Range Column

Most types of series in AnyChart can be drawn both in horizontal and vertical orientation: Vertical Charts.

The vertical range column chart is called the range bar chart: it shows categories on the vertical axis instead of the horizontal axis and represents values as bars instead of columns. Read more: Range Bar Chart.