I.e$dZddlZddlZddlZddlZddlZddlmZm Z ddl m Z ddl m Z ddlmZddlmZmZmZmZdd lmZmZmZmZmZmZmZeeje d d Z!iZ" ddZ#ddZ$ddZ%ddZ&GddZ'e'Z(e(dZ)ej*+e)eZ,dZ-dS)u hvPlot makes data analysis and visualization simple =================================================== hvPlot provides a familiar, high-level API for interactive data exploration and visualization, based on the Pandas `.plot` API and the innovative `.interactive` API. hvPlot - supports a wide range of data sources including Pandas, Dask, XArray Rapids cuDF, Streamz, Intake, Geopandas, NetworkX and Ibis. - supports the plotting backends Bokeh (default), Matplotlib and Plotly. - exposes the powerful tools from the HoloViz ecosystem in a familiar and convenient API, while letting you drop down into the underlying HoloViz tools when more power or flexibility is needed. hvPlot is the recommend entrypoint to the HoloViz ecosystem. To learn more check out https://hvplot.holoviz.org/. To report issues or contribute go to https://github.com/holoviz/hvplot. To join the community go to https://discourse.holoviz.org/. How to use hvPlot in 3 simple steps ----------------------------------- Work with the data source you already know and ❤️ >>> import pandas as pd, numpy as np >>> idx = pd.date_range('1/1/2000', periods=1000) >>> df = pd.DataFrame(np.random.randn(1000, 4), index=idx, columns=list('ABCD')).cumsum() Import the hvplot extension for your data source and optionally set the plotting backend >>> import hvplot.pandas >>> # hvplot.extension('matplotlib') Use the `.hvplot` API as you would use the Pandas `.plot` API. >>> df.hvplot() In a Jupyter Notebook, this will display a line plot of the A, B, C and D time series. For more check out the user guide https://hvplot.holoviz.org/user_guide/index.html How to get help --------------- To see the available arguments for a specific `kind` of plot run >>> import hvplot >>> hvplot.help(kind='scatter') In a notebook or ipython environment the usual - `help` and `?` will provide you with documentation. - `TAB` and `SHIFT+TAB` completion will help you navigate. To ask the community go to https://discourse.holoviz.org/. To report issues go to https://github.com/holoviz/holoviews. N)Storerender)HoloViewsConverter Interactive)explorer)hvplot_extensionoutputsaveshow)hvPlot hvPlotTabularandrews_curveslag_plotparallel_coordinatesscatter_matrixplotz $Format:%h$hvplot)fpatharchive_commitreponameFTc,t}t||}|j|g} |j|} d} |rd} |r | r| dz } | dz } |r | r| dz } | dz } t jp tj} | tj | vr%tj | | j } |r| dz } ng} dd t| z}g}tjj| | z|jz|jz}|pt'j|}t+|jddD],\}}|jdkr|||jf-d |jDfd |D}|zt'jd t&jjgz}t'j|}|d |Dz }d d|D}t?j |j!}tD||j!}|tD|<| #||t?j |||}||fS)Nzhvplot.{kind}({completions}) z {docstring}z {options}z {style}zStyle options ------------- rcFg|]}|jtjjk|S)kindinspect Parameter VAR_KEYWORD.0ps /lib/python3.11/site-packages/hvplot/__init__.py z*_get_doc_and_signature..{s7HHH v):)FFFFFFctg|]4}|dDvtj|tjj5S)cg|] }|j Sr)namer"s r%r&z5_get_doc_and_signature...s D D DA D D Dr')rr KEYWORD_ONLY)r#kfiltered_signatures r%r&z*_get_doc_and_signature..}sTFFF D D1C D D DDD%a):)GHHDDDr'kwargscg|]}|dfSNr)r#os r%r&z*_get_doc_and_signature..s333At9333r'z, c"g|] \}}|d| S)=r)r#nvs r%r&z*_get_doc_and_signature..s&???DAqZZAZZ???r')r completions docstringoptionsstyle)$rgetattr _kind_optionsget _kind_mappingr compatibilityrcurrent_backendregistry style_optsjoinsorted_hvcoreutilunique_iterator _axis_options _op_optionsr signaturelist parametersitemsrappenddefaultvaluesr r! Signaturetextwrapdedent__doc__ _METHOD_DOCSformat)clsrr6r7genericr9rJ convertermethod kind_optseltype formatterbackend valid_optsrArL extra_kwargssigr*r$ extra_params all_paramsr8 method_docr-s @r%_get_doc_and_signaturereRs#I S$  F'++D"55I  $T *FI32 #    I]" !    I[ ,E0EG (((^G,V4?  %  $I 3diiz@R@R6S6SSJJ8=00Y!889;PPL  0w(00C,,..//311a 6Q;;   tQY/ 0 0 0HHS^%:%:%<%<HHHFFFF)FFFL%|3(73D3PQQRSJ!*--I33l3333J))??J???@@Koi/00G!!$77J#L  {hoj6Q6Qz!++I i r'c\tt||||\}}t|dS)a Provide a docstring with all valid options which apply to the plot type. Parameters ---------- kind: str The kind of plot to provide help for docstring: boolean (default=True) Whether to display the docstring generic: boolean (default=True) Whether to provide list of generic options style: boolean (default=True) Whether to provide list of style options )rWrr7rXr9N)rerprint)rr7rXr9docras r%helpris: &&t097RWYYYHC #JJJJJr'bokehcj|r.ttjddst||dSdSdS)N_loadedF)logo)r:rD extensionr )rnrms r% post_patchrosL/ 5AA/......////r'cnt||}t||d|\}}||_||_dS)NFrJ)r:rerT __signature__)rWrrJrZr7s r% _patch_docrssA S$  F1#tUiXXXIyFN$Fr'ceZdZdZdZdS)_PatchHvplotDocstringsci}ttfD]L}tjD]=}t ||r+t ||}t j|}||||f<>M||_dSr0) rrrr=hasattrr:rrJorig_signatures)self signaturesrW_kindrZras r%__init__z_PatchHvplotDocstrings.__init__s M* 3 3C+9 3 33&&3$S%00F!+F33C/2JU|,  3 *r'cttfD]B}tjD]3}t ||r!|j||f}t |||4CdS)Nrq)rrrr=rwrxrs)ryrWr{rJs r%__call__z_PatchHvplotDocstrings.__call__sxM* @ @C+9 @ @3&&@ $ 4c5\ BIsEY???? @ @ @r'N)__name__ __module__ __qualname__r|r~rr'r%rurus7 * * *@@@@@r'ruc&ddlm}|dS)Nr)_patch_hvplot_docstrings)rr)r^rs r%_hook_patch_docstringsrs++*****r'cFtj|g|Ri|fd_S)a Returns a *reactive* function that can be used to start your `.interactive` pipeline by running a model or loading data depending on inputs from widgets, parameters or python objects. The widgets can be Panel or ipywidgets. Reference: https://hvplot.holoviz.org/user_guide/Interactive.html#functions-as-inputs Parameters ---------- function : callable The function to bind constant or dynamic args and kwargs to. args : object, param.Parameter, panel.widget.Widget, or ipywidget Positional arguments to bind to the function. kwargs : object, param.Parameter, panel.widget.Widget, or ipywidget Keyword arguments to bind to the function. Returns ------- Returns a new function with the args and kwargs bound to it and annotated with all dependencies. This function has an `interactive` attribute that can be called to instantiate an `Interactive` pipeline. Examples -------- Develop your **algorithm** or data extraction method with the tools you know and love. >>> import pandas as pd >>> import numpy as np >>> def algorithm(alpha): ... # An example algorithm that uses alpha ... ... return pd.DataFrame({"output": (np.array(range(0,100)) ** alpha)*50}) Make it **interactive** using `.bind`, `.interactive` and widgets. >>> import hvplot >>> import panel as pn >>> alpha = pn.widgets.FloatSlider(value=0.5, start=0, end=1.0, step=0.1, name="Alpha") >>> top = pn.widgets.RadioButtonGroup(value=10, options=[5, 10, 25], name="Top") >>> interactive_table = ( ... hvplot ... .bind(algorithm, alpha=alpha) ... .interactive() ... .head(n=top) ... ) >>> interactive_table In a notebook or data app you can now select the appropriate `alpha` and `top` values via widgets and see the `top` results of the algorithm in a table depending on the value of `alpha` selected. ctfi|Sr0r)r.bounds r%zbind.. sU)E)Ef)E)Er')_pnbind interactive)functionargsr.rs @r%rrs;n HX / / / / / /EEEEEE Lr')FTTTN)NTTT)rjFr0).rTrrRparampanelr holoviewsrDrrrYrrruir utilitiesr r r r plottingrrrrrrrstrversionVersion__file__ __version__rUrerirorsrurr_backend_switch_hooksrNrnrrr'r%rsL::v ########))))))$$$$$$;;;;;;;;;;;;CCCCCCCCCCCCCCCCCCc%-''h}19(;;<<  W[: : : : z*//// %%%%@@@@@@@@,2133 ""#9:::  99999r'