Legend Spacing and Margins¶
New parameters in theme() to customize the legend spacing and margins:
legendBoxSpacing- spacing between plotting area and legend box;legendMargin- margin around each legend;legendSpacing- spacing between legends,legendSpacingX/legendSpacingY- in the horizontal/vertical direction.
Arrangement of multiple legends:
fun legendBoxHorizontal()fun legendBoxVertical()
Justification of each legend within the overall bounding box:
fun legendBoxJustificationLeft()fun legendBoxJustificationRight()fun legendBoxJustificationTop()fun legendBoxJustificationBottom()fun legendBoxJustificationCenter()
In [1]:
%useLatestDescriptors
%use lets-plot
%use dataframe
In [2]:
LetsPlot.getInfo()
Out[2]:
Lets-Plot Kotlin API v.4.9.0. Frontend: Notebook with dynamically loaded JS. Lets-Plot JS v.4.5.1.
In [3]:
import javax.imageio.ImageIO
import java.net.URL
val url = URL("https://github.com/JetBrains/lets-plot/raw/master/docs/f-24g/images/theme_legend_scheme.png")
ImageIO.read(url)
Out[3]:
In [4]:
val mpg = DataFrame.readCSV("https://raw.githubusercontent.com/JetBrains/lets-plot-docs/master/data/mpg.csv")
mpg.head(3)
Out[4]:
DataFrame: rowsCount = 3, columnsCount = 12
| untitled | manufacturer | model | displ | year | cyl | trans | drv | cty | hwy | fl | class |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | audi | a4 | 1.800000 | 1999 | 4 | auto(l5) | f | 18 | 29 | p | compact |
| 2 | audi | a4 | 1.800000 | 1999 | 4 | manual(m5) | f | 21 | 29 | p | compact |
| 3 | audi | a4 | 2.000000 | 2008 | 4 | manual(m6) | f | 20 | 31 | p | compact |
In [5]:
val p = letsPlot(mpg.toMap()) { x = "displ"; y = "cty" } +
geomPoint(shape = 21) { fill = "drv"; size = "hwy" } +
scaleSize(range = 1 to 10, breaks = listOf(15, 30, 40)) +
theme(legendBackground = elementRect(size = 1)).legendPositionBottom()
p
Out[5]:
legendMargin¶
In [6]:
p + theme(legendMargin = listOf(10, 20))
Out[6]:
Arrangement in Legend Box¶
In [7]:
p + theme().legendBoxHorizontal()
Out[7]:
Legend Justification within Overall Bounding Box¶
In [8]:
p + theme().legendBoxJustificationCenter()
Out[8]:
legendBoxSpacing¶
In [9]:
p + theme(legendBoxSpacing = 50).legendBoxHorizontal()
Out[9]:
legendSpacing¶
In [10]:
p + theme(legendSpacing = 50).legendBoxHorizontal()
Out[10]: