График

property DataFrame.plot: DataFramePlot

Создать пространство имён для построения графиков.

Предупреждение

В настоящее время эта функциональность считается нестабильной. Она может быть изменена в любой момент без того, чтобы это считалось несовместимым изменением.

Изменено в версии 1.6.0: В предыдущих версиях Polars в качестве бэкенда для построения графиков использовался HvPlot. Чтобы восстановить прежнюю функциональность построения графиков, достаточно добавить import hvplot.polars в начало скрипта и заменить df.plot на df.hvplot.

Polars не реализует логику построения графиков самостоятельно, а делегирует её библиотеке Altair:

• df.plot.line(**kwargs) — это сокращение для alt.Chart(df).mark_line(tooltip=True).encode(**kwargs).interactive()
• df.plot.point(**kwargs) — это сокращение для alt.Chart(df).mark_point(tooltip=True).encode(**kwargs).interactive() (а plot.scatter предоставляется в качестве псевдонима)
• df.plot.bar(**kwargs) — это сокращение для alt.Chart(df).mark_bar(tooltip=True).encode(**kwargs).interactive()
• для любого другого атрибута attr, df.plot.attr(**kwargs) — это сокращение для alt.Chart(df).mark_attr(tooltip=True).encode(**kwargs).interactive()

Для настройки рекомендуем ознакомиться с разделом Настройка графиков. Например, можно:

• Изменить ширину, высоту и заголовок с помощью .properties(width=500, height=350, title="My amazing plot").
• Изменить угол поворота подписи оси x с помощью .configure_axisX(labelAngle=30).
• Изменить прозрачность точек на точечной диаграмме с помощью .configure_point(opacity=.5).

Примеры

Точечная диаграмма:

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

Задайте заголовок оси x с помощью altair.X:

>>> import altair as alt
>>> df.plot.point(
...     x=alt.X("length", title="Length"), y="width", color="species"
... )  

Линейный график:

>>> from datetime import date
>>> df = pl.DataFrame(
...     {
...         "date": [date(2020, 1, 2), date(2020, 1, 3), date(2020, 1, 4)] * 2,
...         "price": [1, 4, 6, 1, 5, 2],
...         "stock": ["a", "a", "a", "b", "b", "b"],
...     }
... )
>>> df.plot.line(x="date", y="price", color="stock")  

Столбчатая диаграмма:

>>> df = pl.DataFrame(
...     {
...         "day": ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"] * 2,
...         "group": ["a"] * 7 + ["b"] * 7,
...         "value": [1, 3, 2, 4, 5, 6, 1, 1, 3, 2, 4, 5, 1, 2],
...     }
... )
>>> df.plot.bar(
...     x="day", y="value", color="day", column="group"
... )  

Или, чтобы создать график с накоплением на основе примера выше:

>>> df.plot.bar(x="day", y="value", color="group")