Plot

property DataFrame.plot: hvPlotTabularPolars

Create a plot namespace.

Warning

This functionality is currently considered unstable. It may be changed at any point without it being considered a breaking change.

Polars does not implement plotting logic itself, but instead defers to hvplot. Please see the hvplot reference gallery for more information and documentation.

Examples

Scatter plot:

>>> df = pl.DataFrame(
...     {
...         "length": [1, 4, 6],
...         "width": [4, 5, 6],
...         "species": ["setosa", "setosa", "versicolor"],
...     }
... )
>>> df.plot.scatter(x="length", y="width", by="species")  

Line plot:

>>> from datetime import date
>>> df = pl.DataFrame(
...     {
...         "date": [date(2020, 1, 2), date(2020, 1, 3), date(2020, 1, 4)],
...         "stock_1": [1, 4, 6],
...         "stock_2": [1, 5, 2],
...     }
... )
>>> df.plot.line(x="date", y=["stock_1", "stock_2"])  

For more info on what you can pass, you can use hvplot.help:

>>> import hvplot  
>>> hvplot.help("scatter")