Scales

Overview

In AnyChart scales control calculations and modes while Axes control axes labels, lines and tick marks. Learn more about basis Axes options available (like tickmarks, axis line and so on) see Axes, to learn more about basic scale options (like maximum, minimum, scale modes and so on) see Scale tutorial.

In this section we will demonstrate only the differences of AnyStock scales from basic charts' ones.

Stock Scales Features

The biggest difference between scales in basic charts and stocks is the fact that you have scales in every plot and have to configure them accorindgly - in different plots. If there is a reason, you can create shared scales, but in most cases configuration goes like this:

// get a plot scale
yScale = chart.plot(0).yScale();

// set minimum/maximum and inversion
yScale.minimum(1000000);
yScale.maximum(350000000);
yScale.inverted(true);

// create a logarithmic scale
var logScale = anychart.scales.log();
chart.plot(1).yScale(logScale);

The result of the configuration shown above, along with some axes tuning can be seen on a sample below:

Playground

Multiple scales and axes

Comparison Mode

AnyChart Stock supports the "Comparison Mode" scale - a very important feature for showing stocks-related information that allows comparing changes in series values. You can compare with the first visible value, series first value and a custom date, see Comparison base section below to learn more.

To enable this mode use comparisonMode() method that accepts values of anychart.enums.ScaleComparisonMode enum as a parameter value. Possible values:

ModeEnum ConstantValue
No changes, values displayedanychart.enums.ScaleComparisonMode.NONE"none"
Percent Changes Displayedanychart.enums.ScaleComparisonMode.PERCENT"percent"
Value Changes Displayesanychart.enums.ScaleComparisonMode.VALUE"value"

Values

In "value" mode the changes are displayed in original scale units.

chart = anychart.stock();
chart.plot(0).yScale().comparisonMode("value");

Percents

In "percent" mode the changes are displayed in percents.

chart = anychart.stock();
chart.plot(0).yScale().comparisonMode("percent");

Sample below shows three plots, all three display the same series, but scale comparison mode is set to "None", "Value" and "Percent" to the first, the second and the third plot respectively:

Playground

Comparison Base

When you work with a scale in Comparison Mode you can choose what value is used as the comparison base. It is done using compareWith() method which accepts values from anychart.enums.ScaleCompareWithMode enum or a date/number representation of a custom date.

chart = anychart.stock();
// percent mode with series start as the comparison base
chart.plot(0).yScale().comparisonMode("percent");
chart.plot(0).yScale().compareWith("seriesStart");

// value mode with custom date as the comparison date
// date is 24 of April 2008, set as a JavaScript Timestamp 
chart.plot(1).yScale().comparisonMode("value");
chart.plot(1).yScale().compareWith(1209081600000);
// the following line gives the same result
// chart.plot(1).yScale().compareWith(Date.UTC(2008, 3, 25));

Playground

Stacked Mode

The stacked charts are a popular visual aid used for categorizing and comparing the parts of a whole. Each element in the chart represents a whole, and the segments represent parts of that whole. Different colors used for the segments distinguish the categories. Stacked charts are also known as stacked graphs.

Stacking is a special mode of a Scale set by stackMode() method, and several types of series are compatible with this mode. If a series can not be stacked it simply ignores the mode.

There are two modes of stacking: value and percent.

Value

To create a value stacked chart you need to set scale stackMode to "value":

chart = anychart.stock();
chart.plot(0).yScale().stackMode("value");

Playground

Percent

To create a value stacked chart you need to set scale stackMode to "percent":

chart = anychart.stock();
chart.plot(0).yScale().stackMode("percent");

Playground

You are looking at an outdated v7 version of this document. Switch to the v8 version to see the up to date information.