axis.break

Cuts an interval out of an axis and closes the axis up around it, marking the cut with two slanted strokes on the axis line. axis.break(y: [0, 60]) lets a series between 62 and 66 fill the plot while the axis still starts at 0. The axis is chosen by which interval is given.

axis.breakNode
Only withxxyplane

An axis break cuts an interval out of an axis and closes the axis up around it. axis.break(y: [0, 60]) under a series that runs from 62 to 66 lets the data fill the plot while the axis still starts at 0. The ticks read 0, 60, 62, 64, and two slanted strokes on the axis line show where the values were removed. Which axis it cuts is chosen by which interval is given.

The cut is drawn one grid step wide, so choose ends that fall on ticks: with a step of 2, [0, 60] puts 0 and 60 on neighbouring ticks. Everything past the break moves with it, so a bar from 0 to 140 is drawn across a break at [20, 120]. Use a break on a line or scatter chart that should show where zero is, or to keep one outlying bar from flattening the rest. It works on numeric axes, linear or log, but not on an axis of names.

#Attributes

On any plane
x
The interval to cut out of the x axis, e.g. [0, 60]. Give exactly one of x or y. The cut is drawn one grid step wide, so ends that fall on ticks read as neighbouring ticks.
axis-interval
Only withxyplane
yImplicit
The interval to cut out of the y axis. Values inside it are squeezed into the cut rather than dropped.
axis-interval
Can be written as shorthand: axis.break:value

#Allowed in

canvas.graph { }cue { }cue.draw { }cue.trace { }cue.highlight { }cue.spotlight { }

#Examples

Voter turnout from 2009 to 2013 between 62 and 66 percent, the y axis starting at 0 with a break before 60.Voter turnout from 2009 to 2013 between 62 and 66 percent, the y axis starting at 0 with a break before 60.
@data#turnout{
    year | percent
    2009 | 62.1
    2010 | 63.4
    2011 | 62.8
    2012 | 65.2
    2013 | 65.9
}
canvas.graph{
    line(x: #turnout.year; y: #turnout.percent)
    axis.break(y: [0, 60])
}(
    x-format: dates
)
Four bars of 12, 15, 9 and 140, the y axis broken between 20 and 120 so the three short bars stay readable.Four bars of 12, 15, 9 and 140, the y axis broken between 20 and 120 so the three short bars stay readable.
canvas.graph{
    bar(x: A, B, C, D; y: 12, 15, 9, 140)
    axis.break(y: [20, 120])
}

Last updated