Command: plot/labels

The plot/labels command takes an input data table, transforms it according to a user-provided scale configuration and then plots the data as text labels.

Syntax

(plot/labels <options>)
(plot/labels 
data-x (...)
data-y (...)
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

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)

labels

Set the labels dataset. 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

Set the label font size.

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

label-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

Set the label padding/spacing.

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

scale-x

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

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

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

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

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

Examples:
['charts-scientific/scatterplot_with_labels']

limit-y

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

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

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

Examples:
['charts-scientific/scatterplot_with_labels']

Examples

Example: examples/charts-scientific/scatterplot_with_labels


Edit this page on GitHub