View on

Element: plot/points

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

Syntax

(plot/points <options>)

Example

Options

Point Options

data-x data-y data-color data-size data-shape size-map color color-map marker-size marker-shape

Label Options

labels label-font-size label-color label-padding

Scale Options

limit-x limit-x-min limit-x-max limit-y limit-y-min limit-y-max scale-x scale-y scale-x-padding scale-y-padding

Point Options

data-x

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

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

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

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)

data-color

Set the 'color' dataset for the plot. The 'color' dataset will be used to calculate the color of points. The mapping of input values to colors is controlled by the color-map option. If no explicit color-map option is provided, the values data-color will be interpreted as hex color codes.

data-color (<values>...)
data-color (csv <file> <column>)
Examples:
;; list of static values
data-color (#06c #c06 #06c)

;; load a csv file
data-color (csv myfile.csv mycolors)

data-size

Set the 'size' dataset for the plot. The 'size' dataset will be used to calculate the size of points. The mapping of input values to typographic units is controlled by the size-map option.

data-size (<values>...)
data-size (csv <file> <column>)
Examples:
;; list of static values
data-size (2pt 8pt 5pt)

;; load a csv file
data-size (csv myfile.csv mysizes)

data-shape

Set the 'shape' dataset for the plot. The 'shape' dataset will be used to choose the marker shape of points.

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

;; load a csv file
data-size (csv myfile.csv myshapes)

size-map

Set the point size map. If no map is specified, the values in data-size will be interpreted as unit values.

size-map <measure-map>

color

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

color <color>

color-map

Set the point color map. If no map is specified, the values in data-color will be interpreted as hex color values.

color-map <color-map>

marker-size

Set the marker size for the plot. Note that this value is only used i no data-size option is specified.

marker-size <measure>
Examples:
;; set the marker size to 5pt
marker-size 5pt

marker-shape

Set the marker shape for the plot. Note that this value is only used i no data-shape option is specified.

marker-shape (<marker-shape>)
Examples:
;; set the marker shape to 'hexagon'
marker-shape (hexagon)

Label Options

labels

Set the labels for the plot. If set, a label will be drawn for each point in the dataset at the points (x, y) coordinate,

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

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

label-font-size

Set the label font size. See the measure page for more details on valid values.

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

label-color

Set the label color. See the color page for more details on valid values.

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

label-padding

Set the label padding/spacing. See the measure page for more details on valid values.

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

Scale Options

limit-x

Set the 'x' axis value range to the closed interval [min, max]. If no explicit limits are specified, the limit is set to the smallest interval that contains all input data points.

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

limit-x-min

Set the 'x' axis minimum value. If no explicit minimum is specified, the minimum is set to the smallest value in the input data set.

limit-x-min <min>
Examples:
;; set x axis min value to 2
limit-x-min 2

limit-x-max

Set the 'x' axis maximum value. If no explicit maximm is specified, the maximum is set to the largest value in the input data set.

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

limit-y

Set the 'y' axis value range to the closed interval [min, max]. If no explicit limits are specified, the limit is set to the smallest interval that contains all input data points.

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

limit-y-min

Set the 'y' axis minimum value. If no explicit minimum is specified, the minimum is set to the smallest value in the input data set.

limit-y-min <min>
Examples:
;; set y axis min value to 2
limit-y-min 2

limit-y-max

Set the 'y' axis maximum value. If no explicit maximm is specified, the maximum is set to the largest value in the input data set.

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

scale-x

Set the 'x' scale type.

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 x axis to logarithmic mode
scale-x (log)

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

scale-y

Set the 'y' scale type.

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 x axis to logarithmic mode
scale-y (log)

;; set x axis to inverted mode
scale-y (invert)

scale-x-padding

Set the 'x' scale 'padding'. The scale padding is used to extend the automatically assigned scale limits. The padding option is hence only useful when no explicit limits are specified (using limit-x). The padding is specified in the display unit system of the axis.

scale-x-padding <value>
Examples:
;; set x axis padding to 10
scale-x-padding 10

scale-y-padding

Set the 'y' scale 'padding'. The scale padding is used to extend the automatically assigned scale limits. The padding option is hence only useful when no explicit limits are specified (using limit-y). The padding is specified in the display unit system of the axis.

scale-y-padding <value>
Examples:
;; set y axis padding to 10
scale-y-padding 10
Edit this page on GitHub