This website is for Vega-Lite v2. Go to the main Vega-Lite homepage for the latest release.

Circle

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

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

Circle Mark Properties

// Single View Specification
{
  ...
  "mark": {
    "type": "circle",
    ...
  },
  "encoding": ... ,
  ...
}

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

Property Type Description
size Number

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

Examples

Scatterplot with Circle

Here is an example scatter plot with circle marks:

Circle Config

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

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

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