Expanding Plot Limits with expandLimits()¶

When creating visualizations, you might occasionally need to adjust your plot boundaries to encompass specific data points or values. This is where the expandLimits() function comes in handy. It allows you to extend the plot's scales to include particular values, ensuring they're visible in your visualization.

In [1]:

%useLatestDescriptors
%use dataframe
%use lets-plot

In [2]:

LetsPlot.getInfo()

Out[2]:

Lets-Plot Kotlin API v.4.9.3. Frontend: Notebook with dynamically loaded JS. Lets-Plot JS v.4.5.2.

In [3]:

val mpg = DataFrame.readCSV("https://raw.githubusercontent.com/JetBrains/lets-plot-docs/master/data/mpg2.csv")
mpg.head(3)

Out[3]:

DataFrame: rowsCount = 3, columnsCount = 9

miles per gallon	number of cylinders	engine displacement (cu. inches)	engine horsepower	vehicle weight (lbs.)	time to accelerate (sec.)	model year	origin of car	vehicle name
18.000000	8	307.000000	130	3504	12.000000	70	US	chevrolet chevelle malibu
15.000000	8	350.000000	165	3693	11.500000	70	US	buick skylark 320
18.000000	8	318.000000	150	3436	11.000000	70	US	plymouth satellite

In [4]:

val p = letsPlot(mpg.toMap()) { x = "miles per gallon"; y = "vehicle weight (lbs.)"} + geomPoint()   
p

Out[4]:

Expand Lower Limit Along the x-axis¶

In [5]:

p + expandLimits(x = 0)

Out[5]:

Expand Limits Along the y-axis¶

In [6]:

p + expandLimits(y = listOf(1000, 9000))

Out[6]:

Expand Lower Limits Along Both Axes¶

In [7]:

p + expandLimits(x = 0, y = 0)

Out[7]:

Expanding Color-scale Limits¶

In [8]:

// Same plot with color mapping
val p1 = letsPlot(mpg.toMap()) { 
    x = "miles per gallon"
    y = "vehicle weight (lbs.)"
    color = "number of cylinders"
} + geomPoint()   


gggrid(listOf(
    p1, 
    // Expand the color-scale limits.
    p1 + expandLimits(color = 2..10)
))

Out[8]: