Chart Color Axis

The Chart Canvas element's Chart Color Axis child element allows you to add a color axis for series charts.

You have the option to display the axis as scalar or based on data classes. Scalar axes are represented by a gradient, ranging between Min Color and Max Color, as shown above. On the other hand, Chart Color axes based on data classes are divided into separate classes based on their values.

To utilize this feature, add the Chart Color Axis child element to your ChartCanvas.

Series.Whiskers is the only series chart that does not support this feature.

The Chart Color Axis element has the following attributes:

Attribute	Description
ID	Sets a unique element ID for the chart axis. This attribute is optional, but beneficial when using numerous color axes for a series (see below).
Max Color	Sets the max color for the color axis. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, e.g. #112233. Or, choose a color via the color picker by selecting the "..." option next to this field. If not set, the default color will be obtained according to the current theme.
Max Value	Sets the maximum number the color axis will display. If this value is not set, the extreme value of the color axis will be calculated automatically.
Min Color	Sets the min color for the color axis. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, e.g. #112233. Or, choose a color via the color picker by selecting the "..." option next to this field. If not set, the default color will be obtained according to the current theme.
Min Value	Sets the minimum number the color axis will display. If this value is not set, the extreme value of the color axis will be calculated automatically.
Reverse Axis	Reverses the axis so low and high values are swapped. Chart is then rendered to match. For example, if Y-axis is reversed, low values are at the top of the canvas and the chart is drawn "downward" from it.
Show In Legend	Specifies whether to display the Color Axis in the legend. The default value is True.
Tick Count	Sets the number of ticks for your X and Y-axis. The default value is Undefined. Set this value to a number greater than 2. Tick Count can only be used with Linear axes; DateTime, Logarithmic, and Category axes are not affected.

For Heatmaps, the attributes "Max Color" and "Min Color" will be ignored and replaced with "High Value Color" and "Low Value Color".

To support this feature, the Chart Canvas element also includes two new attributes, Linked to Color Axis ID and Color-Axis Data Column. The Linked to Color Axis ID attribute specifies the ID of a Y-Axis element that this series should be linked to when using multiple Y-axes. If you are using the Chart Color Axis element in a mult-series chart, by default, the series will link to the first color axis. To link the series to a special color axis, set the ID attribute of the Chart Color Axis element to the corresponding Series' Linked to Color Axis ID attribute, as demonstrated below:

The Color-Axis Data Column specifies the name of a datalayer column whose values will be plotted along the x-axis. See example configuration below:

• For Heatmaps, the "Color-Axis Data Column" of the series is ignored and replaced with "Heat Map Color Data Column" of the Heatmap series.

• For other chart types, the series' Chart Color-Axis Data Column attribute must be the output column of the datalayer. If this value is not set, the column of "y" or "low" will be used.