Square

Edit this page
// Single View Specification
{
  "data": ... ,
  "mark": "square",
  "encoding": ... ,
  ...
}

square marks is similar to point mark, except that (1) the shape value is always set to square (2) they are filled by default.

Square Mark Properties

A square mark definition can contain any standard mark properties and the following special properties:

Property Type Description
size Number | ExprRef

Default size for marks.

  • For point/circle/square, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.
  • For bar, this represents the band size of the bar, in pixels.
  • For text, this represents the font size, in pixels.

Default value:

  • 30 for point, circle, square marks; width/height’s step
  • 2 for bar marks with discrete dimensions;
  • 5 for bar marks with continuous dimensions;
  • 11 for text marks.

Example: Scatterplot with Square

Here are an example scatter plot with square marks:

Square Config

// Top-level View Specification
{
  ...
  "config": {
    "square": ...,
    ...
  }
}

The square property of the top-level config object sets the default properties for all square marks. If mark property encoding channels are specified for marks, these config values will be overridden.

The square config can contain any point mark properties (except type, style, and clip).