View on

Scales

Scale settings control how input data is mapped to plot coordinates.

Scale Types

You can change the scale type using the scale-x and scale-y properties on the plot element:

scale-x: <scale-options>;
scale-y: <scale-options>;

The following scale options are currently supported:

Limits

The scale limits are the smallest (min) and largest (max) values that will be displayed on the plot. Configure using the axis-x-min, axis-x-max, axis-y-min and axis-y-max properties.

scale-x-min: <value>;
scale-x-max: <value>;
scale-y-min: <value>;
scale-y-max: <value>;

Ticks & Labels

The axis layout setting allows you to control how ticks and labels are placed on the axis.

axis-top: <axis-layout> <label-format>;
axis-right: <axis-layout> <label-format>;
axis-bottom: <axis-layout> <label-format>;
axis-left: <axis-layout> <label-format>;

Alternatively, you can configure the layout and formater separately:

axis-top-layout: <axis-layout>;
axis-top-format: <label-format>;

Tick Placement

The layout of an axis controls where how ticks an labels are placed. The list of valid <axis-layout> values is:


linear

linear(N)

The linear layout will place a 'tick' every N units. If no N parameter is provided it will be chosen automatically.

axis_linear.svg


linear(N, align A)

The same as the linear layout, but the ticks will be aligned to an arbitrary start value A.

axis_linear_align.svg


discrete

The discrete layout marks a number of discrete groups on the axis. It is usually used when plotting bar/column charts.

axis_discrete.svg


subdivide

subdivide(N)

The subdivide layout will divide the axis into N evenly sized divisions and then mark each region boundary.

axis_discrete.svg

Label Formatter

The <label-format> setting controls how values are formatted for display. For example, you can use it to set the floating point display precision, add a unit of measurement to display values or display values as human-readable date strings. Fore more information on setting the label label format, please refer to the Formatter page.

Categorical Values

Logarithmic, Inverted

Multiple Scales

Edit this page on GitHub