Skip to main content

grid

lq.grid(ticks, sub, kind="x", stroke=0.5pt + luma(80%), stroke-sub=none, z-index=0)(source)

An axis grid for highlighting tick positions in the diagram area. The grid lines are determined from the ticks located by the tick locators of the main xx and yy axes for vertical and horizontal grid lines, respectively.

One way to set up the grid stroke is with a style rule. The stroke for the grid lines at the main ticks is controlled by grid.stroke

#show: lq.set-grid(stroke: teal)

#lq.diagram(

)

and the stroke of the subticks by grid.stroke-sub:

#show: lq.set-grid(stroke-sub: 0.5pt + luma(90%))

#lq.diagram(

)

Through the parameter diagram.grid, the look of the grid can also be controlled directly for an individual diagram.

#lq.diagram(
  grid: (stroke: black, stroke-sub: 0.25pt)
)

Aside from #show: lq.set-grid(stroke: none), the grid can be turned off entirely with the short-hand grid: none.

#lq.diagram(
  grid: none
)
Parameters

ticks : array​

A list of tick positions as absolute length coordinates within the diagram frame. This is automatically filled by diagram with the ticks resulting from the axes' tick locators.

sub : bool​

Whether the ticks passed to grid.ticks are subticks.

kind : "x" | "y"    default: "x"​

The axis kind: horizontal ("x") or vertical ("y").

stroke : none | stroke    default: 0.5pt + luma(80%)​

How to stroke grid lines.

stroke-sub : auto | none | stroke    default: none​

How to stroke grid lines for subticks. If auto, the style is inherited from grid.stroke.

z-index : int | float    default: 0​

Determines the zz position of the grid in the order of rendered diagram objects. See plot.z-index.