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 love

hvPlot

hvPlot is the simplest way to benefit from the HoloViz ecosystem for data exploration.

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.

Mini getting-started

Head over to the getting started guide for more!

Install

hvPlot can be installed on Linux, Windows, or Mac with conda:

conda install -c pyviz hvplot

or with pip:

pip install hvplot

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

jupyter labextension install @pyviz/jupyterlab_pyviz

Plotting data

Work with your data source:

import numpy as np
import pandas as pd

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 or Xarray .plot API:

df.hvplot()

Interactive data apps

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

import panel as pn
pn.extension()

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

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

License

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

Support & Feedback

Get support from or provide feedback to the HoloViz Community.

Contributions

We would love 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.3rc1.tar.gz (6.2 MB view details)

Uploaded Source

Built Distribution

hvplot-0.8.3rc1-py2.py3-none-any.whl (3.2 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file hvplot-0.8.3rc1.tar.gz.

File metadata

  • Download URL: hvplot-0.8.3rc1.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.16

File hashes

Hashes for hvplot-0.8.3rc1.tar.gz
Algorithm Hash digest
SHA256 07e77953bd4999ba76d624ff0552d7b43c0f9087e4c119b94c3c3dd17d304a60
MD5 c4d6d46b98138678e90277a611b890f1
BLAKE2b-256 f3a2ebbe603ff41c68522895fda5169a9e3d5cfdf465a413ee949885c8d75571

See more details on using hashes here.

Provenance

File details

Details for the file hvplot-0.8.3rc1-py2.py3-none-any.whl.

File metadata

  • Download URL: hvplot-0.8.3rc1-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.16

File hashes

Hashes for hvplot-0.8.3rc1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 bae312ca87afccee39435b2b2860a5f2fcd64e0d00670aca056200187265579b
MD5 8094824d6c81889dde809c4ac0f235d3
BLAKE2b-256 939e2f7eeb20a0145e05c61ba2964b333f7b5169c790c945fb11d0bbc22aaf1d

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