ˀh d dl mZ d dlZd dlmZmZ d dlmZ er2d dl Z d dl
m Z d dl m
Z
e j dk\ rd dlmZ nd dlmZ d d lmZ G d
d Zy) ) annotationsN)
TYPE_CHECKINGCallable)altair)
EncodeKwds) Encodings) )Unpack)Seriesc T e Zd ZdZdZd dZ d
dZ d
dZ d
dZd dZ y)
SeriesPlotzSeries.plot namespace.plotc ^ |j xs d}|j | | _ || _ y )Nvalue)nameto_frame_df _series_name)selfsr s r/var/www/html/wine-match-dev/backend/winematch-backend/venv/lib/python3.12/site-packages/polars/series/plotting.py__init__zSeriesPlot.__init__ s( vv ::d# c & | j dk( r
d}t | t j | j dd dd} t j | j
j
d j di ||j S ) a(
Draw histogram.
Polars does not implement plotting logic itself but instead defers to
`Altair `_.
`s.plot.hist(**kwargs)` is shorthand for
`alt.Chart(s.to_frame()).mark_bar(tooltip=True).encode(x=alt.X(f'{s.name}:Q', bin=True), y='count()', **kwargs).interactive()`,
and is provided for convenience - for full customisatibility, use a plotting
library directly.
.. versionchanged:: 1.6.0
In prior versions of Polars, HvPlot was the plotting backend. If you would
like to restore the previous plotting functionality, all you need to do
is add `import hvplot.polars` at the top of your script and replace
`df.plot` with `df.hvplot`.
Parameters
----------
**kwargs
Additional arguments and keyword arguments passed to Altair.
Examples
--------
>>> s = pl.Series("price", [1, 3, 3, 3, 5, 2, 6, 5, 5, 5, 7])
>>> s.plot.hist() # doctest: +SKIP
zcount()z6cannot use `plot.hist` when Series name is `'count()'`z:QT)binxytooltip ) r
ValueErroraltXChartr mark_barencode interactiver kwargsmsg encodingss r histzSeriesPlot.hist! s @ )JC S/ !$++,B/T:
CIIdhh
XdX
#
V
+
+#)
+ []
r c D | j dk( r
d}t | | j dd} t j | j j | j | j dg j
d j di ||j S ) aI
Draw kernel density estimate plot.
Polars does not implement plotting logic itself but instead defers to
`Altair `_.
`s.plot.kde(**kwargs)` is shorthand for
`alt.Chart(s.to_frame()).transform_density(s.name, as_=[s.name, 'density']).mark_area(tooltip=True).encode(x=s.name, y='density:Q', **kwargs).interactive()`,
and is provided for convenience - for full customisatibility, use a plotting
library directly.
.. versionchanged:: 1.6.0
In prior versions of Polars, HvPlot was the plotting backend. If you would
like to restore the previous plotting functionality, all you need to do
is add `import hvplot.polars` at the top of your script and replace
`df.plot` with `df.hvplot`.
Parameters
----------
**kwargs
Additional keyword arguments passed to Altair.
Examples
--------
>>> s = pl.Series("price", [1, 3, 3, 3, 5, 2, 6, 5, 5, 5, 7])
>>> s.plot.kde() # doctest: +SKIP
densityz5cannot use `plot.kde` when Series name is `'density'`z density:Qr )as_Tr r" ) r r# r$ r& r transform_density mark_arear( r) r* s r kdezSeriesPlot.kdeO s @ )IC S/ !%)%6%6[ I
CIIdhh
t 0 0t7H7H)6T
U
YtY
$
V
+
+ $*
+ []
r c | j dk( r
d}t | d| j d} t j | j j j
d j di ||j S )a
Draw line plot.
Polars does not implement plotting logic itself but instead defers to
`Altair `_.
`s.plot.line(**kwargs)` is shorthand for
`alt.Chart(s.to_frame().with_row_index()).mark_line(tooltip=True).encode(x='index', y=s.name, **kwargs).interactive()`,
and is provided for convenience - for full customisatibility, use a plotting
library directly.
.. versionchanged:: 1.6.0
In prior versions of Polars, HvPlot was the plotting backend. If you would
like to restore the previous plotting functionality, all you need to do
is add `import hvplot.polars` at the top of your script and replace
`df.plot` with `df.hvplot`.
Parameters
----------
**kwargs
Additional keyword arguments passed to Altair.
Examples
--------
>>> s = pl.Series("price", [1, 3, 3, 3, 5, 2, 6, 5, 5, 5, 7])
>>> s.plot.line() # doctest: +SKIP
indexz3cannot call `plot.line` when Series name is 'index'r Tr r" ) r r# r$ r& r with_row_index mark_liner( r) r* s r linezSeriesPlot.line{ s @ 'GC S/ !%,43D3D E
CIIdhh--/ 0
YtY
$
V
+
+#)
+ []
r c | j dk( rd| d}t | |dk( rd}t t j | j
j
d| d d| d}t | d| j d d
t j j j D ch c] }|j c}v }|r d
fd }|S d
fd }|S c c}w )Nr6 zCannot call `plot.z ` when Series name is 'index'scatterpointmark_zAltair has no method 'mark_'r r! c V d j di | j S )NTr r" r( r) r+ r- methods r funcz$SeriesPlot.__getattr__..func s, 2vd+22IYI&IUUWWr c R j di | j S )Nr" r@ rA s r rC z$SeriesPlot.__getattr__..func s' &vx==f=IIKKr )r+ r return alt.Chart)
r r# getattrr$ r& r r7 AttributeErrorinspect signature
parametersvaluesr )r attrr, r accepts_tooltip_argumentrC r- rB s @@r __getattr__zSeriesPlot.__getattr__ s '&tf,IJC S/ ! 9 D488#:#:#<=tf~tT >/vQ7C % %%,43D3D E #,$+$5$5f$=$H$H$O$O$Q1
EJJ1
$
$
X
L 1
s 7C"N)r r rE None)r+ zUnpack[EncodeKwds]rE rF )rM strrE zCallable[..., alt.Chart])
__name__
__module__ __qualname____doc__ _accessorr r. r4 r9 rO r" r r r r sb I!
,
%,
,
\*
%*
*
X)
%)
)
Vr r )
__future__r rI typingr r polars.dependenciesr r$ sys
altair.typingr polars.dataframe.plottingr version_infor typing_extensionspolarsr r r" r r r` s@ " * -(3
7"!, h hr