Skip to main content

A high-level plotting API for the PyData ecosystem built on HoloViews.

Project description

hvPlot makes data analysis and visualization simple

Build Status Build Status
Coverage codecov
Latest dev release Github tag dev-site
Latest release Github release PyPI version hvplot version conda-forge version defaults version
Python Python support
Docs gh-pages site
Binder Binder
Support Discourse

Home | Installation instructions | Getting Started Guide | Reference Guides | Examples | License | Support

hvPlot provides a familiar, high-level API for visualization

The API is based on the familiar 🐼 Pandas .plot API and the innovative .interactive API.

hvPlot works with the tools you know and ❤️

hvPlot

hvPlot is the recommended entrypoint to the HoloViz ecosystem.

hvPlot can be used for exploration, reporting and data apps

Check out this blog post to see how easy it is to create an interactive dashboard with hvPlot and Panel.

Installation Instructions

hvPlot supports Python 3.6, 3.7, 3.8, 3.9 and 3.10 on Linux, Windows, or Mac and can be installed with conda:

conda install -c pyviz hvplot

or with pip:

pip install hvplot

You can download the guides and example notebooks as a .zip file by clicking this link.

Please note that for versions of jupyterlab<3.0, you must install the JupyterLab extension manually with:

jupyter labextension install @pyviz/jupyterlab_pyviz

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
# Optional: hvplot.extension('matplotlib') or hvplot.extension('plotly')

Use the .hvplot API as you would use the Pandas .plot API.

df.hvplot()

To get started check out the user guide or the live user guide on Binder.

How to make your data pipeline .interactive

Just add .interactive and replace your normal arguments with Ipywidgets or Panel widgets.

import panel as pn
pn.extension()

df.interactive(width=600).head(n=pn.widgets.IntSlider(start=1, end=5, value=3))

To get started check out the .interactive guide or the live .interactive guide on Binder.

How to find documentation from your notebook or editor

To see the available arguments for a specific kind of plot run

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.

Examples

Download | Run on Binder | View Gallery

License

hvPlot is completely free and open-source. It is licensed under the BSD 3-Clause License.

Support & Feedback

Type Channel
🐛  Bug Reports
🎁  Feature Requests
👩  Usage Questions
👩‍💻  Developer Questions
📢  Announcements

Contributions

We would ❤️ to work with you no matter whether you want to contribute to issue management, PRs, documentation, blog posts, community support or social media communication.

To get started with the code or docs check out the Developer Guide.

Reach out on Gitter to discuss with the developers, join the weekly triaging or join the bi-weekly HoloViz call.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hvplot-0.8.2a1.tar.gz (6.2 MB view details)

Uploaded Source

Built Distribution

hvplot-0.8.2a1-py2.py3-none-any.whl (3.2 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file hvplot-0.8.2a1.tar.gz.

File metadata

  • Download URL: hvplot-0.8.2a1.tar.gz
  • Upload date:
  • Size: 6.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.11.3 pkginfo/1.8.3 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.7.15

File hashes

Hashes for hvplot-0.8.2a1.tar.gz
Algorithm Hash digest
SHA256 f3fce87767641e76d2f9425ba754804ab9d2fca8aeb53c5a2afbc62ef44963ea
MD5 e34475802e5aacd4e4ec14302e58d5ad
BLAKE2b-256 df7344741eb8866db361d59d7966a71ea3c1d2782d5ce663c858f3455bc59ec1

See more details on using hashes here.

Provenance

File details

Details for the file hvplot-0.8.2a1-py2.py3-none-any.whl.

File metadata

  • Download URL: hvplot-0.8.2a1-py2.py3-none-any.whl
  • Upload date:
  • Size: 3.2 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.11.3 pkginfo/1.8.3 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.7.15

File hashes

Hashes for hvplot-0.8.2a1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 dbdf096cc9c4949fe94d47963b0dec93073efb2e33e72a08e228131b15dec795
MD5 e3721bae586d3d40b5e3646d66d36eb8
BLAKE2b-256 55661f59d3b5bd843f952c2777c335cfdd42ffec0a8d4c45799971383f2996e5

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page