Skip to main content

•plot — Plots

X •plot Y returns a plot spec: a keyed vector holding the data Y and the settings X. Its renderer displays the spec as an SVG chart. Plain text on the left is shorthand for the mark setting. Plots shows each mark and setting with examples.

The series and axes depend on the structure of Y:

  • A vector’s values are plotted against 0…n-1.
  • The keys of a keyed vector of numbers are the x labels.
  • Each row of a matrix is plotted as a series. Row keys name the series. Column keys label x.
  • With the cell mark, each row of a matrix is a row of cells, coloured by value. Row keys label the rows, and row 0 is at the top.
  • Each column of a table, a keyed vector of equal-length columns, is plotted as a series. A column named x supplies the x values.
  • A vector or matrix of plots is drawn as a figure.
Setting Holds Default
mark "line", "point", "bar" or "cell" "line"
title Chart title none
width, height Size in pixels 600, 400
x, y title, scale ("linear" or "log"), ticks, and axis ($f hides that axis)
legend position ("end" or a corner) and border none
grid $f hides the grid lines $t, or $f for cells
axes $f hides both axes, with their ticks and titles. An axis setting in x or y overrides it for that axis $t
flip $t swaps the axes $f
palette Colours for numbers: "viridis", "gray", or a list of colours "viridis"
colorbar $t shows the colour scale beside the plot $f
color, size, labels Styles for every series
series Styles for one series, keyed by its name
widths, heights, share Figure cell sizes and shared axis ranges

color also takes one number per point. palette turns these numbers into colours, over the range of every series in the plot. A cell is coloured by its value unless color is set.

A direct •mime call on a spec reports these errors: DOMAIN for unknown settings or values, and for cells mixed with other marks; LENGTH when series, colours, sizes or labels don’t match the x values; RANK for data that isn’t a vector, matrix or table.