plot/points

The plot/points element is used to create point/scattercharts.

Syntax

points (
data-x (...)
data-y (...)
shape (...)
shapes (...)
size (...)
sizes (...)
size-map (...)
color (...)
colors (...)
color-map (...)
labels (...)
label-font-size (...)
label-color (...)
label-padding (...)
scale-x (...)
scale-y (...)
limit-x (...)
limit-x-min (...)
limit-x-max (...)
limit-y (...)
limit-y-min (...)
limit-y-max (...))

Options

data-x <dataset>

Set the 'x' dataset for the plot. The 'x' dataset will be used to calculate the horizontal position of points.

data-x (<values>...)
data-x (csv <file> <column>)
Examples:
;; list of static values
data-x (10px 20px 30px)

;; load a csv file
data-x (csv myfile.csv mycolumn)

data-y <dataset>

Set the 'y' dataset for the plot. The 'y' dataset will be used to calculate the vertical position of points.

data-y (<values>...)
data-y (csv <file> <column>)
Examples:
;; list of static values
data-y (10px 20px 30px)

;; load a csv file
data-y (csv myfile.csv mycolumn)

shape <shape>

Set the marker/point shape.
shape (<marker-shape>)
Examples:
;; set marker shape to 'hexagon'
shape (hexagon)

shapes <>

Set an individual 'shape' for each point.

shapes (<values>...)
shapes (csv <file> <column>)
Examples:
;; list of static values
shapes (hexagon circle square)

;; load a csv file
shapes (csv myfile.csv myshapes)

size <size>

Set the point size.

size <measure>
Examples:
;; set size to 2pt
size 2pt

sizes <dataset_size>

Set an individual size for each point

size-map <measure_map>

Controls how input data in sizes is mapped to typographic units.

color <color>

Set the point color. Note that this value is only used if no colors option is specified.

color <color>
Examples:
;; set the color to grey
color #eee

;; set the color to red, 50% transparent
color (rgba 1 0 0 .5)

colors <dataset_colors>

Set an individual color for each point. If no explicit color-map option is provided, the values in colors will be interpreted as hex color codes. Otherwise the mapping of input data to colors is controlled by the color-map option.

color-map <color_map>

Controls how input data in colors mapped to colors. If no map is specified, the values in colors will be interpreted as hex color values.

labels <dataset_string>

Set the labels dataset. If provided, a label will be drawn for each point in the dataset at the corresponding (x, y) coordinate. The number of entries in the 'labels' dataset must match the number of entries in the 'x' and 'y' datasets exactly.

labels (<values>...)
labels (csv <file> <column>)
Examples:
;; list of static values
labels ("A" "B" "C")

;; load a csv file
labels (csv myfile.csv mycolumn)

label-font-size <font_size>

Set the label font size.

label-font-size <measure>
Examples:
;; set the font size to 14pt
label-font-size 14pt

label-color <color>

Set the label color.

label-color <color>
Examples:
;; set the color to grey
label-color #eee

;; set the color to red, 50% transparent
label-color (rgba 1 0 0 .5)

label-padding <padding>

Set the label padding/spacing.

label-padding <measure>
Examples:
;; set the padding to 2em
label-padding 2em

scale-x <scale>

Set the type of the 'x' (horizontal) scale.

scale-x ([linear] [log] [logarithmic] [invert] [inverted])
List of scale types: - `linear` - Standard linear scale - `log`, `logarithmic` - Logarithmic (log10) scale - `invert`, `inverted` - Flip the scale
Examples:
;; set the scale to logarithmic mode
scale-x (log)

;; set the scale to inverted mode
scale-x (invert)

scale-y <scale>

Set the type of the 'y' (vertical) scale.

scale-y ([linear] [log] [logarithmic] [invert] [inverted])
List of scale types: - `linear` - Standard linear scale - `log`, `logarithmic` - Logarithmic (log10) scale - `invert`, `inverted` - Flip the scale
Examples:
;; set the scale to logarithmic mode
scale-y (log)

;; set the scale to inverted mode
scale-y (invert)

limit-x <limit>

Set the limits (minimum and maximum values) for the 'x' (horizontal) scale.

limit-x (<min> <max)
Examples:
;; set limits to [1..10]
limit-x (1 10)

limit-x-min <limit_min>

Set the minimum value (lower limit) for the 'x' (horizontal) scale.

limit-x-min <min>
Examples:
;; set the lower limit to 2
limit-x-min 2

limit-x-max <limit-max>

Set the maximum value (upper limit) for the 'x' (horizontal) scale.

limit-x-max <value>
Examples:
;; set the upper limit to 20
limit-x-max 20

limit-y <limit>

Set the limits (minimum and maximum values) for the 'y' (vertical) scale.

limit-y (<min> <max)
Examples:
;; set limits to [1..10]
limit-y (1 10)

limit-y-min <limit_min>

Set the minimum value (lower limit) for the 'y' (vertical) scale.

limit-y-min <min>
Examples:
;; set the lower limit to 2
limit-y-min 2

limit-y-max <limit-max>

Set the maximum value (upper limit) for the 'y' (vertical) scale.

limit-y-max <value>
Examples:
;; set the upper limit to 20
limit-y-max 20

Examples

Example: examples/charts-basic/scatterplot


Edit this page on GitHub