o
i0 @ s d dl mZ d dlZd dlmZ d dlmZ erFd dlZd dl m
Z
d dl m Z d dl
mZ ejdkr:d d lmZ nd d lmZ d d
lmZ G d d d ZdS )
) annotationsN)
TYPE_CHECKING)altair)Callable)
EncodeKwds) Encodings) )Unpack)Seriesc @ sF e Zd ZdZdZdddZdd d
ZdddZdddZdddZ dS )
SeriesPlotzSeries.plot namespace.Zplotsr returnNonec C s |j pd}||| _|| _d S )Nvalue)nameZto_frame_df _series_name)selfr
r r M/home/app/Keep/.python/lib/python3.10/site-packages/polars/series/plotting.py__init__ s
zSeriesPlot.__init__kwargsUnpack[EncodeKwds] alt.Chartc K sZ | j dkr d}t|tj| j ddddd}t| jjddjd i || 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)binxytooltipNr ) r
ValueErroraltXChartr Zmark_barencode interactiver r msg encodingsr r r hist" s"
zSeriesPlot.histc K s\ | j dkr d}t|| j dd}t| jj| j | j dgdjddjd i || 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
Zdensityz5cannot use `plot.kde` when Series name is `'density'`z density:Qr )Zas_Tr Nr ) r r! r" r$ r Ztransform_densityZ mark_arear% r& r' r r r kdeP s"
zSeriesPlot.kdec K sN | j dkr d}t|d| j d}t| j jddjdi || 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 Nr ) r r! r" r$ r with_row_indexZ mark_liner% r& r' r r r line| s
zSeriesPlot.lineattrstrCallable[..., alt.Chart]c s | j dkrd| d}t||dkrd}tt| j d| d d u r2d| d}t|d| j d d
d d t j
D v }|rSd fdd }|S d fdd }|S )Nr, zCannot call `plot.z ` when Series name is 'index'ZscatterpointZmark_zAltair has no method 'mark_'r r c S s h | ]}|j qS r )r ).0r r r r s z)SeriesPlot.__getattr__..r r r r c s ddj di | S )NTr r r% r& r r) methodr r func s z$SeriesPlot.__getattr__..funcc s j di | S )Nr r6 r7 r8 r r r: s )r r r r ) r r! getattrr" r$ r r- AttributeErrorinspect signature
parametersvalues)r r/ r( Zaccepts_tooltip_argumentr: r r8 r __getattr__ s$
zSeriesPlot.__getattr__N)r
r r r )r r r r )r/ r0 r r1 )
__name__
__module__ __qualname____doc__ _accessorr r* r+ r. rA r r r r r s
.
,+r )
__future__r r= typingr Zpolars._dependenciesr r" syscollections.abcr Z
altair.typingr Zpolars.dataframe.plottingr version_infor
Ztyping_extensionsZpolarsr r r r r r s